Shortcode reference Use the portable shortcodes included in the current stable Core runtime. current core current site-builderscore-developersai-agents
v0.2.6 core current Public

Shortcode reference

Use the portable shortcodes included in the current stable Core runtime.

Owner
Foundry Core
Source
core/docs/SHORTCODES.md
Ref
v0.1.24
Policy
release-bound
Component pins for v0.2.6
ComponentRoleVersion
coreruntimev0.1.24
theme-shieldthemev0.1.15
starterreferencev0.1.3
docsreferencev0.1.4
distributiontoolingv0.3.4
restricted-component-1consumer-referencev0.1.22
restricted-component-2consumer-referencev1.1.21

Foundry ships a small shortcode surface for Markdown-first content. These shortcodes are compatibility and authoring helpers over existing shared contracts; they are not a separate component system.

Shipped Shortcodes

ShortcodeFilePurpose
pullquotelayouts/shortcodes/pullquote.htmlRenders editorial pull quotes using the shared pullquote visual contract.
bricklayouts/shortcodes/brick.htmlCompatibility helper for downstream content that still references legacy bricks content.

pullquote

Use pullquote inside Markdown articles when the quote belongs in the article body rather than in a page-level sections array.
























  
  






  
Treat the shared shell as the baseline and keep branded persuasion site-owned.
Editorial Team Review note

Supported parameters:

ParameterValuesNotes
authortextOptional attribution name.
roletextOptional attribution context.
variantaccent-bar, filled, oversized, minimalMatches the shared pullquote block variants.
aligncenter, leftOptional text alignment.
idtextOptional wrapper id.
classtextOptional extra wrapper class.

brick

The brick shortcode exists for compatibility with older content that still uses page-level bricks data. Prefer the current sections contract for new content.

Do not remove this shortcode until the compatibility policy in data/foundry/runtime-contract-registry.json and the canonical Bricks migration docs say the migration window is closed.

Authoring Rules

  • Prefer plain Markdown first.
  • Use Hugo embedded shortcodes when Hugo already provides the needed primitive.
  • Use Foundry shortcodes only when they preserve a shared Foundry visual or compatibility contract.
  • Do not add a shortcode-only component when the behavior should be a reusable block or Markdown render hook.
  • docs/ARTICLE-PRESENTATION.md
  • layouts/_default/_markup/render-image.html
  • layouts/partials/blocks/pullquote.html
  • data/foundry/runtime-contract-registry.json

Static Pagefind search

Search Foundry documentation

Type at least two characters
Search the full documentation system

Results stay inside this build profile and can be filtered by version, component, audience, and lifecycle.