Field options

Shared enum and select values used across design blocks, presentation, appearance, action, visibility, and more.

Field-level catalog tables below stay in English — they match the machine design schema used by the editor, API, and MCP.

presentation

Presentation. How repeating media or list items are laid out on the page.

Used by fields: presentation, listLayout, displayMode

• gallery — Static multi-item grid (or gallery) layout.
• slider — Carousel / slider that advances through items.
• grid — Object list layout: items arranged in a CSS grid.

appearance

Appearance. Visual style for button-like controls.

Used by fields: appearance

• filled — Solid fill with contrasting text.
• text — Text-only / ghost style without a filled background.

action

Button action. What happens when a visitor activates a button or button link.

Used by fields: action

• navigate — Follow the configured URL / route.
• copyEntryLink — Copy the current object entry link to the clipboard.
• shareSocial — Open a share flow for the selected social network.
• websiteUserSignOut — Sign the website user out of the site session.
• notifications — Open or focus the notifications UI for signed-in users.
• flowNext — Advance to the next step in a Flow block.

social-network

Social network. Brand / share target when the button action is shareSocial.

Used by fields: socialNetwork

• whatsapp
• x
• facebook
• linkedin

heading-level

Heading level. Semantic HTML heading level used for hierarchy, accessibility, and SEO.

Used by fields: level

• h1 — Primary page heading. Prefer one H1 per page topic.
• h2
• h3
• h4
• h5
• h6

text-align

Alignment. Horizontal alignment for text or slider navigation controls.

Used by fields: textAlign, navAlign, listSliderNavAlign, overlayTextAlign

• left
• center
• right

underline-mode

Underline mode. How heading underline decoration is drawn relative to the text.

Used by fields: underlineMode

• inline — Decoration follows the text inline.
• separate — Decoration is drawn as a separate line under the text.

image-mode

Image fit. How an image fills its frame.

Used by fields: imageMode, backgroundImageMode

• cover — Fill the frame; crop overflow if needed.
• contain — Fit the whole image inside the frame; may letterbox.
• repeat — Tile the image (background images).

orientation

Orientation. Axis for lines and similar decorative controls.

Used by fields: orientation

• horizontal
• vertical

controls-placement

Slider controls placement. Where SlotSlider title, counter, and chevrons sit relative to sliding media.

Used by fields: controlsPlacement

• below — Default: chevrons and dots under the viewport.
• sidePanel — Fixed side panel holds the active slide’s panel slot plus counter and chevrons; only media slides.

transition

Slider transition. Motion used when a slider advances between slides.

Used by fields: transition, listSliderTransition

• slide — Default horizontal slide.
• fade — Cross-fade between slides.
• slideUp
• zoom
• cover
• flip
• flipUp
• cube
• cubeUp
• carousel
• fold

auth-visibility

Auth visibility. Who can see a block based on website sign-in state.

Used by fields: authVisibility

• all — Everyone.
• authenticated — Signed-in website users only.
• anonymous — Signed-out visitors only.

route-lock-visibility

Route lock visibility. On locked object routes, when the block should appear.

Used by fields: routeLockVisibility

• all — Always.
• when_unlocked — Only when the route is unlocked.
• when_locked — Only when the route is locked.

entry-action-visibility

Entry action visibility. Object-component only: show when the current entry exposes matching actions.

Used by fields: entryActionVisibility

• all — Always.
• canUpdate — When the visitor can update the entry.
• canDelete — When the visitor can delete the entry.

query-page-visibility

Query page visibility. Optional limit for list blocks across query pages.

Used by fields: queryPageVisibility

• all — All query pages.
• first_page_only — Only the first query page.

padding-token

Padding token. Theme spacing tokens for block padding. Tokens keep spacing consistent with the site theme.

Used by fields: padding

• none
• xs
• sm
• md
• lg
• xl

border-width

Border width. Theme border-width tokens.

Used by fields: borderWidth, thickness

• none
• sm
• md
• lg

border-radius

Border radius. Theme border-radius tokens.

Used by fields: borderRadius

• none
• sm
• md
• lg
• xl
• full

border-style

Border style. CSS border style for decorated blocks.

Used by fields: borderStyle

• solid
• dashed
• dotted

background-kind

Background kind. Fill mode for block backgrounds.

Used by fields: backgroundKind

• solid
• gradient
• image
• video
• animation

background-grid-style

Background grid style. Reactive grid cell rendering: filled cells or interconnected continuous outlines. Custom SVG shapes always render as cells.

Used by fields: backgroundGridStyle

• cells
• continuous

decoration-overflow

Overflow. Frame overflow for BlockShell decorations.

Used by fields: overflow

• visible
• hidden
• auto
• clip

decoration-pointer-events

Pointer events. Whether the decoration frame receives pointer events.

Used by fields: pointerEvents

• auto
• none

decoration-static-unit

Static size unit. CSS length unit for static width/height.

Used by fields: widthStaticUnit, heightStaticUnit

• px
• vw
• vh
• vmin
• vmax

background-width

Background width. How far the background spans horizontally.

Used by fields: backgroundWidth

• page — Stay within the block width.
• full — Stretch to the viewport width.

scroll-animation

Scroll animation. Enter-on-scroll animation presets for BlockShell decoration.

Used by fields: scrollAnimationType

• fadeIn
• slideInBottom
• slideInTop
• slideInLeft
• slideInRight
• zoomIn
• zoomOut
• rotateIn
• rotateOut
• bounceIn
• bounceOut
• pulse

grid-size

Grid size. Column count for gallery-style layouts.

Used by fields: gridSize

• 2
• 3
• 4