> ## Documentation Index > Fetch the complete documentation index at: https://docs.fetchski-attract.com/llms.txt > Use this file to discover all available pages before exploring further. # Replace a page > Replaces the whole document: every field left out is reset to its default. ```ts TypeScript wrap theme={"dark"} import { createSiteClient } from '@fetchski/attract-cms-sdk'; const site = createSiteClient(); const page = await site.pages().replacePage({ id: 'ckitdo5oq004pu69kr6oxo6fr:en:published', type: 'default-page', title: 'About Us' }); ``` ```json 200 wrap theme={"dark"} { "_id": "ckhdscx5900054z9k88uqs16w:en:published", "aposDocId": "ckhdscx5900054z9k88uqs16w", "aposLocale": "en", "aposMode": "published", "archived": false, "createdAt": "2023-01-15T10:30:00.000Z", "updatedAt": "2024-12-18T14:20:00.000Z", "titleSortified": "about us", "slug": "/about-us", "path": "/about-us", "rank": 0, "level": 1, "orphan": false, "parked": [], "visibility": "public", "type": "@apostrophecms/page", "title": "About Us", "main": {}, "_ancestors": [], "_children": [], "_url": "https://example.com/about-us", "_edit": true, "_publish": true, "copyOfId": "ckhdscx5900054z9k88uqs16w:en:published", "_publishedDoc": { "_id": "ckhdscx5900054z9k88uqs16w:en:published", "aposDocId": "ckhdscx5900054z9k88uqs16w", "aposLocale": "en", "updatedAt": "2024-12-18T14:20:00.000Z", "slug": "/about-us", "path": "/about-us", "level": 1, "visibility": "public", "type": "@apostrophecms/page", "title": "About Us" }, "_draftDoc": { "_id": "ckhdscx5900054z9k88uqs16w:en:published", "aposDocId": "ckhdscx5900054z9k88uqs16w", "aposLocale": "en", "updatedAt": "2024-12-18T14:20:00.000Z", "slug": "/about-us", "path": "/about-us", "level": 1, "visibility": "public", "type": "@apostrophecms/page", "title": "About Us" }, "aposShareKey": "k3v9x2m7q1z8w4p6", "scheduledPublish": "Example scheduled publish", "scheduledUnpublish": "Example scheduled unpublish", "seoTitle": "Example seo title", "seoDescription": "Example seo description", "seoImage": {}, "pageFontOverrides": [], "footerMarqueeMode": "inherit", "sections": {}, "comingSoonIcon": "sparkles", "comingSoonIconFamily": "classic-regular", "comingSoonIconColor": "Example coming soon icon color", "comingSoonIconAnimation": "none", "comingSoonIconSize": "5x", "comingSoonNote": "Example coming soon note", "backLinkColor": "Example back link color", "backLinkColorLight": "Example back link color light", "backLinkWeight": "semibold", "backLinkSize": "normal", "aboveSections": {}, "postList": {}, "belowSections": {}, "backButtonLabel": "Back to all posts", "backButtonVariant": "outline", "backButtonSize": "normal", "backButtonRadius": "slight", "backButtonColor": "--fetchski-accent", "backButtonColorLight": "Example back button color light", "backButtonTextColor": "--fetchski-ink", "backButtonTextColorLight": "Example back button text color light", "backButtonHoverColor": "Example back button hover color", "backButtonHoverColorLight": "Example back button hover color light", "backButtonStyle": "sweep", "backButtonShadowColor": "Example back button shadow color", "backButtonShadowColorLight": "Example back button shadow color light", "backButtonAnimation": "lift-scale", "backButtonIcon": "arrow-left", "backButtonIconFamily": "classic-regular", "backButtonIconPosition": "before", "backButtonIconNudge": false, "postFontOverrides": [], "postTextSize": "normal", "postTextWeight": "normal", "postContentWidth": "normal", "postLineHeight": "normal", "postAccentColor": "Example post accent color", "postAccentColorLight": "Example post accent color light", "postHeadingWeight": "bold", "postHeadingColor": "Example post heading color", "postHeadingColorLight": "Example post heading color light", "blogPostCss": {} } ``` ## In your app A function makes the call on the client it is given, so your code passes the real one and a test passes a fake. **1. Add the function** ```ts src/attract/replace-page.ts theme={"dark"} import type { SiteClient } from '@fetchski/attract-cms-sdk'; export async function replacePage(site: SiteClient, id: string) { return site.pages().replacePage({ id, type: 'default-page', title: 'About Us' }); } ``` The other values are the example’s: take yours from the request, a form or your database. **2. Call it** A script makes the client once and calls the function: ```ts scripts/replace-page.ts theme={"dark"} import { createSiteClient } from '@fetchski/attract-cms-sdk'; import { replacePage } from '../src/attract/replace-page.ts'; const site = createSiteClient(); console.log(await replacePage(site, 'ckitdo5oq004pu69kr6oxo6fr:en:published')); ``` ```bash Terminal theme={"dark"} node --env-file=.env scripts/replace-page.ts ``` A route handler, a job or a queue worker calls it the same way. PATCH changes only the fields sent. Completely replace a page document. **Use cases:** * Complete page updates * Moving pages in the tree structure * Replacing page content entirely Requires `_targetId` and `_position` for page tree positioning. ## Find the id `id` is the document’s `_id`, from a list. Ask the list for only the fields you need: each row is a document’s `id` and those fields. ```ts TypeScript wrap theme={"dark"} import { createSiteClient } from '@fetchski/attract-cms-sdk'; const site = createSiteClient(); const row = (await site.pages().listPagesPick(['title', 'slug'])).find((each) => each.slug === '/about-us'); // { id, title, slug }, or undefined ``` Pass `row.id` as `id`. Drafts: list with `{ aposMode: 'draft' }` to get the draft’s id ([Find an id](https://docs.fetchski-attract.com/find-an-id.md)). > [accordion] Required parameters > > One object, e.g. `replacePage({ id })`; leave out the optional fields. > > **id** `string` *required* > > **Required.** Computed document ID (can optionally include mode and locale, e.g., id:en:published) Matches `^\S+$`. > > **type** `string` *required* > > **Required.** The page type: one of the site’s page types (the `type` its pages carry). Anything else is refused with the list. > > **title** `string` *required* > > **Required.** Page title. At most 100 characters. > [accordion] Optional parameters > > **aposMode** `AposMode | null | undefined` > > **Optional.** Leave it out and the site uses `"published"`. `published` (the default) or `draft`. Drafts need a credential that may see them: an API key with the type’s write scope (`content::write`), or a signed-in editor. The public and a key with only the read scope get 403. One of `draft`, `published`. > > **aposLocale** `string | null | undefined` > > **Optional.** Leave it out (or pass `null`) and it isn’t sent: the site’s default applies. The locale to read or write, e.g. `en` (default: the site’s default locale). > > **renderAreas** `boolean | null | undefined` > > **Optional.** Leave it out and the site uses `false`. true: each area’s widgets come back rendered as HTML (`_rendered`), beside their data. > > **targetId** `string | null | undefined` > > **Optional.** Leave it out (or pass `null`) and it isn’t sent: the site’s default applies. The page to place it beside or under, by `_id` (`_home` and `_archive` work too). Default `_home`. > > **position** `Position | null | undefined` > > **Optional.** Leave it out (or pass `null`) and it isn’t sent: the site’s default applies. Where, relative to `_targetId`. Default `lastChild`. One of `before`, `after`, `firstChild`, `lastChild`. > > **slug** `string | null | undefined` > > **Optional.** Leave it out (or pass `null`) and it isn’t sent: the site’s default applies. URL slug for the page. > > **orphan** `boolean | null | undefined` > > **Optional.** Leave it out and the site uses `false`. Whether page is orphaned (not in tree structure) > > **visibility** `FlatPageResponseResultsItemVisibility | null | undefined` > > **Optional.** Leave it out and the site uses `"public"`. Page visibility setting. One of `public`, `loginRequired`, `private`. > > **main** `MainArea | null | undefined` > > **Optional.** Leave it out (or pass `null`) and it isn’t sent: the site’s default applies. Widgets, top to bottom: send `{ "items": [ … ] }`, one object per widget with its `type`. Writing it replaces the whole area. > > **MainArea** > > **metaType** `AfterContentAreaMetaType` > > Always `area`. One of `area`. > > **id** `string` > > The area’s id, set by the site: leave it out when you write one. > > **items** `readonly MainAreaItem[]` > > A list of `MainAreaItem`. The widgets, top to bottom. Each is an object with its `type` and that widget’s own fields; `_id` and `metaType` may be left out (the site sets them). > > **MainAreaItem** > > A widget in an area that takes `@apostrophecms/rich-text`, `@apostrophecms/image`, `@apostrophecms/video`: the one its `type` names. > > **RichTextWidget** > > A `@apostrophecms/rich-text` widget: its `type` and its own fields. A field left out takes its default. > > **type** `RichTextWidgetType` *required* > > **Required.** The widget’s type: always `@apostrophecms/rich-text`. One of `@apostrophecms/rich-text`. > > **id** `string` > > The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. > > **metaType** `MetaType` > > Always `widget`. One of `widget`. > > **content** `string` > > The text as HTML, e.g. `

Our story

It began with one idea.

`. The site keeps the tags and styles this area’s editor offers (paragraphs, headings, bold, italic, links, lists…) and removes the rest. > > **sectionCss** `CustomCSS | null` > > A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. > > **CustomCSS** > > **slots** `Readonly\\>` > > The CSS typed into each part slot, by slot name. > > **css** `string` > > The compiled CSS (read only: rebuilt from `slots`). > > **mark** `string` > > The site’s check mark for `css` (read only). > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **ImageWidget** > > A `@apostrophecms/image` widget: its `type` and its own fields. A field left out takes its default. > > **type** `ImageWidgetType` *required* > > **Required.** The widget’s type: always `@apostrophecms/image`. One of `@apostrophecms/image`. > > **id** `string` > > The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. > > **metaType** `MetaType` > > Always `widget`. One of `widget`. > > **image** `readonly Readonly\\>[]` > > The related `@apostrophecms/image` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document (one at most); a document the site can’t find is left out. At most 1 items. > > **caption** `string` > > Caption. > > **linkTo** `LinkTo | null` > > Link To... One of `none`, `@apostrophecms/any-page-type`, `_url`. > > **apostrophecmsAnyPageType** `readonly Readonly\\>[]` > > The related `@apostrophecms/any-page-type` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document (one at most); a document the site can’t find is left out. At most 1 items. > > **linkHref** `string | null` > > apostrophe:linkHrefHelp When set, a URL; empty or null when not. > > **linkHrefTitle** `string` > > Link Title. > > **linkTitle** `string` > > If empty, the title of the related document will be used. > > **linkTarget** `readonly LinkTarget[] | null` > > Link Target. Each one of `_blank`. > > **sectionCss** `CustomCSS | null` > > A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **VideoWidget** > > A `@apostrophecms/video` widget: its `type` and its own fields. A field left out takes its default. > > **type** `VideoWidgetType` *required* > > **Required.** The widget’s type: always `@apostrophecms/video`. One of `@apostrophecms/video`. > > **video** `Readonly\\>` *required* > > **Required.** Enter the URL for a media source you wish to embed (e.g., YouTube, Vimeo, or other hosted video URL). > > **id** `string` > > The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. > > **metaType** `MetaType` > > Always `widget`. One of `widget`. > > **sectionCss** `CustomCSS | null` > > A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **scheduledPublish** `string | null | undefined` > > **Optional.** Leave it out (or pass `null`) and it isn’t sent: the site’s default applies. An ISO 8601 date and time, e.g. `2026-10-21T14:30:00.000Z`. > > **scheduledUnpublish** `string | null | undefined` > > **Optional.** Leave it out (or pass `null`) and it isn’t sent: the site’s default applies. An ISO 8601 date and time, e.g. `2026-10-21T14:30:00.000Z`. > > **seoTitle** `string | null | undefined` > > **Optional.** Leave it out and the site uses `""`. Overrides the document title in the browser tab and search results. Leave blank to use the regular title. > > **seoDescription** `string | null | undefined` > > **Optional.** Leave it out and the site uses `""`. Shown in search results and link previews. Aim for 150–160 characters. > > **seoImage** `ImageArea | null | undefined` > > **Optional.** Leave it out (or pass `null`) and it isn’t sent: the site’s default applies. Used for Open Graph / social link previews. Recommended 1200×630. Widgets, top to bottom: send `{ "items": [ … ] }`, one object per widget with its `type`. Writing it replaces the whole area. > > **ImageArea** > > Widgets, top to bottom: send `{ "items": [ … ] }`, one object per widget with its `type`. Writing it replaces the whole area. > > **metaType** `AfterContentAreaMetaType` > > Always `area`. One of `area`. > > **id** `string` > > The area’s id, set by the site: leave it out when you write one. > > **items** `readonly ImageWidget[]` > > A list of `ImageWidget`. The widgets, top to bottom. Each is an object with its `type` and that widget’s own fields; `_id` and `metaType` may be left out (the site sets them). At most 1 items. Its fields are listed under the first `ImageWidget` above. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **pageFontOverrides** `readonly PagePageFontOverridesItem[] | null | undefined` > > **Optional.** Leave it out (or pass `null`) and it isn’t sent: the site’s default applies. Optional. Set part of this page in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). Individual sections can still override this for themselves. At most 4 items. > > **PagePageFontOverridesItem** > > **id** `string` > > The row’s id, unique in its array. > > **target** `Target | null` > > Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`. > > **source** `Source | null` > > Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`. > > **slot** `Slot | null` > > Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`. > > **curated** `Curated | null` > > Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`. > > **cdnProvider** `CdnProvider | null` > > Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`. > > **cdnFamily** `string` > > Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. > > **cdnWeights** `string` > > Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. > > **uploads** `readonly PagePageFontOverridesItemUploadsItem[]` > > A list of `PagePageFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. > > **PagePageFontOverridesItemUploadsItem** > > **file** `Readonly\\>` *required* > > **Required.** File attachment reference. > > **id** `string` > > The row’s id, unique in its array. > > **weight** `Weight | null` > > Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`. > > **style** `Style | null` > > Style. One of `normal`, `italic`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **fallback** `Fallback | null` > > Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **footerMarqueeMode** `FooterMarqueeMode | null | undefined` > > **Optional.** Leave it out and the site uses `"inherit"`. The ribbon of phrases scrolling across the top of the footer. Its phrases and the site-wide default are set in Site design → Footer: Marquee. One of `inherit`, `on`, `off`. > > **sections** `SectionsArea | null | undefined` > > **Optional.** Leave it out (or pass `null`) and it isn’t sent: the site’s default applies. Widgets, top to bottom: send `{ "items": [ … ] }`, one object per widget with its `type`. Writing it replaces the whole area. A new document starts with `page-header`. > > **SectionsArea** > > **metaType** `AfterContentAreaMetaType` > > Always `area`. One of `area`. > > **id** `string` > > The area’s id, set by the site: leave it out when you write one. > > **items** `readonly SectionsAreaItem[]` > > A list of `SectionsAreaItem`. The widgets, top to bottom. Each is an object with its `type` and that widget’s own fields; `_id` and `metaType` may be left out (the site sets them). > > **SectionsAreaItem** > > A widget in an area that takes `page-header`, `hero`, `@apostrophecms/layout`, `intro`, `feature`, `stats`, `logos`, `steps`, `media-text`, `device-mock`, `team`, `faq`, `service-map`, `blog-preview`, `cookie-declaration`, `@apostrophecms/rich-text`, `google-reviews`, `testimonials`, `instagram-feed`, `gallery-preview`, `gallery-full`, `pricing`, `newsletter`, `sms-signup`, `form-render`, `final-cta`: the one its `type` names. > > **PageHeaderWidget** > > A `page-header` widget: its `type` and its own fields. A field left out takes its default. > > **type** `PageHeaderWidgetType` *required* > > **Required.** The widget’s type: always `page-header`. One of `page-header`. > > **id** `string` > > The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. > > **metaType** `MetaType` > > Always `widget`. One of `widget`. > > **headline** `string` > > Optional. Leave empty to show the page title (the usual case). Set it only when the visible heading should read differently from the page’s title in navigation, search results and breadcrumbs. > > **eyebrowMode** `EyebrowMode | null` > > The small label above the title. One of `business`, `custom`, `none`. > > **eyebrow** `string` > > Eyebrow text. > > **eyebrowColor** `string | null` > > Optional. Overrides the eyebrow + its dash. Leave empty to use the secondary (mint) color. > > **eyebrowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color, then the mint default. > > **eyebrowWeight** `EyebrowWeight | null` > > Eyebrow weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **eyebrowSize** `EyebrowSize | null` > > Eyebrow size. One of `small`, `normal`, `large`, `xlarge`. > > **titleColor** `string | null` > > Optional — leave empty to track the theme text color. > > **titleColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **titleWeight** `TitleWeight | null` > > Title weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **titleSize** `TitleSize | null` > > Title size. One of `small`, `normal`, `large`, `xlarge`. > > **leadText** `string` > > Optional intro shown under the page title. > > **leadColor** `string | null` > > Optional — leave empty to use the muted text color. > > **leadColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **leadWeight** `LeadWeight | null` > > Lead weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **leadSize** `LeadSize | null` > > Lead size. One of `small`, `normal`, `large`, `xlarge`. > > **pageHeaderBg** `PageHeaderBg | null` > > The section’s full-width background band in dark mode. Transparent lets the page background show through. The palette options track the site colors; choose “Custom color…” for a specific color. One of `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`. > > **pageHeaderBgCustom** `string | null` > > Used when “Section background (dark theme)” is set to Custom color. > > **pageHeaderBgLight** `PageHeaderBgLight | null` > > “Match dark theme” reuses the dark-theme choice; otherwise set the light-mode band independently. One of `inherit`, `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`. > > **pageHeaderBgLightCustom** `string | null` > > Used when “Section background (light theme)” is set to Custom color. > > **pageHeaderImage** `ImageArea` > > An `ImageArea`. Widgets, top to bottom: send `{ "items": [ … ] }`, one object per widget with its `type`. Writing it replaces the whole area. Its fields are listed under the first `ImageArea` above. > > **pageHeaderOverlayColor** `string | null` > > Scrim behind the text over a background image (only applies when one is set). Leave empty to use the dark surface color. > > **pageHeaderOverlayColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme overlay, then the light surface color. > > **pageHeaderOverlayOpacity** `number | null` > > Overlay opacity (%). 0 to 100. > > **pageHeaderFontOverrides** `readonly PageHeaderWidgetPageHeaderFontOverridesItem[]` > > A list of `PageHeaderWidgetPageHeaderFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. > > **PageHeaderWidgetPageHeaderFontOverridesItem** > > **id** `string` > > The row’s id, unique in its array. > > **target** `Target | null` > > Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`. > > **source** `Source | null` > > Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`. > > **slot** `Slot | null` > > Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`. > > **curated** `Curated | null` > > Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`. > > **cdnProvider** `CdnProvider | null` > > Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`. > > **cdnFamily** `string` > > Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. > > **cdnWeights** `string` > > Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. > > **uploads** `readonly PageHeaderWidgetPageHeaderFontOverridesItemUploadsItem[]` > > A list of `PageHeaderWidgetPageHeaderFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. > > **PageHeaderWidgetPageHeaderFontOverridesItemUploadsItem** > > **file** `Readonly\\>` *required* > > **Required.** File attachment reference. > > **id** `string` > > The row’s id, unique in its array. > > **weight** `Weight | null` > > Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`. > > **style** `Style | null` > > Style. One of `normal`, `italic`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **fallback** `Fallback | null` > > Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **pageHeaderPrimaryCtaLabel** `string` > > The visible button text. Leave empty to hide the button. > > **pageHeaderPrimaryCtaUrl** `string` > > Where the button goes — a path (/blog) or full URL. > > **pageHeaderPrimaryCtaNewTab** `boolean` > > Opens the link in a new browser tab (adds rel="noopener noreferrer"). > > **pageHeaderPrimaryCtaVariant** `PageHeaderPrimaryCtaVariant | null` > > Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`. > > **pageHeaderPrimaryCtaSize** `PageHeaderPrimaryCtaSize | null` > > Button size. One of `small`, `normal`, `large`. > > **pageHeaderPrimaryCtaRadius** `PageHeaderPrimaryCtaRadius | null` > > Corner radius. One of `pill`, `rounded`, `slight`, `square`. > > **pageHeaderPrimaryCtaColor** `string | null` > > Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. > > **pageHeaderPrimaryCtaColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) > > **pageHeaderPrimaryCtaTextColor** `string | null` > > The text/icon color. Clear it to derive from the button color (readable on solid fills). > > **pageHeaderPrimaryCtaTextColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme label color. > > **pageHeaderPrimaryCtaHoverColor** `string | null` > > Optional. Drives the hover treatment. Leave empty to derive it from the button color. > > **pageHeaderPrimaryCtaHoverColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme hover color. > > **pageHeaderPrimaryCtaStyle** `PageHeaderPrimaryCtaStyle | null` > > The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`. > > **pageHeaderPrimaryCtaShadowColor** `string | null` > > Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. > > **pageHeaderPrimaryCtaShadowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme shadow color. > > **pageHeaderPrimaryCtaAnimation** `PageHeaderPrimaryCtaAnimation | null` > > Hover motion. One of `lift`, `scale`, `lift-scale`, `none`. > > **pageHeaderPrimaryCtaIcon** `string` > > Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. > > **pageHeaderPrimaryCtaIconFamily** `PageHeaderPrimaryCtaIconFamily | null` > > Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`. > > **pageHeaderPrimaryCtaIconPosition** `PageHeaderPrimaryCtaIconPosition | null` > > Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`. > > **pageHeaderPrimaryCtaIconNudge** `boolean` > > The icon slides toward its side on hover (e.g. an arrow edges outward). > > **pageHeaderSecondaryCtaLabel** `string` > > The visible button text. Leave empty to hide the button. > > **pageHeaderSecondaryCtaUrl** `string` > > Where the button goes — a path (/blog) or full URL. > > **pageHeaderSecondaryCtaNewTab** `boolean` > > Opens the link in a new browser tab (adds rel="noopener noreferrer"). > > **pageHeaderSecondaryCtaVariant** `PageHeaderSecondaryCtaVariant | null` > > Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`. > > **pageHeaderSecondaryCtaSize** `PageHeaderSecondaryCtaSize | null` > > Button size. One of `small`, `normal`, `large`. > > **pageHeaderSecondaryCtaRadius** `PageHeaderSecondaryCtaRadius | null` > > Corner radius. One of `pill`, `rounded`, `slight`, `square`. > > **pageHeaderSecondaryCtaColor** `string | null` > > Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. > > **pageHeaderSecondaryCtaColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) > > **pageHeaderSecondaryCtaTextColor** `string | null` > > The text/icon color. Clear it to derive from the button color (readable on solid fills). > > **pageHeaderSecondaryCtaTextColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme label color. > > **pageHeaderSecondaryCtaHoverColor** `string | null` > > Optional. Drives the hover treatment. Leave empty to derive it from the button color. > > **pageHeaderSecondaryCtaHoverColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme hover color. > > **pageHeaderSecondaryCtaStyle** `PageHeaderSecondaryCtaStyle | null` > > The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`. > > **pageHeaderSecondaryCtaShadowColor** `string | null` > > Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. > > **pageHeaderSecondaryCtaShadowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme shadow color. > > **pageHeaderSecondaryCtaAnimation** `PageHeaderSecondaryCtaAnimation | null` > > Hover motion. One of `lift`, `scale`, `lift-scale`, `none`. > > **pageHeaderSecondaryCtaIcon** `string` > > Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. > > **pageHeaderSecondaryCtaIconFamily** `PageHeaderSecondaryCtaIconFamily | null` > > Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`. > > **pageHeaderSecondaryCtaIconPosition** `PageHeaderSecondaryCtaIconPosition | null` > > Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`. > > **pageHeaderSecondaryCtaIconNudge** `boolean` > > The icon slides toward its side on hover (e.g. an arrow edges outward). > > **sectionCss** `CustomCSS | null` > > A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **HeroWidget** > > A `hero` widget: its `type` and its own fields. A field left out takes its default. > > **type** `HeroWidgetType` *required* > > **Required.** The widget’s type: always `hero`. One of `hero`. > > **heroHeadline** `string` *required* > > **Required.** Headline. > > **id** `string` > > The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. > > **metaType** `MetaType` > > Always `widget`. One of `widget`. > > **heroAlign** `HeroAlign | null` > > Content alignment. One of `left`, `center`. > > **heroHeight** `HeroHeight | null` > > Full fills the screen (home pages); Compact is a short banner for interior pages. One of `full`, `tall`, `compact`. > > **heroGhostEnabled** `boolean` > > Giant outlined word above the headline (same treatment as the footer wordmark). Reveals on hover. > > **heroGhostText** `string` > > Keep it short — one word reads best at display size. Leave empty to use the business name. > > **heroGhostSize** `HeroGhostSize | null` > > Ghost wordmark size. One of `display`, `large`, `medium`. > > **heroGhostFill** `HeroGhostFill | null` > > Outlined letters that fill on hover one at a time, all at once, or always-solid (no ghost effect). One of `letter`, `word`, `solid`. > > **heroGhostFillColor** `string | null` > > Optional. Overrides the wordmark fill + outline tint in the dark theme. Leave empty to track the theme’s text color. > > **heroGhostFillColorLight** `string | null` > > Optional light-theme override — handy over a fixed video/photo background that doesn’t switch with the theme. Falls back to the dark-theme color, then the theme default. > > **heroLockupEnabled** `boolean` > > A small line (optional icon + business name) above the headline. Off by default when the ghost wordmark carries the brand. > > **heroEyebrowEnabled** `boolean` > > Show eyebrow / kicker. > > **heroEyebrow** `string` > > Small label shown above the title. > > **heroEyebrowColor** `string | null` > > Optional. Overrides the eyebrow + its dash. Leave empty to use the secondary (mint) color. > > **heroEyebrowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color, then the mint default. > > **heroEyebrowWeight** `HeroEyebrowWeight | null` > > Eyebrow weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **heroEyebrowSize** `HeroEyebrowSize | null` > > Eyebrow size. One of `small`, `normal`, `large`, `xlarge`. > > **heroEyebrowPlacement** `HeroEyebrowPlacement | null` > > Eyebrow placement. One of `top`, `belowHeadline`, `aboveCta`. > > **heroHeadlineFill** `HeroHeadlineFill | null` > > Solid is the standard headline. The outline options give the headline the same ghost treatment as the wordmark, filling on hover. (The accent sticker word stays solid.) One of `solid`, `letter`, `word`. > > **heroHeadlineFillColor** `string | null` > > Optional. Overrides the headline color in the dark theme. Leave empty to track the theme’s text color. > > **heroHeadlineFillColorLight** `string | null` > > Optional light-theme override — handy over a fixed video/photo background. Falls back to the dark-theme color, then the theme default. > > **heroStickerEnabled** `boolean` > > Wraps the final headline word in the solid accent “sticker”. Turn off for a plain headline. > > **heroStickerStyle** `HeroStickerStyle | null` > > Dual layers a colored offset shadow behind the patch; single is one flat color. One of `dual`, `single`. > > **heroStickerColor** `string | null` > > Patch background. Leave empty to use the site primary/accent color. > > **heroStickerColorSecondary** `string | null` > > Offset-shadow layer. Leave empty to use the site secondary color. > > **heroLinkHoverFill** `boolean` > > Hovering either the wordmark or the headline fills both at once. Only available when both are set to fill the whole word/headline on hover. > > **heroHashtagEnabled** `boolean` > > A bold social hashtag (e.g. #behindthescenes) with its own placement, fill, and optional pill background. > > **heroHashtagText** `string` > > Include the # — e.g. #behindthescenes. > > **heroHashtagPlacement** `HeroHashtagPlacement | null` > > Hashtag placement. One of `aboveGhost`, `aboveHeadline`, `belowHeadline`, `aboveCta`. > > **heroHashtagSize** `HeroHashtagSize | null` > > Smaller than the headline, but still a prominent element. One of `large`, `medium`, `small`. > > **heroHashtagFill** `HeroHashtagFill | null` > > Solid color, or the same outlined “ghost” treatment as the headline that fills on hover. (Ignored when the Solid pill background is used.) One of `solid`, `letter`, `word`. > > **heroHashtagFillColor** `string | null` > > Optional text color (or outline tint). Leave empty to use the site accent color. > > **heroHashtagFillColorLight** `string | null` > > Optional light-theme override — handy over a fixed video/photo background. Falls back to the dark-theme color, then the accent. > > **heroHashtagBackground** `HeroHashtagBackground | null` > > An optional patch behind the hashtag — a softer take on the headline sticker. One of `none`, `solid`, `outline`. > > **heroHashtagBgShape** `HeroHashtagBgShape | null` > > Rounded pill or a squared patch like the headline sticker. One of `pill`, `square`. > > **heroHashtagBgColor** `string | null` > > Patch fill (solid) or border + text (outline). Leave empty to use the site accent color. > > **heroHashtagTilt** `HeroHashtagTilt | null` > > A slight rotation, like the headline sticker. Works with or without a background. One of `none`, `left`, `right`. > > **heroIntro** `string` > > Intro copy. > > **heroIntroColor** `string | null` > > Optional. Overrides the intro text color. Leave empty for the muted default. > > **heroIntroColorLight** `string | null` > > Optional light-theme override — handy over a fixed video/photo background. Falls back to the dark-theme color, then the muted default. > > **heroIntroWeight** `HeroIntroWeight | null` > > Intro weight. One of `normal`, `medium`, `semibold`, `bold`. > > **heroIconPlacement** `HeroIconPlacement | null` > > Where to place an optional Font Awesome icon. One of `none`, `lockup`, `aboveHeadline`, `aboveGhost`. > > **heroIcon** `string` > > Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. > > **heroIconFamily** `HeroIconFamily | null` > > Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`. > > **heroIconColor** `string | null` > > Optional — leave empty to use the design’s own color rhythm. > > **heroIconAnimation** `HeroIconAnimation | null` > > Icon animation. One of `none`, `fa-beat`, `fa-bounce`, `fa-fade`, `fa-beat-fade`, `fa-flip`, `fa-shake`, `fa-spin`. > > **heroBackgroundType** `HeroBackgroundType | null` > > Background type. One of `gradient`, `image`, `video`. > > **heroImage** `ImageArea` > > An `ImageArea`. Used when background type is Image, and as the poster/fallback for Video. Widgets, top to bottom: send `{ "items": [ … ] }`, one object per widget with its `type`. Writing it replaces the whole area. Its fields are listed under the first `ImageArea` above. > > **heroVideo** `readonly Readonly\\>[]` > > Pick from the Videos library (⌘K → Videos). Short, muted loop; reduced-motion visitors get the fallback image instead. The related `video` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document (one at most); a document the site can’t find is left out. At most 1 items. > > **heroMotionPause** `boolean` > > Adds a small, unobtrusive pause/play control so visitors can stop the auto-playing background motion (WCAG 2.2.2). Only appears when a moving background is set. > > **heroFontOverrides** `readonly HeroWidgetHeroFontOverridesItem[]` > > A list of `HeroWidgetHeroFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. > > **HeroWidgetHeroFontOverridesItem** > > **id** `string` > > The row’s id, unique in its array. > > **target** `Target | null` > > Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`. > > **source** `Source | null` > > Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`. > > **slot** `Slot | null` > > Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`. > > **curated** `Curated | null` > > Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`. > > **cdnProvider** `CdnProvider | null` > > Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`. > > **cdnFamily** `string` > > Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. > > **cdnWeights** `string` > > Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. > > **uploads** `readonly HeroWidgetHeroFontOverridesItemUploadsItem[]` > > A list of `HeroWidgetHeroFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. > > **HeroWidgetHeroFontOverridesItemUploadsItem** > > **file** `Readonly\\>` *required* > > **Required.** File attachment reference. > > **id** `string` > > The row’s id, unique in its array. > > **weight** `Weight | null` > > Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`. > > **style** `Style | null` > > Style. One of `normal`, `italic`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **fallback** `Fallback | null` > > Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **heroPrimaryCtaLabel** `string` > > The visible button text. Leave empty to hide the button. > > **heroPrimaryCtaUrl** `string` > > Where the button goes — a path (/blog) or full URL. > > **heroPrimaryCtaNewTab** `boolean` > > Opens the link in a new browser tab (adds rel="noopener noreferrer"). > > **heroPrimaryCtaVariant** `HeroPrimaryCtaVariant | null` > > Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`. > > **heroPrimaryCtaSize** `HeroPrimaryCtaSize | null` > > Button size. One of `small`, `normal`, `large`. > > **heroPrimaryCtaRadius** `HeroPrimaryCtaRadius | null` > > Corner radius. One of `pill`, `rounded`, `slight`, `square`. > > **heroPrimaryCtaColor** `string | null` > > Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. > > **heroPrimaryCtaColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) > > **heroPrimaryCtaTextColor** `string | null` > > The text/icon color. Clear it to derive from the button color (readable on solid fills). > > **heroPrimaryCtaTextColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme label color. > > **heroPrimaryCtaHoverColor** `string | null` > > Optional. Drives the hover treatment. Leave empty to derive it from the button color. > > **heroPrimaryCtaHoverColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme hover color. > > **heroPrimaryCtaStyle** `HeroPrimaryCtaStyle | null` > > The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`. > > **heroPrimaryCtaShadowColor** `string | null` > > Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. > > **heroPrimaryCtaShadowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme shadow color. > > **heroPrimaryCtaAnimation** `HeroPrimaryCtaAnimation | null` > > Hover motion. One of `lift`, `scale`, `lift-scale`, `none`. > > **heroPrimaryCtaIcon** `string` > > Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. > > **heroPrimaryCtaIconFamily** `HeroPrimaryCtaIconFamily | null` > > Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`. > > **heroPrimaryCtaIconPosition** `HeroPrimaryCtaIconPosition | null` > > Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`. > > **heroPrimaryCtaIconNudge** `boolean` > > The icon slides toward its side on hover (e.g. an arrow edges outward). > > **heroSecondaryCtaLabel** `string` > > The visible button text. Leave empty to hide the button. > > **heroSecondaryCtaUrl** `string` > > Where the button goes — a path (/blog) or full URL. > > **heroSecondaryCtaNewTab** `boolean` > > Opens the link in a new browser tab (adds rel="noopener noreferrer"). > > **heroSecondaryCtaVariant** `HeroSecondaryCtaVariant | null` > > Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`. > > **heroSecondaryCtaSize** `HeroSecondaryCtaSize | null` > > Button size. One of `small`, `normal`, `large`. > > **heroSecondaryCtaRadius** `HeroSecondaryCtaRadius | null` > > Corner radius. One of `pill`, `rounded`, `slight`, `square`. > > **heroSecondaryCtaColor** `string | null` > > Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. > > **heroSecondaryCtaColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) > > **heroSecondaryCtaTextColor** `string | null` > > The text/icon color. Clear it to derive from the button color (readable on solid fills). > > **heroSecondaryCtaTextColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme label color. > > **heroSecondaryCtaHoverColor** `string | null` > > Optional. Drives the hover treatment. Leave empty to derive it from the button color. > > **heroSecondaryCtaHoverColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme hover color. > > **heroSecondaryCtaStyle** `HeroSecondaryCtaStyle | null` > > The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`. > > **heroSecondaryCtaShadowColor** `string | null` > > Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. > > **heroSecondaryCtaShadowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme shadow color. > > **heroSecondaryCtaAnimation** `HeroSecondaryCtaAnimation | null` > > Hover motion. One of `lift`, `scale`, `lift-scale`, `none`. > > **heroSecondaryCtaIcon** `string` > > Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. > > **heroSecondaryCtaIconFamily** `HeroSecondaryCtaIconFamily | null` > > Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`. > > **heroSecondaryCtaIconPosition** `HeroSecondaryCtaIconPosition | null` > > Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`. > > **heroSecondaryCtaIconNudge** `boolean` > > The icon slides toward its side on hover (e.g. an arrow edges outward). > > **sectionCss** `CustomCSS | null` > > A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **LayoutWidget** > > A `@apostrophecms/layout` widget: its `type` and its own fields. A field left out takes its default. > > **type** `LayoutWidgetType` *required* > > **Required.** The widget’s type: always `@apostrophecms/layout`. One of `@apostrophecms/layout`. > > **id** `string` > > The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. > > **metaType** `MetaType` > > Always `widget`. One of `widget`. > > **columns** `LayoutColumnArea` > > A `LayoutColumnArea`. Widgets, top to bottom: send `{ "items": [ … ] }`, one object per widget with its `type`. Writing it replaces the whole area. > > **LayoutColumnArea** > > **metaType** `AfterContentAreaMetaType` > > Always `area`. One of `area`. > > **id** `string` > > The area’s id, set by the site: leave it out when you write one. > > **items** `readonly LayoutColumnWidget[]` > > A list of `LayoutColumnWidget`. The widgets, top to bottom. Each is an object with its `type` and that widget’s own fields; `_id` and `metaType` may be left out (the site sets them). > > **LayoutColumnWidget** > > A `@apostrophecms/layout-column` widget: its `type` and its own fields. A field left out takes its default. > > **type** `LayoutColumnWidgetType` *required* > > **Required.** The widget’s type: always `@apostrophecms/layout-column`. One of `@apostrophecms/layout-column`. > > **id** `string` > > The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. > > **metaType** `MetaType` > > Always `widget`. One of `widget`. > > **colstart** `number | null` > > Colstart. > > **colspan** `number | null` > > Colspan. > > **rowstart** `number | null` > > Rowstart. > > **rowspan** `number | null` > > Rowspan. > > **order** `number | null` > > Order. > > **content** `LayoutColumnContentArea` > > A `LayoutColumnContentArea`. Widgets, top to bottom: send `{ "items": [ … ] }`, one object per widget with its `type`. Writing it replaces the whole area. > > **LayoutColumnContentArea** > > **metaType** `AfterContentAreaMetaType` > > Always `area`. One of `area`. > > **id** `string` > > The area’s id, set by the site: leave it out when you write one. > > **items** `readonly LayoutColumnContentAreaItem[]` > > A list of `LayoutColumnContentAreaItem`. The widgets, top to bottom. Each is an object with its `type` and that widget’s own fields; `_id` and `metaType` may be left out (the site sets them). Its fields are listed under the first `LayoutColumnContentAreaItem` above. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **showTablet** `boolean` > > Visible on tablet. > > **showMobile** `boolean` > > Visible on mobile. > > **justify** `Justify | null` > > Horizontal alignment. One of `stretch`, `start`, `end`, `center`. > > **align** `Align | null` > > Vertical alignment. One of `stretch`, `start`, `end`, `center`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **sectionCss** `CustomCSS | null` > > A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **IntroWidget** > > A `intro` widget: its `type` and its own fields. A field left out takes its default. > > **type** `IntroWidgetType` *required* > > **Required.** The widget’s type: always `intro`. One of `intro`. > > **id** `string` > > The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. > > **metaType** `MetaType` > > Always `widget`. One of `widget`. > > **introEyebrow** `string` > > Small label shown above the title. > > **introEyebrowColor** `string | null` > > Optional. Overrides the eyebrow + its dash. Leave empty to use the secondary (mint) color. > > **introEyebrowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color, then the mint default. > > **introEyebrowWeight** `IntroEyebrowWeight | null` > > Eyebrow weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **introEyebrowSize** `IntroEyebrowSize | null` > > Eyebrow size. One of `small`, `normal`, `large`, `xlarge`. > > **introHeadline** `string` > > Headline. > > **introHeadlineColor** `string | null` > > Optional. Overrides the headline color. Leave empty to track the theme’s text color. > > **introHeadlineColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color, then the theme default. > > **introHeadlineWeight** `IntroHeadlineWeight | null` > > Headline weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **introBody** `string` > > Body copy. > > **introBodyColor** `string | null` > > Optional. Overrides the body text color. Leave empty for the muted default. > > **introBodyColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color, then the muted default. > > **introBodyWeight** `IntroBodyWeight | null` > > Body weight. One of `normal`, `medium`, `semibold`, `bold`. > > **introPhotoPlacement** `IntroPhotoPlacement | null` > > Where the optional photo sits. Left/right place it beside the text; Full background fills the whole section behind the text (with a readability overlay). One of `none`, `left`, `right`, `background`. > > **introImage** `ImageArea` > > An `ImageArea`. Widgets, top to bottom: send `{ "items": [ … ] }`, one object per widget with its `type`. Writing it replaces the whole area. Its fields are listed under the first `ImageArea` above. > > **introPhotoCorners** `IntroPhotoCorners | null` > > Photo corners. One of `rounded`, `squared`. > > **introPhotoFrame** `IntroPhotoFrame | null` > > Border draws a frame around the photo; Offset adds a refined offset accent frame behind it. One of `none`, `border`, `offset`. > > **introPhotoFrameColor** `string | null` > > Border / offset-frame color. Leave empty to use the site accent color. > > **introPhotoTilt** `IntroPhotoTilt | null` > > A slight rotation for a more playful look. One of `none`, `left`, `right`. > > **introPhotoHover** `IntroPhotoHover | null` > > Photo hover effect. One of `none`, `lift`, `zoom`, `tilt`, `glow`, `lift-glow`, `zoom-glow`. > > **introOverlayColor** `string | null` > > Scrim behind the text over a full-background photo. Leave empty to use the dark surface color. > > **introOverlayColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme overlay, then the light surface color. > > **introOverlayOpacity** `number | null` > > Overlay opacity (%). 0 to 100. > > **introBg** `IntroBg | null` > > The section’s full-width background band in dark mode. Transparent lets the page background show through. The palette options track the site colors; choose “Custom color…” for a specific color. One of `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`. > > **introBgCustom** `string | null` > > Used when “Section background (dark theme)” is set to Custom color. > > **introBgLight** `IntroBgLight | null` > > “Match dark theme” reuses the dark-theme choice; otherwise set the light-mode band independently. One of `inherit`, `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`. > > **introBgLightCustom** `string | null` > > Used when “Section background (light theme)” is set to Custom color. > > **introFontOverrides** `readonly IntroWidgetIntroFontOverridesItem[]` > > A list of `IntroWidgetIntroFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. > > **IntroWidgetIntroFontOverridesItem** > > **id** `string` > > The row’s id, unique in its array. > > **target** `Target | null` > > Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`. > > **source** `Source | null` > > Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`. > > **slot** `Slot | null` > > Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`. > > **curated** `Curated | null` > > Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`. > > **cdnProvider** `CdnProvider | null` > > Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`. > > **cdnFamily** `string` > > Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. > > **cdnWeights** `string` > > Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. > > **uploads** `readonly IntroWidgetIntroFontOverridesItemUploadsItem[]` > > A list of `IntroWidgetIntroFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. > > **IntroWidgetIntroFontOverridesItemUploadsItem** > > **file** `Readonly\\>` *required* > > **Required.** File attachment reference. > > **id** `string` > > The row’s id, unique in its array. > > **weight** `Weight | null` > > Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`. > > **style** `Style | null` > > Style. One of `normal`, `italic`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **fallback** `Fallback | null` > > Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **sectionCss** `CustomCSS | null` > > A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **FeatureWidget** > > A `feature` widget: its `type` and its own fields. A field left out takes its default. > > **type** `FeatureWidgetType` *required* > > **Required.** The widget’s type: always `feature`. One of `feature`. > > **id** `string` > > The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. > > **metaType** `MetaType` > > Always `widget`. One of `widget`. > > **featureColumns** `FeatureColumns | null` > > Auto fits as many as comfortably fit and works for any number of cards. Or lock a maximum per row. One of `auto`, `2`, `3`, `4`. > > **featureGap** `FeatureGap | null` > > Gap between cards. One of `tight`, `normal`, `roomy`. > > **featureCardSize** `FeatureCardSize | null` > > Scales padding, icon, title, and the index numeral together. One of `small`, `medium`, `large`. > > **featureCardStyle** `FeatureCardStyle | null` > > The card treatment. Poster (the default) frames the card with an accent keyline; Raised is a quiet lit card; Luxe a frosted glass panel; Spine adds a color rail; Tint an accent wash; Ticket/Bracket/Forge/Press/Inlay are the graphic showstoppers. One of `raised`, `luxe`, `outline`, `plain`, `poster`, `edge`, `tint`, `ticket`, `bracket`, `forge`, `press`, `inlay`. > > **featureCardStyleRadius** `FeatureCardStyleRadius | null` > > Corner rounding for each card. Default keeps the widget’s own tuned corners — except Forge, which defaults to tight machined corners matching its engraved frame. One of `default`, `square`, `slight`, `rounded`, `large`. > > **featureCardStyleAccentColor** `string | null` > > Colors the Spine rail, Bracket marks, Forge corner/frame and Press margin rule. Leave empty to use the brand accent. > > **featureCardStyleAccentColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **featureCardStyleForgeScope** `FeatureCardStyleForgeScope | null` > > Where the Forge plate wears its color: a single corner mark (the machinist’s datum, default) or the whole engraved frame. One of `corner`, `frame`. > > **featureCardStyleForgeWeight** `FeatureCardStyleForgeWeight | null` > > Thickness of the Forge corner mark / colored frame. One of `fine`, `medium`, `bold`. > > **featureCardHover** `FeatureCardHover | null` > > How a card reacts on hover. Pop is the lift + hard offset shadow; Glow is a soft accent halo. One of `none`, `lift`, `pop`, `glow`, `border`. > > **featureCardHoverColor** `string | null` > > Border / shadow / glow color on hover. Leave empty to use the site accent color. > > **featureCardHoverColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color, then the accent. > > **featureNumbering** `boolean` > > A big outlined numeral on each card (01, 02, …). Great for step-by-step sequences; turn off when the cards aren’t ordered. > > **featureNumberFill** `FeatureNumberFill | null` > > Same treatment as the hero ghost text: all numbers solid, outlined and filling on hover, or always outlined. One of `solid`, `hover`, `outline`. > > **featureNumberColor** `string | null` > > Optional. Tints the numeral fill + outline. Leave empty to track the theme’s text color. > > **featureNumberColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color, then the theme default. > > **featureTitleColor** `string | null` > > Optional. Overrides the card title color. Leave empty to track the theme’s text color. > > **featureTitleColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color, then the theme default. > > **featureTitleWeight** `FeatureTitleWeight | null` > > Title weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **featureTextColor** `string | null` > > Optional. Overrides the card text color. Leave empty for the muted default. > > **featureTextColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color, then the muted default. > > **featureTextWeight** `FeatureTextWeight | null` > > Text weight. One of `normal`, `medium`, `semibold`, `bold`. > > **featureCards** `readonly FeatureWidgetFeatureCardsItem[]` > > A list of `FeatureWidgetFeatureCardsItem`. Feature cards. > > **FeatureWidgetFeatureCardsItem** > > **cardTitle** `string` *required* > > **Required.** Title. > > **id** `string` > > The row’s id, unique in its array. > > **icon** `string` > > Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. > > **iconFamily** `IconFamily | null` > > Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`. > > **iconColor** `string | null` > > Optional — leave empty to use the design’s own color rhythm. > > **iconAnimation** `IconAnimation | null` > > Icon animation. One of `none`, `fa-beat`, `fa-bounce`, `fa-fade`, `fa-beat-fade`, `fa-flip`, `fa-shake`, `fa-spin`. > > **iconSize** `IconSize | null` > > Relative to the component’s base icon size. One of `default`, `sm`, `lg`, `xl`, `2xl`, `2x`, `3x`, `4x`, `5x`. > > **cardText** `string` > > Text. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **featureBg** `FeatureBg | null` > > The section’s full-width background band in dark mode. Transparent lets the page background show through. The palette options track the site colors; choose “Custom color…” for a specific color. One of `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`. > > **featureBgCustom** `string | null` > > Used when “Section background (dark theme)” is set to Custom color. > > **featureBgLight** `FeatureBgLight | null` > > “Match dark theme” reuses the dark-theme choice; otherwise set the light-mode band independently. One of `inherit`, `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`. > > **featureBgLightCustom** `string | null` > > Used when “Section background (light theme)” is set to Custom color. > > **featureFontOverrides** `readonly FeatureWidgetFeatureFontOverridesItem[]` > > A list of `FeatureWidgetFeatureFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. > > **FeatureWidgetFeatureFontOverridesItem** > > **id** `string` > > The row’s id, unique in its array. > > **target** `Target | null` > > Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`. > > **source** `Source | null` > > Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`. > > **slot** `Slot | null` > > Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`. > > **curated** `Curated | null` > > Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`. > > **cdnProvider** `CdnProvider | null` > > Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`. > > **cdnFamily** `string` > > Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. > > **cdnWeights** `string` > > Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. > > **uploads** `readonly FeatureWidgetFeatureFontOverridesItemUploadsItem[]` > > A list of `FeatureWidgetFeatureFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. > > **FeatureWidgetFeatureFontOverridesItemUploadsItem** > > **file** `Readonly\\>` *required* > > **Required.** File attachment reference. > > **id** `string` > > The row’s id, unique in its array. > > **weight** `Weight | null` > > Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`. > > **style** `Style | null` > > Style. One of `normal`, `italic`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **fallback** `Fallback | null` > > Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **sectionCss** `CustomCSS | null` > > A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **StatsWidget** > > A `stats` widget: its `type` and its own fields. A field left out takes its default. > > **type** `StatsWidgetType` *required* > > **Required.** The widget’s type: always `stats`. One of `stats`. > > **id** `string` > > The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. > > **metaType** `MetaType` > > Always `widget`. One of `widget`. > > **statsEyebrowEnabled** `boolean` > > A small label above the heading (e.g. "By the numbers"). > > **statsEyebrow** `string` > > Eyebrow. > > **statsEyebrowColor** `string | null` > > Optional — leave empty to use the secondary (mint) color. > > **statsEyebrowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **statsEyebrowWeight** `StatsEyebrowWeight | null` > > Eyebrow weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **statsEyebrowSize** `StatsEyebrowSize | null` > > Eyebrow size. One of `small`, `normal`, `large`, `xlarge`. > > **statsHeading** `string` > > Optional. Leave empty to show just the numbers. > > **statsHeadingColor** `string | null` > > Optional — leave empty to track the theme text color. > > **statsHeadingColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **statsHeadingWeight** `StatsHeadingWeight | null` > > Heading weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **statsColumns** `StatsColumns | null` > > Auto fits as many as comfortably fit and works for any number of stats. Or lock a maximum per row. One of `auto`, `2`, `3`, `4`. > > **statsGap** `StatsGap | null` > > Gap between stats. One of `tight`, `normal`, `roomy`. > > **statsSize** `StatsSize | null` > > The baseline scale for the whole stat (value / icon / label / description stay proportional). Fine-tune any single element with its own size control below. One of `small`, `medium`, `large`. > > **statsAlign** `StatsAlign | null` > > Alignment. One of `center`, `left`. > > **statsDividers** `boolean` > > A hairline rule between each stat — the classic "by the numbers" rail. > > **statsCountUp** `boolean` > > Numbers tick up from zero when the band scrolls into view. Non-numeric values and reduced-motion visitors simply show the final value. > > **statsIconSize** `StatsIconSize | null` > > Size of the icon above each number, independent of the overall stat size. One of `auto`, `sm`, `md`, `lg`, `xl`, `xxl`. > > **statsIconGap** `StatsIconGap | null` > > Space between the icon and the number below it. One of `tight`, `normal`, `roomy`. > > **statsValueSize** `StatsValueSize | null` > > Value size. One of `auto`, `xs`, `sm`, `md`, `lg`, `xl`. > > **statsValueWeight** `StatsValueWeight | null` > > Value weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **statsValueColor** `string | null` > > The big numeral. Optional — leave empty to use the site accent color. > > **statsValueColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color, then the accent. > > **statsLabelSize** `StatsLabelSize | null` > > Label size. One of `auto`, `xs`, `sm`, `md`, `lg`, `xl`. > > **statsLabelWeight** `StatsLabelWeight | null` > > Label weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **statsLabelColor** `string | null` > > Optional — leave empty to track the theme text color. > > **statsLabelColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **statsDescriptionSize** `StatsDescriptionSize | null` > > Description size. One of `auto`, `xs`, `sm`, `md`, `lg`, `xl`. > > **statsDescriptionWeight** `StatsDescriptionWeight | null` > > Description weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **statsDescriptionColor** `string | null` > > Optional — leave empty to use the muted text color. > > **statsDescriptionColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **stats** `readonly StatsWidgetStatsItem[]` > > A list of `StatsWidgetStatsItem`. Stats. > > **StatsWidgetStatsItem** > > **value** `string` *required* > > **Required.** The number, e.g. 500, 4.9, 12 — symbols go in the prefix/suffix so the count-up animates the number alone. > > **label** `string` *required* > > **Required.** Label. > > **id** `string` > > The row’s id, unique in its array. > > **icon** `string` > > Optional Font Awesome icon shown above the number (e.g. star, bolt, chart-line). Leave empty for no icon. > > **iconFamily** `IconFamily | null` > > Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`. > > **iconColor** `string | null` > > Optional — leave empty to use the design’s own color rhythm. > > **valuePrefix** `string` > > Optional, shown before the number (e.g. \$, \~, >). Kept out of the count-up. > > **valueSuffix** `string` > > Optional, shown after the number (e.g. +, %, k, yrs, ★). > > **description** `string` > > Optional small text under the label. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **statsBg** `StatsBg | null` > > The section’s full-width background band in dark mode. Transparent lets the page background show through. The palette options track the site colors; choose “Custom color…” for a specific color. One of `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`. > > **statsBgCustom** `string | null` > > Used when “Section background (dark theme)” is set to Custom color. > > **statsBgLight** `StatsBgLight | null` > > “Match dark theme” reuses the dark-theme choice; otherwise set the light-mode band independently. One of `inherit`, `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`. > > **statsBgLightCustom** `string | null` > > Used when “Section background (light theme)” is set to Custom color. > > **statsFontOverrides** `readonly StatsWidgetStatsFontOverridesItem[]` > > A list of `StatsWidgetStatsFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. > > **StatsWidgetStatsFontOverridesItem** > > **id** `string` > > The row’s id, unique in its array. > > **target** `Target | null` > > Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`. > > **source** `Source | null` > > Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`. > > **slot** `Slot | null` > > Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`. > > **curated** `Curated | null` > > Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`. > > **cdnProvider** `CdnProvider | null` > > Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`. > > **cdnFamily** `string` > > Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. > > **cdnWeights** `string` > > Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. > > **uploads** `readonly StatsWidgetStatsFontOverridesItemUploadsItem[]` > > A list of `StatsWidgetStatsFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. > > **StatsWidgetStatsFontOverridesItemUploadsItem** > > **file** `Readonly\\>` *required* > > **Required.** File attachment reference. > > **id** `string` > > The row’s id, unique in its array. > > **weight** `Weight | null` > > Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`. > > **style** `Style | null` > > Style. One of `normal`, `italic`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **fallback** `Fallback | null` > > Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **statsCtaLabel** `string` > > The visible button text. Leave empty to hide the button. > > **statsCtaUrl** `string` > > Where the button goes — a path (/blog) or full URL. > > **statsCtaNewTab** `boolean` > > Opens the link in a new browser tab (adds rel="noopener noreferrer"). > > **statsCtaVariant** `StatsCtaVariant | null` > > Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`. > > **statsCtaSize** `StatsCtaSize | null` > > Button size. One of `small`, `normal`, `large`. > > **statsCtaRadius** `StatsCtaRadius | null` > > Corner radius. One of `pill`, `rounded`, `slight`, `square`. > > **statsCtaColor** `string | null` > > Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. > > **statsCtaColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) > > **statsCtaTextColor** `string | null` > > The text/icon color. Clear it to derive from the button color (readable on solid fills). > > **statsCtaTextColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme label color. > > **statsCtaHoverColor** `string | null` > > Optional. Drives the hover treatment. Leave empty to derive it from the button color. > > **statsCtaHoverColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme hover color. > > **statsCtaStyle** `StatsCtaStyle | null` > > The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`. > > **statsCtaShadowColor** `string | null` > > Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. > > **statsCtaShadowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme shadow color. > > **statsCtaAnimation** `StatsCtaAnimation | null` > > Hover motion. One of `lift`, `scale`, `lift-scale`, `none`. > > **statsCtaIcon** `string` > > Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. > > **statsCtaIconFamily** `StatsCtaIconFamily | null` > > Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`. > > **statsCtaIconPosition** `StatsCtaIconPosition | null` > > Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`. > > **statsCtaIconNudge** `boolean` > > The icon slides toward its side on hover (e.g. an arrow edges outward). > > **sectionCss** `CustomCSS | null` > > A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **LogosWidget** > > A `logos` widget: its `type` and its own fields. A field left out takes its default. > > **type** `LogosWidgetType` *required* > > **Required.** The widget’s type: always `logos`. One of `logos`. > > **id** `string` > > The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. > > **metaType** `MetaType` > > Always `widget`. One of `widget`. > > **logosEyebrowEnabled** `boolean` > > A small label above the heading (e.g. "Trusted by"). > > **logosEyebrow** `string` > > Eyebrow. > > **logosEyebrowColor** `string | null` > > Optional — leave empty to use the secondary (mint) color. > > **logosEyebrowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **logosEyebrowWeight** `LogosEyebrowWeight | null` > > Eyebrow weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **logosEyebrowSize** `LogosEyebrowSize | null` > > Eyebrow size. One of `small`, `normal`, `large`, `xlarge`. > > **logosHeading** `string` > > Optional. Leave empty to show just the logos. > > **logosHeadingColor** `string | null` > > Optional — leave empty to track the theme text color. > > **logosHeadingColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **logosHeadingWeight** `LogosHeadingWeight | null` > > Heading weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **logosIntro** `string` > > Optional short sentence under the heading. > > **logosIntroColor** `string | null` > > Optional — leave empty to use the muted text color. > > **logosIntroColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **logosIntroWeight** `LogosIntroWeight | null` > > Intro weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **logosDisplay** `LogosDisplay | null` > > A slow scrolling ribbon (marquee) or a calm static grid. One of `marquee`, `grid`. > > **logosSpeed** `LogosSpeed | null` > > Marquee speed. One of `slow`, `normal`, `fast`. > > **logosDirection** `LogosDirection | null` > > Marquee direction. One of `left`, `right`. > > **logosMotionPause** `boolean` > > Adds a small, unobtrusive pause/play control so visitors can stop the auto-playing background motion (WCAG 2.2.2). Only appears when a moving background is set. > > **logosColumns** `LogosColumns | null` > > Auto fits as many as comfortably fit and works for any number of logos. Or lock a maximum per row. One of `auto`, `3`, `4`, `5`, `6`. > > **logosGap** `LogosGap | null` > > Gap between logos. One of `tight`, `normal`, `roomy`. > > **logosSize** `LogosSize | null` > > The height each logo is scaled to (width follows the logo’s aspect ratio). One of `small`, `medium`, `large`. > > **logosAlign** `LogosAlign | null` > > Aligns the eyebrow / heading / intro (and the grid when there are few logos). One of `center`, `left`. > > **logosTile** `boolean` > > Sets every logo on a raised, bordered card. Off = logos sit straight on the background. > > **logosGrayscale** `boolean` > > Mutes the logos to grayscale and dims them, returning to full color on hover — the classic logo-wall look. > > **logos** `readonly LogosWidgetLogosItem[]` > > A list of `LogosWidgetLogosItem`. Logos. > > **LogosWidgetLogosItem** > > **image** `readonly Readonly\\>[]` *required* > > **Required.** Pick a logo from the Images library. A transparent PNG or an SVG works best. The related `@apostrophecms/image` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document (one at most); a document the site can’t find is left out. At most 1 items. > > **name** `string` *required* > > **Required.** Company / partner / certification name — used as the image alt text and the link title. > > **id** `string` > > The row’s id, unique in its array. > > **linkUrl** `string` > > Make this logo a link, e.g. to the partner’s site. Opens in a new tab for external URLs. > > **invertDark** `boolean` > > For dark / black logos that would vanish on the dark theme — flips them to light. Leave off for full-color or white logos. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **logosBg** `LogosBg | null` > > The section’s full-width background band in dark mode. Transparent lets the page background show through. The palette options track the site colors; choose “Custom color…” for a specific color. One of `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`. > > **logosBgCustom** `string | null` > > Used when “Section background (dark theme)” is set to Custom color. > > **logosBgLight** `LogosBgLight | null` > > “Match dark theme” reuses the dark-theme choice; otherwise set the light-mode band independently. One of `inherit`, `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`. > > **logosBgLightCustom** `string | null` > > Used when “Section background (light theme)” is set to Custom color. > > **logosFontOverrides** `readonly LogosWidgetLogosFontOverridesItem[]` > > A list of `LogosWidgetLogosFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. > > **LogosWidgetLogosFontOverridesItem** > > **id** `string` > > The row’s id, unique in its array. > > **target** `Target | null` > > Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`. > > **source** `Source | null` > > Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`. > > **slot** `Slot | null` > > Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`. > > **curated** `Curated | null` > > Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`. > > **cdnProvider** `CdnProvider | null` > > Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`. > > **cdnFamily** `string` > > Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. > > **cdnWeights** `string` > > Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. > > **uploads** `readonly LogosWidgetLogosFontOverridesItemUploadsItem[]` > > A list of `LogosWidgetLogosFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. > > **LogosWidgetLogosFontOverridesItemUploadsItem** > > **file** `Readonly\\>` *required* > > **Required.** File attachment reference. > > **id** `string` > > The row’s id, unique in its array. > > **weight** `Weight | null` > > Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`. > > **style** `Style | null` > > Style. One of `normal`, `italic`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **fallback** `Fallback | null` > > Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **logosCtaLabel** `string` > > The visible button text. Leave empty to hide the button. > > **logosCtaUrl** `string` > > Where the button goes — a path (/blog) or full URL. > > **logosCtaNewTab** `boolean` > > Opens the link in a new browser tab (adds rel="noopener noreferrer"). > > **logosCtaVariant** `LogosCtaVariant | null` > > Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`. > > **logosCtaSize** `LogosCtaSize | null` > > Button size. One of `small`, `normal`, `large`. > > **logosCtaRadius** `LogosCtaRadius | null` > > Corner radius. One of `pill`, `rounded`, `slight`, `square`. > > **logosCtaColor** `string | null` > > Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. > > **logosCtaColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) > > **logosCtaTextColor** `string | null` > > The text/icon color. Clear it to derive from the button color (readable on solid fills). > > **logosCtaTextColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme label color. > > **logosCtaHoverColor** `string | null` > > Optional. Drives the hover treatment. Leave empty to derive it from the button color. > > **logosCtaHoverColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme hover color. > > **logosCtaStyle** `LogosCtaStyle | null` > > The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`. > > **logosCtaShadowColor** `string | null` > > Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. > > **logosCtaShadowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme shadow color. > > **logosCtaAnimation** `LogosCtaAnimation | null` > > Hover motion. One of `lift`, `scale`, `lift-scale`, `none`. > > **logosCtaIcon** `string` > > Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. > > **logosCtaIconFamily** `LogosCtaIconFamily | null` > > Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`. > > **logosCtaIconPosition** `LogosCtaIconPosition | null` > > Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`. > > **logosCtaIconNudge** `boolean` > > The icon slides toward its side on hover (e.g. an arrow edges outward). > > **sectionCss** `CustomCSS | null` > > A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **StepsWidget** > > A `steps` widget: its `type` and its own fields. A field left out takes its default. > > **type** `StepsWidgetType` *required* > > **Required.** The widget’s type: always `steps`. One of `steps`. > > **id** `string` > > The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. > > **metaType** `MetaType` > > Always `widget`. One of `widget`. > > **stepsEyebrowEnabled** `boolean` > > A small label above the heading (e.g. "How it works"). > > **stepsEyebrow** `string` > > Eyebrow. > > **stepsEyebrowColor** `string | null` > > Optional — leave empty to use the secondary (mint) color. > > **stepsEyebrowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **stepsEyebrowWeight** `StepsEyebrowWeight | null` > > Eyebrow weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **stepsEyebrowSize** `StepsEyebrowSize | null` > > Eyebrow size. One of `small`, `normal`, `large`, `xlarge`. > > **stepsHeading** `string` > > Optional. Leave empty to show just the steps. > > **stepsHeadingColor** `string | null` > > Optional — leave empty to track the theme text color. > > **stepsHeadingColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **stepsHeadingWeight** `StepsHeadingWeight | null` > > Heading weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **stepsHeadingSize** `StepsHeadingSize | null` > > Heading size. One of `small`, `normal`, `large`, `xlarge`, `xxlarge`. > > **stepsIntro** `string` > > Optional short sentence under the heading. > > **stepsIntroColor** `string | null` > > Optional — leave empty to use the muted text color. > > **stepsIntroColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **stepsIntroWeight** `StepsIntroWeight | null` > > Intro weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **stepsIntroSize** `StepsIntroSize | null` > > Intro size. One of `small`, `normal`, `large`, `xlarge`, `xxlarge`. > > **stepsLayout** `StepsLayout | null` > > Horizontal lays the steps across a row (marker on top); Vertical stacks them as a classic timeline (marker on the left). One of `horizontal`, `vertical`. > > **stepsColumns** `StepsColumns | null` > > Horizontal only. Auto fits as many as comfortably fit and works for any number of steps. Or lock a maximum per row. One of `auto`, `2`, `3`, `4`. > > **stepsGap** `StepsGap | null` > > Gap between steps. One of `tight`, `normal`, `roomy`. > > **stepsAlign** `StepsAlign | null` > > Horizontal only — aligns the section header and each step’s text. (Vertical is always left-aligned beside its marker.) One of `center`, `left`. > > **stepsConnector** `boolean` > > A line linking the step markers into a timeline (down the markers when vertical, across them when horizontal). > > **stepsCardStyle** `StepsCardStyle | null` > > Plain keeps the connector-linked timeline (just marker + text, no card). Every other style boxes each step — Raised is a quiet lit card, Luxe a frosted glass panel, Outline a plaque frame, Spine adds a color rail, Tint an accent wash; Ticket/Bracket/Forge/Press/Inlay are the graphic showstoppers. One of `raised`, `luxe`, `outline`, `plain`, `poster`, `edge`, `tint`, `ticket`, `bracket`, `forge`, `press`, `inlay`. > > **stepsCardStyleRadius** `StepsCardStyleRadius | null` > > Corner rounding for each card. Default keeps the widget’s own tuned corners — except Forge, which defaults to tight machined corners matching its engraved frame. One of `default`, `square`, `slight`, `rounded`, `large`. > > **stepsCardStyleAccentColor** `string | null` > > Colors the Spine rail, Bracket marks, Forge corner/frame and Press margin rule. Leave empty to use the brand accent. > > **stepsCardStyleAccentColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **stepsCardStyleForgeScope** `StepsCardStyleForgeScope | null` > > Where the Forge plate wears its color: a single corner mark (the machinist’s datum, default) or the whole engraved frame. One of `corner`, `frame`. > > **stepsCardStyleForgeWeight** `StepsCardStyleForgeWeight | null` > > Thickness of the Forge corner mark / colored frame. One of `fine`, `medium`, `bold`. > > **stepsCardHover** `StepsCardHover | null` > > What a boxed step does on hover (applies when Step style is not Plain). Lift/Pop/Press/Glow/Outline are instant; Sheen sweeps a light across; Tilt, Magnetic and Spotlight follow the cursor (need site animations on). One of `none`, `lift`, `pop`, `press`, `glow`, `border`, `sheen`, `tilt`, `magnetic`, `spotlight`. > > **stepsMarker** `StepsMarker | null` > > Number auto-counts 1, 2, 3…; Icon shows each step’s icon (falling back to the number when a step has none); None hides the marker badge. One of `number`, `icon`, `none`. > > **stepsMarkerStyle** `StepsMarkerStyle | null` > > Soft is a tinted accent badge; Filled is a solid accent badge; Outline is a bordered badge. One of `soft`, `filled`, `outline`. > > **stepsMarkerShape** `StepsMarkerShape | null` > > Marker shape. One of `circle`, `rounded`, `square`. > > **stepsMarkerSize** `StepsMarkerSize | null` > > Marker size. One of `small`, `medium`, `large`. > > **stepsAccentColor** `string | null` > > Color for the marker badge and the connector line. Leave empty to use the site accent color. > > **stepsAccentColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme accent. > > **stepsTitleSize** `StepsTitleSize | null` > > Title size. One of `small`, `normal`, `large`, `xlarge`, `xxlarge`. > > **stepsTitleWeight** `StepsTitleWeight | null` > > Title weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **stepsTitleColor** `string | null` > > Optional — leave empty to track the theme text color. > > **stepsTitleColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **stepsBodySize** `StepsBodySize | null` > > Body size. One of `small`, `normal`, `large`, `xlarge`, `xxlarge`. > > **stepsBodyWeight** `StepsBodyWeight | null` > > Body weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **stepsBodyColor** `string | null` > > Optional — leave empty to use the muted text color. > > **stepsBodyColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **stepsItems** `readonly StepsWidgetStepsItemsItem[]` > > A list of `StepsWidgetStepsItemsItem`. Each item is one step in the process. They render in this order; the number marker counts automatically. > > **StepsWidgetStepsItemsItem** > > **title** `string` *required* > > **Required.** Title. > > **id** `string` > > The row’s id, unique in its array. > > **icon** `string` > > Optional Font Awesome icon for this step (e.g. calendar-check, circle-check, gear). Shown in the marker when the section marker is set to "Icon"; otherwise the step is numbered. > > **iconFamily** `IconFamily | null` > > Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`. > > **iconColor** `string | null` > > Optional — leave empty to use the design’s own color rhythm. > > **number** `string` > > Overrides the auto number for this step’s marker, e.g. "01" or "A". Leave empty to auto-count. > > **body** `string` > > Optional description under the title. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **stepsBg** `StepsBg | null` > > The section’s full-width background band in dark mode. Transparent lets the page background show through. The palette options track the site colors; choose “Custom color…” for a specific color. One of `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`. > > **stepsBgCustom** `string | null` > > Used when “Section background (dark theme)” is set to Custom color. > > **stepsBgLight** `StepsBgLight | null` > > “Match dark theme” reuses the dark-theme choice; otherwise set the light-mode band independently. One of `inherit`, `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`. > > **stepsBgLightCustom** `string | null` > > Used when “Section background (light theme)” is set to Custom color. > > **stepsFontOverrides** `readonly StepsWidgetStepsFontOverridesItem[]` > > A list of `StepsWidgetStepsFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. > > **StepsWidgetStepsFontOverridesItem** > > **id** `string` > > The row’s id, unique in its array. > > **target** `Target | null` > > Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`. > > **source** `Source | null` > > Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`. > > **slot** `Slot | null` > > Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`. > > **curated** `Curated | null` > > Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`. > > **cdnProvider** `CdnProvider | null` > > Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`. > > **cdnFamily** `string` > > Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. > > **cdnWeights** `string` > > Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. > > **uploads** `readonly StepsWidgetStepsFontOverridesItemUploadsItem[]` > > A list of `StepsWidgetStepsFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. > > **StepsWidgetStepsFontOverridesItemUploadsItem** > > **file** `Readonly\\>` *required* > > **Required.** File attachment reference. > > **id** `string` > > The row’s id, unique in its array. > > **weight** `Weight | null` > > Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`. > > **style** `Style | null` > > Style. One of `normal`, `italic`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **fallback** `Fallback | null` > > Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **stepsCtaLabel** `string` > > The visible button text. Leave empty to hide the button. > > **stepsCtaUrl** `string` > > Where the button goes — a path (/blog) or full URL. > > **stepsCtaNewTab** `boolean` > > Opens the link in a new browser tab (adds rel="noopener noreferrer"). > > **stepsCtaVariant** `StepsCtaVariant | null` > > Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`. > > **stepsCtaSize** `StepsCtaSize | null` > > Button size. One of `small`, `normal`, `large`. > > **stepsCtaRadius** `StepsCtaRadius | null` > > Corner radius. One of `pill`, `rounded`, `slight`, `square`. > > **stepsCtaColor** `string | null` > > Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. > > **stepsCtaColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) > > **stepsCtaTextColor** `string | null` > > The text/icon color. Clear it to derive from the button color (readable on solid fills). > > **stepsCtaTextColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme label color. > > **stepsCtaHoverColor** `string | null` > > Optional. Drives the hover treatment. Leave empty to derive it from the button color. > > **stepsCtaHoverColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme hover color. > > **stepsCtaStyle** `StepsCtaStyle | null` > > The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`. > > **stepsCtaShadowColor** `string | null` > > Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. > > **stepsCtaShadowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme shadow color. > > **stepsCtaAnimation** `StepsCtaAnimation | null` > > Hover motion. One of `lift`, `scale`, `lift-scale`, `none`. > > **stepsCtaIcon** `string` > > Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. > > **stepsCtaIconFamily** `StepsCtaIconFamily | null` > > Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`. > > **stepsCtaIconPosition** `StepsCtaIconPosition | null` > > Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`. > > **stepsCtaIconNudge** `boolean` > > The icon slides toward its side on hover (e.g. an arrow edges outward). > > **sectionCss** `CustomCSS | null` > > A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **MediaTextWidget** > > A `media-text` widget: its `type` and its own fields. A field left out takes its default. > > **type** `MediaTextWidgetType` *required* > > **Required.** The widget’s type: always `media-text`. One of `media-text`. > > **id** `string` > > The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. > > **metaType** `MetaType` > > Always `widget`. One of `widget`. > > **mediaTextEyebrowEnabled** `boolean` > > A small label above the section heading (e.g. "Why us"). > > **mediaTextEyebrow** `string` > > Eyebrow. > > **mediaTextEyebrowColor** `string | null` > > Optional — leave empty to use the secondary (mint) color. > > **mediaTextEyebrowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **mediaTextEyebrowWeight** `MediaTextEyebrowWeight | null` > > Eyebrow weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **mediaTextEyebrowSize** `MediaTextEyebrowSize | null` > > Eyebrow size. One of `small`, `normal`, `large`, `xlarge`. > > **mediaTextHeading** `string` > > Optional section heading above the blocks. Leave empty to show just the blocks. > > **mediaTextHeadingColor** `string | null` > > Optional — leave empty to track the theme text color. > > **mediaTextHeadingColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **mediaTextHeadingWeight** `MediaTextHeadingWeight | null` > > Heading weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **mediaTextHeadingSize** `MediaTextHeadingSize | null` > > Heading size. One of `small`, `normal`, `large`, `xlarge`, `xxlarge`. > > **mediaTextIntro** `string` > > Optional short sentence under the heading. > > **mediaTextIntroColor** `string | null` > > Optional — leave empty to use the muted text color. > > **mediaTextIntroColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **mediaTextIntroWeight** `MediaTextIntroWeight | null` > > Intro weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **mediaTextIntroSize** `MediaTextIntroSize | null` > > Intro size. One of `small`, `normal`, `large`, `xlarge`, `xxlarge`. > > **mediaTextAlign** `MediaTextAlign | null` > > Aligns the section header and the text inside each block. (Side-by-side rows usually read best left-aligned.) One of `left`, `center`. > > **mediaTextRatio** `MediaTextRatio | null` > > For media-left / media-right rows: how the two columns share the width. One of `balanced`, `media`, `text`. > > **mediaTextVAlign** `MediaTextVAlign | null` > > For media-left / media-right rows: how the text lines up against the media. One of `center`, `top`. > > **mediaTextMediaRatio** `MediaTextMediaRatio | null` > > Aspect ratio of the media frame. Auto keeps an image at its natural shape (videos and embeds always use a ratio). One of `auto`, `landscape`, `standard`, `square`, `portrait`, `wide`. > > **mediaTextMediaRadius** `MediaTextMediaRadius | null` > > Media corners. One of `large`, `rounded`, `slight`, `square`. > > **mediaTextGap** `MediaTextGap | null` > > Gap between blocks. One of `tight`, `normal`, `roomy`. > > **mediaTextDividers** `boolean` > > A hairline rule between blocks. > > **mediaTextBlockEyebrowColor** `string | null` > > Each block’s eyebrow color. Leave empty to use the secondary (mint) color. > > **mediaTextBlockEyebrowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **mediaTextBlockEyebrowWeight** `MediaTextBlockEyebrowWeight | null` > > Block eyebrow weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **mediaTextBlockHeadingColor** `string | null` > > Optional — leave empty to track the theme text color. > > **mediaTextBlockHeadingColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **mediaTextBlockHeadingWeight** `MediaTextBlockHeadingWeight | null` > > Block heading weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **mediaTextBlockHeadingSize** `MediaTextBlockHeadingSize | null` > > Block heading size. One of `small`, `normal`, `large`, `xlarge`, `xxlarge`. > > **mediaTextBodyColor** `string | null` > > Optional — leave empty to use the muted text color. > > **mediaTextBodyColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **mediaTextBodyWeight** `MediaTextBodyWeight | null` > > Block body weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **mediaTextBodySize** `MediaTextBodySize | null` > > Block body size. One of `small`, `normal`, `large`, `xlarge`, `xxlarge`. > > **mediaTextBlocks** `readonly MediaTextWidgetMediaTextBlocksItem[]` > > A list of `MediaTextWidgetMediaTextBlocksItem`. Each block is one media + text row. They render top to bottom in this order; alternate “Media left” / “Media right” for a classic zig-zag. > > **MediaTextWidgetMediaTextBlocksItem** > > **id** `string` > > The row’s id, unique in its array. > > **layout** `Layout | null` > > Media left / right place the media beside the text; Stacked puts media above the text; Full-bleed runs the media edge-to-edge with the text below. One of `media-left`, `media-right`, `stacked`, `full`. > > **mediaType** `MediaTextWidgetMediaTextBlocksItemMediaType | null` > > Pick where the media comes from. “None” makes this a text-only block. One of `image`, `video`, `embed`, `none`. > > **image** `readonly Readonly\\>[]` > > Pick an image from the Images library. The related `@apostrophecms/image` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document (one at most); a document the site can’t find is left out. At most 1 items. > > **imageAlt** `string` > > Describe the image for screen readers and SEO. Leave empty to use the library image’s own alt text. Set to a single space for a purely decorative image. > > **video** `readonly Readonly\\>[]` > > Pick a clip from the Videos library (⌘K → Videos). The related `video` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document (one at most); a document the site can’t find is left out. At most 1 items. > > **videoAutoplay** `boolean` > > Play automatically as a muted, looping background clip (a pause button is shown, and reduced-motion visitors get the poster image). Off = a normal video with play controls. > > **embedUrl** `string` > > Paste a YouTube or Vimeo link, e.g. [https://youtu.be/…](https://youtu.be/…) or [https://vimeo.com/…](https://vimeo.com/…). > > **eyebrow** `string` > > A small label above the block heading. > > **heading** `string` > > The block’s headline. > > **body** `string` > > A paragraph or two. Leave a blank line between paragraphs. > > **ctaLabel** `string` > > This block’s button text. Leave empty (with no link) to hide the button. > > **ctaUrl** `string` > > Where the button goes — a path (/about-us) or full URL. > > **ctaNewTab** `boolean` > > Open button in new tab. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **mediaTextBg** `MediaTextBg | null` > > The section’s full-width background band in dark mode. Transparent lets the page background show through. The palette options track the site colors; choose “Custom color…” for a specific color. One of `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`. > > **mediaTextBgCustom** `string | null` > > Used when “Section background (dark theme)” is set to Custom color. > > **mediaTextBgLight** `MediaTextBgLight | null` > > “Match dark theme” reuses the dark-theme choice; otherwise set the light-mode band independently. One of `inherit`, `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`. > > **mediaTextBgLightCustom** `string | null` > > Used when “Section background (light theme)” is set to Custom color. > > **mediaTextFontOverrides** `readonly MediaTextWidgetMediaTextFontOverridesItem[]` > > A list of `MediaTextWidgetMediaTextFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. > > **MediaTextWidgetMediaTextFontOverridesItem** > > **id** `string` > > The row’s id, unique in its array. > > **target** `Target | null` > > Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`. > > **source** `Source | null` > > Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`. > > **slot** `Slot | null` > > Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`. > > **curated** `Curated | null` > > Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`. > > **cdnProvider** `CdnProvider | null` > > Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`. > > **cdnFamily** `string` > > Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. > > **cdnWeights** `string` > > Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. > > **uploads** `readonly MediaTextWidgetMediaTextFontOverridesItemUploadsItem[]` > > A list of `MediaTextWidgetMediaTextFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. > > **MediaTextWidgetMediaTextFontOverridesItemUploadsItem** > > **file** `Readonly\\>` *required* > > **Required.** File attachment reference. > > **id** `string` > > The row’s id, unique in its array. > > **weight** `Weight | null` > > Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`. > > **style** `Style | null` > > Style. One of `normal`, `italic`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **fallback** `Fallback | null` > > Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **mediaTextCtaVariant** `MediaTextCtaVariant | null` > > Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`. > > **mediaTextCtaSize** `MediaTextCtaSize | null` > > Button size. One of `small`, `normal`, `large`. > > **mediaTextCtaRadius** `MediaTextCtaRadius | null` > > Corner radius. One of `pill`, `rounded`, `slight`, `square`. > > **mediaTextCtaColor** `string | null` > > Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. > > **mediaTextCtaColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) > > **mediaTextCtaTextColor** `string | null` > > The text/icon color. Clear it to derive from the button color (readable on solid fills). > > **mediaTextCtaTextColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme label color. > > **mediaTextCtaHoverColor** `string | null` > > Optional. Drives the hover treatment. Leave empty to derive it from the button color. > > **mediaTextCtaHoverColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme hover color. > > **mediaTextCtaStyle** `MediaTextCtaStyle | null` > > The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`. > > **mediaTextCtaShadowColor** `string | null` > > Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. > > **mediaTextCtaShadowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme shadow color. > > **mediaTextCtaAnimation** `MediaTextCtaAnimation | null` > > Hover motion. One of `lift`, `scale`, `lift-scale`, `none`. > > **mediaTextCtaIcon** `string` > > Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. > > **mediaTextCtaIconFamily** `MediaTextCtaIconFamily | null` > > Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`. > > **mediaTextCtaIconPosition** `MediaTextCtaIconPosition | null` > > Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`. > > **mediaTextCtaIconNudge** `boolean` > > The icon slides toward its side on hover (e.g. an arrow edges outward). > > **sectionCss** `CustomCSS | null` > > A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **DeviceMockWidget** > > A `device-mock` widget: its `type` and its own fields. A field left out takes its default. > > **type** `DeviceMockWidgetType` *required* > > **Required.** The widget’s type: always `device-mock`. One of `device-mock`. > > **id** `string` > > The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. > > **metaType** `MetaType` > > Always `widget`. One of `widget`. > > **deviceMockArrangement** `DeviceMockArrangement | null` > > Which devices to show. Duo overlaps a phone on the corner of a desktop browser; Trio adds a TV behind them (on narrow screens Trio drops the TV and shows as a Duo). Each device used gets its own screen tab. One of `duo`, `trio`, `desktop`, `phone`, `tv`. > > **deviceMockTextPlacement** `DeviceMockTextPlacement | null` > > Where the eyebrow / heading / intro / button sit. Left or right puts the text in a column beside the devices (stacked above them on narrow screens); None shows the devices only. One of `above`, `left`, `right`, `none`. > > **deviceMockSize** `DeviceMockSize | null` > > How large the devices render within the section. One of `compact`, `normal`, `large`. > > **deviceMockBrowserRatio** `DeviceMockBrowserRatio | null` > > The browser window’s content area. Match your desktop captures. One of `16:10`, `16:9`. > > **deviceMockBrowserUrl** `string` > > The address shown in the browser toolbar — decoration only, not a link. > > **deviceMockPhoneStatusBar** `boolean` > > Adds a time / signal / battery bar across the top of the phone screen. Leave off for native phone screenshots — they already include the real status bar. > > **deviceMockPhoneTime** `string` > > Status bar time. > > **deviceMockMotionPause** `boolean` > > Adds a small, unobtrusive pause/play control so visitors can stop the auto-playing background motion (WCAG 2.2.2). Only appears when a moving background is set. > > **deviceMockEyebrowEnabled** `boolean` > > A small label above the heading (e.g. "Product tour"). > > **deviceMockEyebrow** `string` > > Small label shown above the title. > > **deviceMockEyebrowColor** `string | null` > > Optional. Overrides the eyebrow + its dash. Leave empty to use the secondary (mint) color. > > **deviceMockEyebrowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color, then the mint default. > > **deviceMockEyebrowWeight** `DeviceMockEyebrowWeight | null` > > Eyebrow weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **deviceMockEyebrowSize** `DeviceMockEyebrowSize | null` > > Eyebrow size. One of `small`, `normal`, `large`, `xlarge`. > > **deviceMockHeading** `string` > > Optional. Leave empty to show just the devices. > > **deviceMockHeadingColor** `string | null` > > Optional — leave empty to track the theme text color. > > **deviceMockHeadingColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **deviceMockHeadingWeight** `DeviceMockHeadingWeight | null` > > Heading weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **deviceMockHeadingSize** `DeviceMockHeadingSize | null` > > Heading size. One of `small`, `normal`, `large`, `xlarge`, `xxlarge`. > > **deviceMockIntro** `string` > > Optional short paragraph under the heading. > > **deviceMockIntroColor** `string | null` > > Optional — leave empty to use the muted text color. > > **deviceMockIntroColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **deviceMockIntroWeight** `DeviceMockIntroWeight | null` > > Intro weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **deviceMockIntroSize** `DeviceMockIntroSize | null` > > Intro size. One of `small`, `normal`, `large`, `xlarge`, `xxlarge`. > > **deviceMockCaption** `string` > > A short line shown under the devices. > > **deviceMockTvMediaType** `DeviceMockTvMediaType | null` > > A still screenshot, or a short looping screen recording. One of `image`, `video`. > > **deviceMockTvImage** `readonly Readonly\\>[]` > > Use a native-resolution 16:9 capture of the screen with NO device frame (the frame is drawn for you) — e.g. 1920 × 1080 or 3840 × 2160. The related `@apostrophecms/image` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document (one at most); a document the site can’t find is left out. At most 1 items. > > **deviceMockTvImageAlt** `string` > > Required once a screenshot is picked. Describe what the screen shows for visitors who can’t see it — e.g. “Dashboard with a weekly activity chart and a list of recent orders”. Skip the device itself (“a phone showing…”); the frame is decorative. > > **deviceMockTvVideo** `readonly Readonly\\>[]` > > Pick a clip from the Videos library (⌘K → Videos). It plays as a short, muted, looping screen recording — keep it SHORT (about 5–15 seconds) and SMALL (under about 10 MB; an H.264 MP4 without an audio track is ideal), and give the Videos item a poster image: visitors see the poster first, and reduced-motion visitors only ever see the poster. Use a native-resolution 16:9 capture of the screen with NO device frame (the frame is drawn for you) — e.g. 1920 × 1080 or 3840 × 2160. The related `video` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document (one at most); a document the site can’t find is left out. At most 1 items. > > **deviceMockTvVideoAlt** `string` > > Recommended. A short description of what the recording shows, read to screen-reader users — e.g. “Creating a new project in three clicks”. Leave empty only if the surrounding text already says it. > > **deviceMockTvFit** `DeviceMockTvFit | null` > > Fill crops the media to fill the whole screen (best for native captures). Fit shows the whole image or video, leaving bars if its shape differs from the screen. One of `cover`, `contain`. > > **deviceMockTvAnchor** `DeviceMockTvAnchor | null` > > Which part stays visible when the media is cropped. Top keeps an app’s header in view — right for most screenshots. One of `top`, `center`, `bottom`. > > **deviceMockDesktopMediaType** `DeviceMockDesktopMediaType | null` > > A still screenshot, or a short looping screen recording. One of `image`, `video`. > > **deviceMockDesktopImage** `readonly Readonly\\>[]` > > Use a native-resolution capture of the page content only — no browser toolbar and no device frame (both are drawn for you). 16:10 (e.g. 2880 × 1800) or 16:9 (e.g. 2560 × 1440), matching the “Desktop screen shape” setting. The related `@apostrophecms/image` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document (one at most); a document the site can’t find is left out. At most 1 items. > > **deviceMockDesktopImageAlt** `string` > > Required once a screenshot is picked. Describe what the screen shows for visitors who can’t see it — e.g. “Dashboard with a weekly activity chart and a list of recent orders”. Skip the device itself (“a phone showing…”); the frame is decorative. > > **deviceMockDesktopVideo** `readonly Readonly\\>[]` > > Pick a clip from the Videos library (⌘K → Videos). It plays as a short, muted, looping screen recording — keep it SHORT (about 5–15 seconds) and SMALL (under about 10 MB; an H.264 MP4 without an audio track is ideal), and give the Videos item a poster image: visitors see the poster first, and reduced-motion visitors only ever see the poster. Use a native-resolution capture of the page content only — no browser toolbar and no device frame (both are drawn for you). 16:10 (e.g. 2880 × 1800) or 16:9 (e.g. 2560 × 1440), matching the “Desktop screen shape” setting. The related `video` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document (one at most); a document the site can’t find is left out. At most 1 items. > > **deviceMockDesktopVideoAlt** `string` > > Recommended. A short description of what the recording shows, read to screen-reader users — e.g. “Creating a new project in three clicks”. Leave empty only if the surrounding text already says it. > > **deviceMockDesktopFit** `DeviceMockDesktopFit | null` > > Fill crops the media to fill the whole screen (best for native captures). Fit shows the whole image or video, leaving bars if its shape differs from the screen. One of `cover`, `contain`. > > **deviceMockDesktopAnchor** `DeviceMockDesktopAnchor | null` > > Which part stays visible when the media is cropped. Top keeps an app’s header in view — right for most screenshots. One of `top`, `center`, `bottom`. > > **deviceMockPhoneMediaType** `DeviceMockPhoneMediaType | null` > > A still screenshot, or a short looping screen recording. One of `image`, `video`. > > **deviceMockPhoneImage** `readonly Readonly\\>[]` > > Use a native-resolution portrait screenshot with NO device frame (the frame is drawn for you) — e.g. 1179 × 2556 or 1290 × 2796 (about 9:19.5). The related `@apostrophecms/image` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document (one at most); a document the site can’t find is left out. At most 1 items. > > **deviceMockPhoneImageAlt** `string` > > Required once a screenshot is picked. Describe what the screen shows for visitors who can’t see it — e.g. “Dashboard with a weekly activity chart and a list of recent orders”. Skip the device itself (“a phone showing…”); the frame is decorative. > > **deviceMockPhoneVideo** `readonly Readonly\\>[]` > > Pick a clip from the Videos library (⌘K → Videos). It plays as a short, muted, looping screen recording — keep it SHORT (about 5–15 seconds) and SMALL (under about 10 MB; an H.264 MP4 without an audio track is ideal), and give the Videos item a poster image: visitors see the poster first, and reduced-motion visitors only ever see the poster. Use a native-resolution portrait screenshot with NO device frame (the frame is drawn for you) — e.g. 1179 × 2556 or 1290 × 2796 (about 9:19.5). The related `video` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document (one at most); a document the site can’t find is left out. At most 1 items. > > **deviceMockPhoneVideoAlt** `string` > > Recommended. A short description of what the recording shows, read to screen-reader users — e.g. “Creating a new project in three clicks”. Leave empty only if the surrounding text already says it. > > **deviceMockPhoneFit** `DeviceMockPhoneFit | null` > > Fill crops the media to fill the whole screen (best for native captures). Fit shows the whole image or video, leaving bars if its shape differs from the screen. One of `cover`, `contain`. > > **deviceMockPhoneAnchor** `DeviceMockPhoneAnchor | null` > > Which part stays visible when the media is cropped. Top keeps an app’s header in view — right for most screenshots. One of `top`, `center`, `bottom`. > > **deviceMockBg** `DeviceMockBg | null` > > The section’s full-width background band in dark mode. Transparent lets the page background show through. The palette options track the site colors; choose “Custom color…” for a specific color. One of `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`. > > **deviceMockBgCustom** `string | null` > > Used when “Section background (dark theme)” is set to Custom color. > > **deviceMockBgLight** `DeviceMockBgLight | null` > > “Match dark theme” reuses the dark-theme choice; otherwise set the light-mode band independently. One of `inherit`, `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`. > > **deviceMockBgLightCustom** `string | null` > > Used when “Section background (light theme)” is set to Custom color. > > **deviceMockFontOverrides** `readonly DeviceMockWidgetDeviceMockFontOverridesItem[]` > > A list of `DeviceMockWidgetDeviceMockFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. > > **DeviceMockWidgetDeviceMockFontOverridesItem** > > **id** `string` > > The row’s id, unique in its array. > > **target** `Target | null` > > Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`. > > **source** `Source | null` > > Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`. > > **slot** `Slot | null` > > Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`. > > **curated** `Curated | null` > > Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`. > > **cdnProvider** `CdnProvider | null` > > Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`. > > **cdnFamily** `string` > > Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. > > **cdnWeights** `string` > > Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. > > **uploads** `readonly DeviceMockWidgetDeviceMockFontOverridesItemUploadsItem[]` > > A list of `DeviceMockWidgetDeviceMockFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. > > **DeviceMockWidgetDeviceMockFontOverridesItemUploadsItem** > > **file** `Readonly\\>` *required* > > **Required.** File attachment reference. > > **id** `string` > > The row’s id, unique in its array. > > **weight** `Weight | null` > > Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`. > > **style** `Style | null` > > Style. One of `normal`, `italic`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **fallback** `Fallback | null` > > Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **deviceMockCtaLabel** `string` > > The visible button text. Leave empty to hide the button. > > **deviceMockCtaUrl** `string` > > Where the button goes — a path (/blog) or full URL. > > **deviceMockCtaNewTab** `boolean` > > Opens the link in a new browser tab (adds rel="noopener noreferrer"). > > **deviceMockCtaVariant** `DeviceMockCtaVariant | null` > > Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`. > > **deviceMockCtaSize** `DeviceMockCtaSize | null` > > Button size. One of `small`, `normal`, `large`. > > **deviceMockCtaRadius** `DeviceMockCtaRadius | null` > > Corner radius. One of `pill`, `rounded`, `slight`, `square`. > > **deviceMockCtaColor** `string | null` > > Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. > > **deviceMockCtaColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) > > **deviceMockCtaTextColor** `string | null` > > The text/icon color. Clear it to derive from the button color (readable on solid fills). > > **deviceMockCtaTextColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme label color. > > **deviceMockCtaHoverColor** `string | null` > > Optional. Drives the hover treatment. Leave empty to derive it from the button color. > > **deviceMockCtaHoverColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme hover color. > > **deviceMockCtaStyle** `DeviceMockCtaStyle | null` > > The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`. > > **deviceMockCtaShadowColor** `string | null` > > Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. > > **deviceMockCtaShadowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme shadow color. > > **deviceMockCtaAnimation** `DeviceMockCtaAnimation | null` > > Hover motion. One of `lift`, `scale`, `lift-scale`, `none`. > > **deviceMockCtaIcon** `string` > > Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. > > **deviceMockCtaIconFamily** `DeviceMockCtaIconFamily | null` > > Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`. > > **deviceMockCtaIconPosition** `DeviceMockCtaIconPosition | null` > > Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`. > > **deviceMockCtaIconNudge** `boolean` > > The icon slides toward its side on hover (e.g. an arrow edges outward). > > **sectionCss** `CustomCSS | null` > > A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **TeamWidget** > > A `team` widget: its `type` and its own fields. A field left out takes its default. > > **type** `TeamWidgetType` *required* > > **Required.** The widget’s type: always `team`. One of `team`. > > **id** `string` > > The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. > > **metaType** `MetaType` > > Always `widget`. One of `widget`. > > **teamEyebrow** `string` > > Small label shown above the title. > > **teamEyebrowColor** `string | null` > > Optional. Overrides the eyebrow + its dash. Leave empty to use the secondary (mint) color. > > **teamEyebrowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color, then the mint default. > > **teamEyebrowWeight** `TeamEyebrowWeight | null` > > Eyebrow weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **teamEyebrowSize** `TeamEyebrowSize | null` > > Eyebrow size. One of `small`, `normal`, `large`, `xlarge`. > > **teamHeading** `string` > > Optional. Leave empty to show just the team. > > **teamHeadingColor** `string | null` > > Optional — leave empty to track the theme text color. > > **teamHeadingColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **teamHeadingWeight** `TeamHeadingWeight | null` > > Heading weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **teamIntro** `string` > > Optional short sentence under the heading. > > **teamIntroColor** `string | null` > > Optional — leave empty to use the muted text color. > > **teamIntroColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **teamIntroWeight** `TeamIntroWeight | null` > > Intro weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **teamIntroSize** `TeamIntroSize | null` > > Intro size. One of `small`, `normal`, `large`, `xlarge`. > > **teamAlign** `TeamAlign | null` > > Header alignment. One of `center`, `left`. > > **teamFeaturedOnly** `boolean` > > Show only members you have flagged “Featured” in the Team Members manager — e.g. a short leadership row on the home page. > > **teamCount** `number | null` > > The most members to show, in the manager’s sort order. 1 to 50. > > **teamLayout** `TeamLayout | null` > > Grid: a tidy multi-row grid (the full team page). Carousel: a continuous auto-scrolling marquee (needs site animations enabled — falls back to the grid when they are off). Spotlight: featured members large on top, the rest in a smaller grid. List: wide rows with the full bio. Scatter: a playful arrangement with varied spacing so the cards float freely. One of `grid`, `carousel`, `spotlight`, `list`, `scatter`. > > **teamColumns** `TeamColumns | null` > > How many cards per row. Auto fits as many as comfortably fit (the Scatter layout composes on three columns when set to Auto). One of `auto`, `2`, `3`, `4`. > > **teamSpotlightHeroes** `TeamSpotlightHeroes | null` > > How many members lead the section at full size. Members flagged “Featured” fill the spots first, in the manager’s sort order; any extra featured members join the rows below. One of `1`, `2`. > > **teamSpotlightColumns** `TeamSpotlightColumns | null` > > How many of the remaining members sit on each row under the featured spots. One of `2`, `3`, `4`, `5`. > > **teamSpeed** `TeamSpeed | null` > > How fast the carousel auto-scrolls. One of `vslow`, `slow`, `normal`, `fast`. > > **teamDirection** `TeamDirection | null` > > Scroll direction. One of `left`, `right`. > > **teamScatter** `TeamScatter | null` > > How far the cards drift from a tidy grid. Subtle keeps a loose grid; Wild pushes the offsets to their playful maximum. One of `subtle`, `playful`, `wild`. > > **teamGap** `TeamGap | null` > > Gap between cards. One of `tight`, `normal`, `roomy`. > > **teamCardLayout** `TeamCardLayout | null` > > Portrait: the photo on top, name/role/bio below — the classic team card. Overlay: a full-bleed photo with a solid color panel over its lower edge holding the name and role. Profile: a horizontal bar — avatar left, name/role/tagline right. Roster: minimal — just the avatar, name and role. (The List section layout always uses its own wide row.) One of `portrait`, `overlay`, `profile`, `roster`. > > **teamPhotoAspect** `TeamPhotoAspect | null` > > The photo’s aspect ratio on the photo-led card layouts. One of `square`, `portrait`, `tall`. > > **teamAvatarShape** `TeamAvatarShape | null` > > The photo’s outline. Squircle is a soft superellipse-style corner (approximated with heavy rounding). One of `circle`, `rounded`, `squircle`, `square`. > > **teamAvatarSize** `TeamAvatarSize | null` > > Avatar size. One of `small`, `medium`, `large`, `xlarge`. > > **teamAvatarBorder** `TeamAvatarBorder | null` > > A ring around the photo in the avatar color. One of `none`, `hairline`, `thin`, `bold`. > > **teamAvatarTreatment** `TeamAvatarTreatment | null` > > A flat color accent behind the photo. Panel offsets a solid block behind it; Halo draws a soft concentric disc. Both use the avatar color. One of `none`, `panel`, `halo`. > > **teamAvatarColor** `string | null` > > Colors the border and the backdrop treatment. Leave empty to use the brand accent. > > **teamAvatarColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **teamShowRole** `boolean` > > Show role / title. > > **teamShowBio** `boolean` > > Shown on the Portrait and Profile cards and the List rows. The Overlay and Roster layouts stay bio-free by design. > > **teamShowTagline** `boolean` > > The member’s one-liner, shown on the Profile and Roster cards and the List rows. > > **teamHoverPhoto** `boolean` > > Cross-fades to a member’s alternate photo on hover (set per member; does nothing for members without one, and stays off for visitors who prefer reduced motion). > > **teamCardStyle** `TeamCardStyle | null` > > The card treatment. Outline (the default) is a plaque frame — a framed-portrait look; Raised is a quiet lit card; Luxe a frosted glass panel; Ticket/Bracket/Inlay are the graphic showstoppers. One of `raised`, `luxe`, `outline`, `plain`, `poster`, `edge`, `tint`, `ticket`, `bracket`, `inlay`. > > **teamCardStyleRadius** `TeamCardStyleRadius | null` > > Corner rounding for each card. Default keeps the widget’s own tuned corners — except Forge, which defaults to tight machined corners matching its engraved frame. One of `default`, `square`, `slight`, `rounded`, `large`. > > **teamCardStyleAccentColor** `string | null` > > Colors the Spine rail, Bracket marks, Forge corner/frame and Press margin rule. Leave empty to use the brand accent. > > **teamCardStyleAccentColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **teamCardHover** `TeamCardHover | null` > > What a card does on hover. Lift/Pop/Press/Glow/Outline are instant; Sheen sweeps a light across; Tilt, Magnetic and Spotlight follow the cursor (need site animations on). Vary it per section so the page is not cookie-cutter. One of `none`, `lift`, `pop`, `press`, `glow`, `border`, `sheen`, `tilt`, `magnetic`, `spotlight`. > > **teamCardAlign** `TeamCardAlign | null` > > How the name, role and bio align inside each card (the Profile card and List rows are always left-aligned beside the avatar). One of `center`, `left`. > > **teamAccentColor** `string | null` > > Optional — the lettered-avatar fallback background and the role color default. Leave empty to use the brand accent. (The icon row has its own colors on the Social links tab.) > > **teamAccentColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **teamPanelColor** `string | null` > > The solid panel over the photo on the Overlay card. Leave empty to use the card color. > > **teamPanelColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **teamNameSize** `TeamNameSize | null` > > Name size. One of `small`, `normal`, `large`, `xlarge`. > > **teamNameWeight** `TeamNameWeight | null` > > Name weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **teamNameColor** `string | null` > > Optional — leave empty to track the theme text color. > > **teamNameColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **teamRoleSize** `TeamRoleSize | null` > > Role size. One of `small`, `normal`, `large`, `xlarge`. > > **teamRoleWeight** `TeamRoleWeight | null` > > Role weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **teamRoleColor** `string | null` > > Optional — leave empty to use the accent color. > > **teamRoleColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **teamBioSize** `TeamBioSize | null` > > Bio size. One of `small`, `normal`, `large`, `xlarge`. > > **teamBioWeight** `TeamBioWeight | null` > > Bio weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **teamBioColor** `string | null` > > Optional — leave empty to use the muted text color. > > **teamBioColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **teamBioClamp** `TeamBioClamp | null` > > Cap each bio at this many lines (the rest is truncated with an ellipsis) so one long bio can’t blow up the card height. The List layout always shows the full bio. One of `none`, `2`, `3`, `4`, `6`. > > **teamTaglineColor** `string | null` > > Optional — leave empty to use the faint text color. > > **teamTaglineColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **teamShowSocials** `boolean` > > The member’s social profile icons (set per member in the Team Members manager). > > **teamShowContact** `boolean` > > Off by default — turns each member’s email and phone (when set) into icon links. Only enable when you want those details public. > > **teamSocialVariant** `TeamSocialVariant | null` > > Icon style. One of `bare`, `outline`, `solid`. > > **teamSocialSize** `TeamSocialSize | null` > > Icon size. One of `small`, `normal`, `large`, `xlarge`. > > **teamSocialSpacing** `TeamSocialSpacing | null` > > Gap between the icons. One of `tight`, `normal`, `loose`. > > **teamSocialHover** `TeamSocialHover | null` > > Hover to each platform’s own brand color, or to the site accent (or a chosen hover color). One of `brand`, `accent`. > > **teamSocialColor** `string | null` > > Resting icon color. Leave empty for the muted default. > > **teamSocialColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color, then the muted default. > > **teamSocialHoverColor** `string | null` > > Used when “Hover color” is Accent / custom. Leave empty for the site accent. > > **teamSocialHoverColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color, then the accent. > > **teamBg** `TeamBg | null` > > The section’s full-width background band in dark mode. Transparent lets the page background show through. The palette options track the site colors; choose “Custom color…” for a specific color. One of `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`. > > **teamBgCustom** `string | null` > > Used when “Section background (dark theme)” is set to Custom color. > > **teamBgLight** `TeamBgLight | null` > > “Match dark theme” reuses the dark-theme choice; otherwise set the light-mode band independently. One of `inherit`, `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`. > > **teamBgLightCustom** `string | null` > > Used when “Section background (light theme)” is set to Custom color. > > **teamFontOverrides** `readonly TeamWidgetTeamFontOverridesItem[]` > > A list of `TeamWidgetTeamFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. > > **TeamWidgetTeamFontOverridesItem** > > **id** `string` > > The row’s id, unique in its array. > > **target** `Target | null` > > Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`. > > **source** `Source | null` > > Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`. > > **slot** `Slot | null` > > Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`. > > **curated** `Curated | null` > > Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`. > > **cdnProvider** `CdnProvider | null` > > Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`. > > **cdnFamily** `string` > > Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. > > **cdnWeights** `string` > > Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. > > **uploads** `readonly TeamWidgetTeamFontOverridesItemUploadsItem[]` > > A list of `TeamWidgetTeamFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. > > **TeamWidgetTeamFontOverridesItemUploadsItem** > > **file** `Readonly\\>` *required* > > **Required.** File attachment reference. > > **id** `string` > > The row’s id, unique in its array. > > **weight** `Weight | null` > > Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`. > > **style** `Style | null` > > Style. One of `normal`, `italic`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **fallback** `Fallback | null` > > Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **teamCtaLabel** `string` > > The visible button text. Leave empty to hide the button. > > **teamCtaUrl** `string` > > Where the button goes — a path (/blog) or full URL. > > **teamCtaNewTab** `boolean` > > Opens the link in a new browser tab (adds rel="noopener noreferrer"). > > **teamCtaVariant** `TeamCtaVariant | null` > > Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`. > > **teamCtaSize** `TeamCtaSize | null` > > Button size. One of `small`, `normal`, `large`. > > **teamCtaRadius** `TeamCtaRadius | null` > > Corner radius. One of `pill`, `rounded`, `slight`, `square`. > > **teamCtaColor** `string | null` > > Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. > > **teamCtaColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) > > **teamCtaTextColor** `string | null` > > The text/icon color. Clear it to derive from the button color (readable on solid fills). > > **teamCtaTextColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme label color. > > **teamCtaHoverColor** `string | null` > > Optional. Drives the hover treatment. Leave empty to derive it from the button color. > > **teamCtaHoverColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme hover color. > > **teamCtaStyle** `TeamCtaStyle | null` > > The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`. > > **teamCtaShadowColor** `string | null` > > Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. > > **teamCtaShadowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme shadow color. > > **teamCtaAnimation** `TeamCtaAnimation | null` > > Hover motion. One of `lift`, `scale`, `lift-scale`, `none`. > > **teamCtaIcon** `string` > > Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. > > **teamCtaIconFamily** `TeamCtaIconFamily | null` > > Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`. > > **teamCtaIconPosition** `TeamCtaIconPosition | null` > > Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`. > > **teamCtaIconNudge** `boolean` > > The icon slides toward its side on hover (e.g. an arrow edges outward). > > **sectionCss** `CustomCSS | null` > > A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **FaqWidget** > > A `faq` widget: its `type` and its own fields. A field left out takes its default. > > **type** `FaqWidgetType` *required* > > **Required.** The widget’s type: always `faq`. One of `faq`. > > **id** `string` > > The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. > > **metaType** `MetaType` > > Always `widget`. One of `widget`. > > **faqEyebrow** `string` > > Small label shown above the title. > > **faqEyebrowColor** `string | null` > > Optional. Overrides the eyebrow + its dash. Leave empty to use the secondary (mint) color. > > **faqEyebrowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color, then the mint default. > > **faqEyebrowWeight** `FaqEyebrowWeight | null` > > Eyebrow weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **faqEyebrowSize** `FaqEyebrowSize | null` > > Eyebrow size. One of `small`, `normal`, `large`, `xlarge`. > > **faqHeading** `string` > > Optional. Leave empty to show just the questions. > > **faqHeadingColor** `string | null` > > Optional — leave empty to track the theme text color. > > **faqHeadingColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **faqHeadingWeight** `FaqHeadingWeight | null` > > Heading weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **faqIntro** `string` > > Optional short sentence under the heading. > > **faqIntroColor** `string | null` > > Optional — leave empty to use the muted text color. > > **faqIntroColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **faqIntroWeight** `FaqIntroWeight | null` > > Intro weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **faqIntroSize** `FaqIntroSize | null` > > Intro size. One of `small`, `normal`, `large`, `xlarge`. > > **faqAlign** `FaqAlign | null` > > The Split layout always sets its header column left. One of `center`, `left`. > > **faqFeaturedOnly** `boolean` > > Show only questions you have flagged “Featured” in the FAQs manager — e.g. a short top-questions block on the home page, linking out to the full FAQ page. > > **faqCount** `number | null` > > The most questions to show, in the manager’s sort order. Raise it for a full FAQ page. 1 to 50. > > **faqCategories** `readonly Readonly\\>[]` > > Optional filter. Leave empty to show questions from every category. Manage the list under FAQ Categories. The related `faq-category` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document; a document the site can’t find is left out. > > **faqGroupBy** `FaqGroupBy | null` > > By category renders a subheading per FAQ category, in the order picked in the category filter (or, with no filter, the FAQ Categories sort order); questions without a category are listed last. One of `none`, `category`. > > **faqLayout** `FaqLayout | null` > > Accordion: a single centered column of collapsing questions — the classic FAQ. Split: the header (and button) sit in a left column with the accordion beside them. Two columns: the accordion flows across two columns. Open panels: every answer visible in a card grid — no collapsing. One of `accordion`, `split`, `columns`, `panels`. > > **faqPanelColumns** `FaqPanelColumns | null` > > How many open panels sit per row (they stack on small screens). One of `1`, `2`, `3`. > > **faqOpenMode** `FaqOpenMode | null` > > One at a time closes the previous answer when a new one opens; Independent lets visitors hold several open. One of `single`, `multiple`. > > **faqFirstOpen** `boolean` > > Starts the section with the first answer expanded so the block never reads as an empty list of rows. > > **faqMarker** `FaqMarker | null` > > The disclosure marker on each question. Plus rotates into a close mark; Chevron flips. One of `plus`, `chevron`. > > **faqGap** `FaqGap | null` > > Space between questions. One of `tight`, `normal`, `roomy`. > > **faqSchema** `boolean` > > Adds this section’s questions to the page’s schema.org FAQPage markup so search engines can read them (all FAQ sections on a page share one FAQPage block). Costs nothing when on; turn off only to exclude these questions. > > **faqCardStyle** `FaqCardStyle | null` > > The question-row treatment. Plain (the default) is the classic divided list — hairlines between questions. Any other style turns each question into a card: Raised is a quiet lit card, Outline a framed row, Luxe frosted glass; Ticket/Bracket/Inlay are the graphic showstoppers. One of `raised`, `luxe`, `outline`, `plain`, `poster`, `edge`, `tint`, `ticket`, `bracket`, `forge`, `press`, `inlay`. > > **faqCardStyleRadius** `FaqCardStyleRadius | null` > > Corner rounding for each card. Default keeps the widget’s own tuned corners — except Forge, which defaults to tight machined corners matching its engraved frame. One of `default`, `square`, `slight`, `rounded`, `large`. > > **faqCardStyleAccentColor** `string | null` > > Colors the Spine rail, Bracket marks, Forge corner/frame and Press margin rule. Leave empty to use the brand accent. > > **faqCardStyleAccentColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **faqCardStyleForgeScope** `FaqCardStyleForgeScope | null` > > Where the Forge plate wears its color: a single corner mark (the machinist’s datum, default) or the whole engraved frame. One of `corner`, `frame`. > > **faqCardStyleForgeWeight** `FaqCardStyleForgeWeight | null` > > Thickness of the Forge corner mark / colored frame. One of `fine`, `medium`, `bold`. > > **faqCardHover** `FaqCardHover | null` > > What a question row does on hover. None (the default) keeps the accordion calm — the open/close motion is the interaction. The card effects (Lift/Glow/…) suit the card styles; the cursor-tracked ones need site animations on. One of `none`, `lift`, `pop`, `press`, `glow`, `border`, `sheen`, `tilt`, `magnetic`, `spotlight`. > > **faqAccentColor** `string | null` > > Optional — colors the toggle icon and the open question’s highlight. Leave empty to use the brand accent. > > **faqAccentColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **faqQuestionSize** `FaqQuestionSize | null` > > Question size. One of `small`, `normal`, `large`, `xlarge`. > > **faqQuestionWeight** `FaqQuestionWeight | null` > > Question weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **faqQuestionColor** `string | null` > > Optional — leave empty to track the theme text color. > > **faqQuestionColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **faqAnswerSize** `FaqAnswerSize | null` > > Answer size. One of `small`, `normal`, `large`, `xlarge`. > > **faqAnswerWeight** `FaqAnswerWeight | null` > > Answer weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **faqAnswerColor** `string | null` > > Optional — leave empty to use the muted text color. > > **faqAnswerColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **faqGroupHeadingWeight** `FaqGroupHeadingWeight | null` > > Category heading weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **faqGroupHeadingColor** `string | null` > > Optional — leave empty to track the theme text color. > > **faqGroupHeadingColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **faqBg** `FaqBg | null` > > The section’s full-width background band in dark mode. Transparent lets the page background show through. The palette options track the site colors; choose “Custom color…” for a specific color. One of `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`. > > **faqBgCustom** `string | null` > > Used when “Section background (dark theme)” is set to Custom color. > > **faqBgLight** `FaqBgLight | null` > > “Match dark theme” reuses the dark-theme choice; otherwise set the light-mode band independently. One of `inherit`, `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`. > > **faqBgLightCustom** `string | null` > > Used when “Section background (light theme)” is set to Custom color. > > **faqFontOverrides** `readonly FaqWidgetFaqFontOverridesItem[]` > > A list of `FaqWidgetFaqFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. > > **FaqWidgetFaqFontOverridesItem** > > **id** `string` > > The row’s id, unique in its array. > > **target** `Target | null` > > Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`. > > **source** `Source | null` > > Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`. > > **slot** `Slot | null` > > Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`. > > **curated** `Curated | null` > > Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`. > > **cdnProvider** `CdnProvider | null` > > Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`. > > **cdnFamily** `string` > > Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. > > **cdnWeights** `string` > > Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. > > **uploads** `readonly FaqWidgetFaqFontOverridesItemUploadsItem[]` > > A list of `FaqWidgetFaqFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. > > **FaqWidgetFaqFontOverridesItemUploadsItem** > > **file** `Readonly\\>` *required* > > **Required.** File attachment reference. > > **id** `string` > > The row’s id, unique in its array. > > **weight** `Weight | null` > > Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`. > > **style** `Style | null` > > Style. One of `normal`, `italic`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **fallback** `Fallback | null` > > Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **faqCtaLabel** `string` > > The visible button text. Leave empty to hide the button. > > **faqCtaUrl** `string` > > Where the button goes — a path (/blog) or full URL. > > **faqCtaNewTab** `boolean` > > Opens the link in a new browser tab (adds rel="noopener noreferrer"). > > **faqCtaVariant** `FaqCtaVariant | null` > > Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`. > > **faqCtaSize** `FaqCtaSize | null` > > Button size. One of `small`, `normal`, `large`. > > **faqCtaRadius** `FaqCtaRadius | null` > > Corner radius. One of `pill`, `rounded`, `slight`, `square`. > > **faqCtaColor** `string | null` > > Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. > > **faqCtaColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) > > **faqCtaTextColor** `string | null` > > The text/icon color. Clear it to derive from the button color (readable on solid fills). > > **faqCtaTextColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme label color. > > **faqCtaHoverColor** `string | null` > > Optional. Drives the hover treatment. Leave empty to derive it from the button color. > > **faqCtaHoverColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme hover color. > > **faqCtaStyle** `FaqCtaStyle | null` > > The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`. > > **faqCtaShadowColor** `string | null` > > Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. > > **faqCtaShadowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme shadow color. > > **faqCtaAnimation** `FaqCtaAnimation | null` > > Hover motion. One of `lift`, `scale`, `lift-scale`, `none`. > > **faqCtaIcon** `string` > > Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. > > **faqCtaIconFamily** `FaqCtaIconFamily | null` > > Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`. > > **faqCtaIconPosition** `FaqCtaIconPosition | null` > > Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`. > > **faqCtaIconNudge** `boolean` > > The icon slides toward its side on hover (e.g. an arrow edges outward). > > **sectionCss** `CustomCSS | null` > > A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **ServiceMapWidget** > > A `service-map` widget: its `type` and its own fields. A field left out takes its default. > > **type** `ServiceMapWidgetType` *required* > > **Required.** The widget’s type: always `service-map`. One of `service-map`. > > **id** `string` > > The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. > > **metaType** `MetaType` > > Always `widget`. One of `widget`. > > **serviceMapEyebrow** `string` > > Small label shown above the title. > > **serviceMapEyebrowColor** `string | null` > > Optional. Overrides the eyebrow + its dash. Leave empty to use the secondary (mint) color. > > **serviceMapEyebrowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color, then the mint default. > > **serviceMapEyebrowWeight** `ServiceMapEyebrowWeight | null` > > Eyebrow weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **serviceMapEyebrowSize** `ServiceMapEyebrowSize | null` > > Eyebrow size. One of `small`, `normal`, `large`, `xlarge`. > > **serviceMapHeading** `string` > > Heading. > > **serviceMapHeadingColor** `string | null` > > Optional. Leave empty for the standard ink color. > > **serviceMapHeadingColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **serviceMapHeadingWeight** `ServiceMapHeadingWeight | null` > > Heading weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **serviceMapIntro** `string` > > Optional short paragraph under the heading. The data source’s own description (service days etc.) shows in the result panel, not here. > > **serviceMapIntroSize** `ServiceMapIntroSize | null` > > Intro size. One of `small`, `normal`, `large`, `xlarge`. > > **serviceMapHeight** `ServiceMapHeight | null` > > Map height. One of `compact`, `standard`, `tall`. > > **serviceMapTheme** `ServiceMapTheme | null` > > Curated light/dark basemap pairs — each follows the visitor’s theme toggle. “Site palette” derives the basemap from this site’s own colors. One of `palette`, `classic`, `silver`, `retro`. > > **serviceMapFrameRadius** `ServiceMapFrameRadius | null` > > Map corner radius. One of `square`, `slight`, `rounded`, `large`. > > **serviceMapFrameBorderColor** `string | null` > > Optional. Leave empty for the standard hairline — set it to match a colored border on the zone cards. > > **serviceMapFrameBorderColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **serviceMapFrameGlowColor** `string | null` > > Optional soft glow around the map frame — pairs with a glowing zone-card style. Leave empty for none. > > **serviceMapFrameGlowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **serviceMapSchema** `boolean` > > On pages with this section, upgrades the business structured data from the compact site-wide form to the full detail: every public place name, every zip code, and area boundaries. Costs visitors nothing; turn off to keep this page at the compact site-wide form. (Requires structured data on in Site settings → SEO; demo map data is never published.) > > **serviceMapShowLegend** `boolean` > > The legend card overlaid on the map. The zone cards below the map always carry the same information for screen readers and when the map can’t load. > > **serviceMapKeySwatchSize** `ServiceMapKeySwatchSize | null` > > Key swatch size. One of `small`, `medium`, `large`. > > **serviceMapKeyJustify** `ServiceMapKeyJustify | null` > > Key text justification. One of `left`, `center`, `right`. > > **serviceMapKeyTextSize** `ServiceMapKeyTextSize | null` > > Key text size. One of `small`, `normal`, `large`, `xlarge`. > > **serviceMapKeyTextWeight** `ServiceMapKeyTextWeight | null` > > Key text weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **serviceMapKeyTextColor** `string | null` > > Optional. Leave empty for the standard ink color. > > **serviceMapKeyTextColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **serviceMapKeyRadius** `ServiceMapKeyRadius | null` > > Key corner radius. One of `square`, `slight`, `rounded`, `large`. > > **serviceMapKeyBorderColor** `string | null` > > Optional. Leave empty for the standard hairline — set it to match the map frame or the zone cards. > > **serviceMapKeyBorderColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **serviceMapKeyGlowColor** `string | null` > > Optional soft glow around the key card. Leave empty for none. > > **serviceMapKeyGlowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **serviceMapShowCards** `boolean` > > The zone/pricing cards under the map. Turning this off hides them visually — they stay in the page for screen readers and no-JavaScript visitors (the map itself isn’t accessible). > > **serviceMapCardStyle** `ServiceMapCardStyle | null` > > The card surface. Raised is a quiet lit card; Luxe is a frosted glass panel; Outline is a double-rule plaque frame; Plain has no chrome; Poster frames the card with an accent keyline; Spine embeds a color rail along the top; Tint washes the card in the accent color. Showstoppers: Ticket punches notches into the sides, Bracket draws only corner marks, Forge is a machined plate with an engraved frame, Press is a punched index card with a margin rule, Inlay recesses the content into a well. One of `raised`, `luxe`, `outline`, `plain`, `poster`, `edge`, `tint`, `inlay`. > > **serviceMapCardStyleRadius** `ServiceMapCardStyleRadius | null` > > Corner rounding for each card. Default keeps the widget’s own tuned corners — except Forge, which defaults to tight machined corners matching its engraved frame. One of `default`, `square`, `slight`, `rounded`, `large`. > > **serviceMapCardStyleAccentColor** `string | null` > > Colors the Spine rail, Bracket marks, Forge corner/frame and Press margin rule. Leave empty to use the brand accent. > > **serviceMapCardStyleAccentColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **serviceMapCardsHover** `ServiceMapCardsHover | null` > > What a card does on hover. Lift/Pop/Press/Glow/Outline are instant CSS effects; Sheen sweeps a soft light across; Tilt, Magnetic and Spotlight follow the cursor (these need site animations on — visitors who prefer reduced motion see the resting card). Pick a different one per section so a page feels varied, not cookie-cutter. One of `none`, `lift`, `pop`, `press`, `glow`, `border`, `sheen`, `tilt`, `magnetic`, `spotlight`. > > **serviceMapCardsSwatchSize** `ServiceMapCardsSwatchSize | null` > > Card swatch size. One of `small`, `medium`, `large`. > > **serviceMapCardsJustify** `ServiceMapCardsJustify | null` > > Card text justification. One of `left`, `center`, `right`. > > **serviceMapCardsNameWeight** `ServiceMapCardsNameWeight | null` > > Zone name weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **serviceMapCardsTextSize** `ServiceMapCardsTextSize | null` > > Card text size. One of `small`, `normal`, `large`, `xlarge`. > > **serviceMapCardsTextColor** `string | null` > > Optional. Colors the zone names; supporting copy stays muted. Leave empty for the standard ink color. > > **serviceMapCardsTextColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **serviceMapCardsSubSize** `ServiceMapCardsSubSize | null` > > The price and detail lines under each zone name — sized relative to the card text size. One of `small`, `normal`, `large`, `xlarge`. > > **serviceMapCardsSubWeight** `ServiceMapCardsSubWeight | null` > > Supporting text weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **serviceMapCardsSubColor** `string | null` > > Optional. Leave empty for the standard muted color. > > **serviceMapCardsSubColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **serviceMapIncludedLabel** `string` > > Optional label shown instead of “$0” wherever a zone has no fee (key, cards, results). Clear it to show the plain price — $0 doesn’t always mean included. > > **serviceMapZoneOverrides** `readonly ServiceMapWidgetServiceMapZoneOverridesItem[]` > > A list of `ServiceMapWidgetServiceMapZoneOverridesItem`. Per-zone display overrides, matched by the zone name the data source provides. Rename a zone, replace its price text, or hide it entirely — the underlying data is never changed. > > **ServiceMapWidgetServiceMapZoneOverridesItem** > > **zoneName** `string` *required* > > **Required.** Case-insensitive match against the zone name in the map data. > > **id** `string` > > The row’s id, unique in its array. > > **displayName** `string` > > Optional replacement name shown everywhere this zone appears. > > **priceLabel** `string` > > Optional replacement for the price text (e.g. “Included”, “Call us”). Overrides the zero-price label too. > > **hide** `boolean` > > The zone stays on the map and in search results — it just leaves the key and cards. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **serviceMapShowSearch** `boolean` > > Show the “check your area” search. > > **serviceMapSearchLabel** `string` > > Search label. > > **serviceMapSearchPlaceholder** `string` > > Search placeholder. > > **serviceMapSearchJustify** `ServiceMapSearchJustify | null` > > Positions the search box and button above the map. One of `left`, `center`, `right`. > > **serviceMapSearchInputRadius** `ServiceMapSearchInputRadius | null` > > Same radius scale as the buttons, so the box and button can match. One of `pill`, `rounded`, `slight`, `square`. > > **serviceMapAutocomplete** `boolean` > > Google address autocomplete under the search box (needs the Places API enabled on the key — see the setup guide in Connections → Google Maps). ZIP-only typing never triggers suggestions when the data source is zip-based. > > **serviceMapOutsideAreaText** `string` > > Shown when a searched location doesn’t fall in any zone (or the premium radius). > > **serviceMapSearchButtonText** `string` > > Leave empty for “Check”. The button’s look is configured in the Search button tab. > > **serviceMapSearchButtonVariant** `ServiceMapSearchButtonVariant | null` > > Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`. > > **serviceMapSearchButtonSize** `ServiceMapSearchButtonSize | null` > > Button size. One of `small`, `normal`, `large`. > > **serviceMapSearchButtonRadius** `ServiceMapSearchButtonRadius | null` > > Corner radius. One of `pill`, `rounded`, `slight`, `square`. > > **serviceMapSearchButtonColor** `string | null` > > Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. > > **serviceMapSearchButtonColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) > > **serviceMapSearchButtonTextColor** `string | null` > > The text/icon color. Clear it to derive from the button color (readable on solid fills). > > **serviceMapSearchButtonTextColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme label color. > > **serviceMapSearchButtonHoverColor** `string | null` > > Optional. Drives the hover treatment. Leave empty to derive it from the button color. > > **serviceMapSearchButtonHoverColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme hover color. > > **serviceMapSearchButtonStyle** `ServiceMapSearchButtonStyle | null` > > The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`. > > **serviceMapSearchButtonShadowColor** `string | null` > > Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. > > **serviceMapSearchButtonShadowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme shadow color. > > **serviceMapSearchButtonAnimation** `ServiceMapSearchButtonAnimation | null` > > Hover motion. One of `lift`, `scale`, `lift-scale`, `none`. > > **serviceMapPanelPlacement** `ServiceMapPanelPlacement | null` > > Popup placement. One of `center`, `corner`. > > **serviceMapPanelLook** `ServiceMapPanelLook | null` > > Popup style. One of `overlay`, `solid`. > > **serviceMapPanelShowQuery** `boolean` > > Repeats the searched ZIP code or address at the top of the result popup. > > **serviceMapPanelShowCity** `boolean` > > Looks up the locality for a searched ZIP code (one extra Geocoding API call per search) and shows it beside the searched value. > > **serviceMapPanelTextSize** `ServiceMapPanelTextSize | null` > > Popup text size. One of `small`, `normal`, `large`, `xlarge`. > > **serviceMapPanelTitleWeight** `ServiceMapPanelTitleWeight | null` > > Popup title weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **serviceMapShowPremium** `boolean` > > When the data carries a premium (distance-priced) service, include it in search results and the zone cards. Sources without their own premium block use the pricing set in Service area map → Areas and pricing. > > **serviceMapShowPremiumRing** `boolean` > > Needs a premium range limit (miles) — with no limit there is no ring to draw. > > **serviceMapPremiumEstimateNote** `string` > > Premium estimate note. > > **serviceMapPremiumUnavailableText** `string` > > Shown when a distance estimate isn’t possible (e.g. the Distance Matrix API isn’t enabled on the key). > > **serviceMapMarkerImage** `readonly Readonly\\>[]` > > Optional logo/pin image for the business marker. Leave empty for a simple accent-color pin. The related `@apostrophecms/image` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document (one at most); a document the site can’t find is left out. At most 1 items. > > **serviceMapMarkerImageLight** `readonly Readonly\\>[]` > > Optional light-theme variant. Falls back to the dark-theme image. The related `@apostrophecms/image` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document (one at most); a document the site can’t find is left out. At most 1 items. > > **serviceMapMarkerLabel** `string` > > Accessible name + hover title for the marker. Leave empty to use the business name from Site settings. > > **serviceMapMarkerSize** `ServiceMapMarkerSize | null` > > Marker size. One of `small`, `medium`, `large`. > > **serviceMapMarkerBounce** `boolean` > > The business marker gently bobs in place. Automatically disabled for visitors who prefer reduced motion. > > **serviceMapShowLocation** `boolean` > > Adds the business location (named by its label in Service area map → Your location) as the FIRST entry of the map key and zone cards. > > **serviceMapBg** `ServiceMapBg | null` > > The section’s full-width background band in dark mode. Transparent lets the page background show through. The palette options track the site colors; choose “Custom color…” for a specific color. One of `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`. > > **serviceMapBgCustom** `string | null` > > Used when “Section background (dark theme)” is set to Custom color. > > **serviceMapBgLight** `ServiceMapBgLight | null` > > “Match dark theme” reuses the dark-theme choice; otherwise set the light-mode band independently. One of `inherit`, `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`. > > **serviceMapBgLightCustom** `string | null` > > Used when “Section background (light theme)” is set to Custom color. > > **serviceMapFontOverrides** `readonly ServiceMapWidgetServiceMapFontOverridesItem[]` > > A list of `ServiceMapWidgetServiceMapFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. > > **ServiceMapWidgetServiceMapFontOverridesItem** > > **id** `string` > > The row’s id, unique in its array. > > **target** `Target | null` > > Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`. > > **source** `Source | null` > > Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`. > > **slot** `Slot | null` > > Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`. > > **curated** `Curated | null` > > Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`. > > **cdnProvider** `CdnProvider | null` > > Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`. > > **cdnFamily** `string` > > Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. > > **cdnWeights** `string` > > Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. > > **uploads** `readonly ServiceMapWidgetServiceMapFontOverridesItemUploadsItem[]` > > A list of `ServiceMapWidgetServiceMapFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. > > **ServiceMapWidgetServiceMapFontOverridesItemUploadsItem** > > **file** `Readonly\\>` *required* > > **Required.** File attachment reference. > > **id** `string` > > The row’s id, unique in its array. > > **weight** `Weight | null` > > Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`. > > **style** `Style | null` > > Style. One of `normal`, `italic`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **fallback** `Fallback | null` > > Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **sectionCss** `CustomCSS | null` > > A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **BlogPreviewWidget** > > A `blog-preview` widget: its `type` and its own fields. A field left out takes its default. > > **type** `BlogPreviewWidgetType` *required* > > **Required.** The widget’s type: always `blog-preview`. One of `blog-preview`. > > **id** `string` > > The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. > > **metaType** `MetaType` > > Always `widget`. One of `widget`. > > **blogHeading** `string` > > Heading. > > **blogSubheading** `string` > > Subheading. > > **blogCardImageAspect** `BlogCardImageAspect | null` > > Aspect ratio of the featured image. Choose “Hidden” for text-only cards. One of `16/10`, `4/3`, `3/2`, `1/1`, `none`. > > **blogCardImageHover** `BlogCardImageHover | null` > > Image hover. One of `zoom`, `none`. > > **blogCardImageFill** `boolean` > > Use the featured image as the full card background, with the title and meta overlaid on a dark scrim. Posts with no image fall back to a normal card. > > **blogCardPreset** `BlogCardPreset | null` > > The card surface. Raised is a quiet lit card; Luxe a frosted glass panel; Outline a plaque frame; Spine adds a color rail; Tint an accent wash; Ticket/Bracket/Forge/Press/Inlay are the graphic showstoppers. (On image-led cards the photo covers the top edge.) One of `raised`, `luxe`, `outline`, `plain`, `poster`, `edge`, `tint`, `ticket`, `bracket`, `forge`, `press`, `inlay`. > > **blogCardPresetRadius** `BlogCardPresetRadius | null` > > Corner rounding for each card. Default keeps the widget’s own tuned corners — except Forge, which defaults to tight machined corners matching its engraved frame. One of `default`, `square`, `slight`, `rounded`, `large`. > > **blogCardPresetAccentColor** `string | null` > > Colors the Spine rail, Bracket marks, Forge corner/frame and Press margin rule. Leave empty to use the brand accent. > > **blogCardPresetAccentColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **blogCardPresetForgeScope** `BlogCardPresetForgeScope | null` > > Where the Forge plate wears its color: a single corner mark (the machinist’s datum, default) or the whole engraved frame. One of `corner`, `frame`. > > **blogCardPresetForgeWeight** `BlogCardPresetForgeWeight | null` > > Thickness of the Forge corner mark / colored frame. One of `fine`, `medium`, `bold`. > > **blogCardHover** `BlogCardHover | null` > > What a card does on hover. Lift/Pop/Press/Glow/Outline are instant; Sheen sweeps a light across; Tilt (3-D + glare), Magnetic and Spotlight follow the cursor (need site animations on). The Hover color below tints these. One of `none`, `lift`, `pop`, `press`, `glow`, `border`, `sheen`, `tilt`, `magnetic`, `spotlight`. > > **blogCardHoverColor** `string | null` > > Border / shadow / glow color on hover. Leave empty to use the site accent color. > > **blogCardHoverColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color, then the accent. > > **blogCardShowCategory** `boolean` > > Show category. > > **blogCardCategoryStyle** `BlogCardCategoryStyle | null` > > How the category badge uses its color (set per category under Blog Categories). Filled = colored background; Outline = colored border + text; Minimal = colored text only. One of `filled`, `outline`, `minimal`. > > **blogCardShowDate** `boolean` > > Show date. > > **blogCardShowExcerpt** `boolean` > > Show excerpt. > > **blogCardExcerptLines** `BlogCardExcerptLines | null` > > How many lines of the excerpt to show before truncating. One of `2`, `3`, `4`, `none`. > > **blogCardShowAuthor** `boolean` > > Show author. > > **blogCardShowReadMore** `boolean` > > Show “Read post” link. > > **blogCardReadMorePlacement** `BlogCardReadMorePlacement | null` > > Auto puts it on the right of horizontal cards (list / compact / featured) and below the text on grid cards. Or force one placement everywhere. One of `auto`, `below`, `right`. > > **blogCardReadMoreColor** `string | null` > > Optional. Overrides the “Read post” link color. Leave empty to use the site accent color. > > **blogCardReadMoreColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color, then the accent. > > **blogCardReadMoreHoverColor** `string | null` > > Optional. Color of the “Read post” link when the card is hovered. Leave empty to use the accent color. > > **blogCardReadMoreHoverColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme hover color, then the accent. > > **blogCardTitleColor** `string | null` > > Optional. Overrides the card title color. Leave empty to track the theme’s text color. > > **blogCardTitleColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color, then the theme default. > > **blogCardTitleWeight** `BlogCardTitleWeight | null` > > Title weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **blogCardTitleHoverColor** `string | null` > > Optional. Title color when the card is hovered. Leave empty to use the site accent color. > > **blogCardTitleHoverColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme hover color, then the accent. > > **blogCardTextColor** `string | null` > > Optional. Overrides the excerpt text color. Leave empty for the muted default. > > **blogCardTextColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color, then the muted default. > > **blogCardTextWeight** `BlogCardTextWeight | null` > > Excerpt weight. One of `normal`, `medium`, `semibold`, `bold`. > > **blogCardMetaColor** `string | null` > > Date / meta line color. Leave empty for the faint default. > > **blogCardMetaColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color, then the faint default. > > **blogBg** `BlogBg | null` > > The section’s full-width background band in dark mode. Transparent lets the page background show through. The palette options track the site colors; choose “Custom color…” for a specific color. One of `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`. > > **blogBgCustom** `string | null` > > Used when “Section background (dark theme)” is set to Custom color. > > **blogBgLight** `BlogBgLight | null` > > “Match dark theme” reuses the dark-theme choice; otherwise set the light-mode band independently. One of `inherit`, `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`. > > **blogBgLightCustom** `string | null` > > Used when “Section background (light theme)” is set to Custom color. > > **blogFontOverrides** `readonly BlogPreviewWidgetBlogFontOverridesItem[]` > > A list of `BlogPreviewWidgetBlogFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. > > **BlogPreviewWidgetBlogFontOverridesItem** > > **id** `string` > > The row’s id, unique in its array. > > **target** `Target | null` > > Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`. > > **source** `Source | null` > > Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`. > > **slot** `Slot | null` > > Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`. > > **curated** `Curated | null` > > Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`. > > **cdnProvider** `CdnProvider | null` > > Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`. > > **cdnFamily** `string` > > Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. > > **cdnWeights** `string` > > Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. > > **uploads** `readonly BlogPreviewWidgetBlogFontOverridesItemUploadsItem[]` > > A list of `BlogPreviewWidgetBlogFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. > > **BlogPreviewWidgetBlogFontOverridesItemUploadsItem** > > **file** `Readonly\\>` *required* > > **Required.** File attachment reference. > > **id** `string` > > The row’s id, unique in its array. > > **weight** `Weight | null` > > Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`. > > **style** `Style | null` > > Style. One of `normal`, `italic`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **fallback** `Fallback | null` > > Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **blogCtaLabel** `string` > > The visible button text. Leave empty to hide the button. > > **blogCtaUrl** `string` > > Where the button goes — a path (/blog) or full URL. > > **blogCtaNewTab** `boolean` > > Opens the link in a new browser tab (adds rel="noopener noreferrer"). > > **blogCtaVariant** `BlogCtaVariant | null` > > Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`. > > **blogCtaSize** `BlogCtaSize | null` > > Button size. One of `small`, `normal`, `large`. > > **blogCtaRadius** `BlogCtaRadius | null` > > Corner radius. One of `pill`, `rounded`, `slight`, `square`. > > **blogCtaColor** `string | null` > > Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. > > **blogCtaColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) > > **blogCtaTextColor** `string | null` > > The text/icon color. Clear it to derive from the button color (readable on solid fills). > > **blogCtaTextColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme label color. > > **blogCtaHoverColor** `string | null` > > Optional. Drives the hover treatment. Leave empty to derive it from the button color. > > **blogCtaHoverColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme hover color. > > **blogCtaStyle** `BlogCtaStyle | null` > > The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`. > > **blogCtaShadowColor** `string | null` > > Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. > > **blogCtaShadowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme shadow color. > > **blogCtaAnimation** `BlogCtaAnimation | null` > > Hover motion. One of `lift`, `scale`, `lift-scale`, `none`. > > **blogCtaIcon** `string` > > Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. > > **blogCtaIconFamily** `BlogCtaIconFamily | null` > > Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`. > > **blogCtaIconPosition** `BlogCtaIconPosition | null` > > Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`. > > **blogCtaIconNudge** `boolean` > > The icon slides toward its side on hover (e.g. an arrow edges outward). > > **sectionCss** `CustomCSS | null` > > A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **CookieDeclarationWidget** > > A `cookie-declaration` widget: its `type` and its own fields. A field left out takes its default. > > **type** `CookieDeclarationWidgetType` *required* > > **Required.** The widget’s type: always `cookie-declaration`. One of `cookie-declaration`. > > **id** `string` > > The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. > > **metaType** `MetaType` > > Always `widget`. One of `widget`. > > **cookieDeclEyebrow** `string` > > Eyebrow. > > **cookieDeclHeading** `string` > > Heading. > > **cookieDeclIntro** `string` > > Introduction. > > **cookieDeclShowStatus** `boolean` > > A short block naming what this visitor has allowed, with a button that reopens the preferences panel. Withdrawal has to be as easy as consent, so leave this on unless the page offers another way. > > **cookieDeclShowTable** `boolean` > > Provider, type, duration and domain per entry. Off leaves the plain-language disclosures alone, which reads better but tells a technical reader less. > > **cookieDeclLayout** `CookieDeclLayout | null` > > Layout. One of `stacked`, `compact`. > > **cookieDeclBg** `CookieDeclBg | null` > > The section’s full-width background band in dark mode. Transparent lets the page background show through. The palette options track the site colors; choose “Custom color…” for a specific color. One of `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`. > > **cookieDeclBgCustom** `string | null` > > Used when “Section background (dark theme)” is set to Custom color. > > **cookieDeclBgLight** `CookieDeclBgLight | null` > > “Match dark theme” reuses the dark-theme choice; otherwise set the light-mode band independently. One of `inherit`, `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`. > > **cookieDeclBgLightCustom** `string | null` > > Used when “Section background (light theme)” is set to Custom color. > > **cookieDeclFontOverrides** `readonly CookieDeclarationWidgetCookieDeclFontOverridesItem[]` > > A list of `CookieDeclarationWidgetCookieDeclFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. > > **CookieDeclarationWidgetCookieDeclFontOverridesItem** > > **id** `string` > > The row’s id, unique in its array. > > **target** `Target | null` > > Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`. > > **source** `Source | null` > > Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`. > > **slot** `Slot | null` > > Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`. > > **curated** `Curated | null` > > Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`. > > **cdnProvider** `CdnProvider | null` > > Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`. > > **cdnFamily** `string` > > Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. > > **cdnWeights** `string` > > Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. > > **uploads** `readonly CookieDeclarationWidgetCookieDeclFontOverridesItemUploadsItem[]` > > A list of `CookieDeclarationWidgetCookieDeclFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. > > **CookieDeclarationWidgetCookieDeclFontOverridesItemUploadsItem** > > **file** `Readonly\\>` *required* > > **Required.** File attachment reference. > > **id** `string` > > The row’s id, unique in its array. > > **weight** `Weight | null` > > Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`. > > **style** `Style | null` > > Style. One of `normal`, `italic`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **fallback** `Fallback | null` > > Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **sectionCss** `CustomCSS | null` > > A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **RichTextWidget** > > A `@apostrophecms/rich-text` widget: its `type` and its own fields. A field left out takes its default. > > **type** `RichTextWidgetType` *required* > > **Required.** The widget’s type: always `@apostrophecms/rich-text`. One of `@apostrophecms/rich-text`. > > **id** `string` > > The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. > > **metaType** `MetaType` > > Always `widget`. One of `widget`. > > **content** `string` > > The text as HTML, e.g. `

Our story

It began with one idea.

`. The site keeps the tags and styles this area’s editor offers (paragraphs, headings, bold, italic, links, lists…) and removes the rest. > > **sectionCss** `CustomCSS | null` > > A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **GoogleReviewsWidget** > > A `google-reviews` widget: its `type` and its own fields. A field left out takes its default. > > **type** `GoogleReviewsWidgetType` *required* > > **Required.** The widget’s type: always `google-reviews`. One of `google-reviews`. > > **id** `string` > > The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. > > **metaType** `MetaType` > > Always `widget`. One of `widget`. > > **reviewsEyebrow** `string` > > Small label shown above the title. > > **reviewsEyebrowColor** `string | null` > > Optional. Overrides the eyebrow + its dash. Leave empty to use the secondary (mint) color. > > **reviewsEyebrowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color, then the mint default. > > **reviewsEyebrowWeight** `ReviewsEyebrowWeight | null` > > Eyebrow weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **reviewsEyebrowSize** `ReviewsEyebrowSize | null` > > Eyebrow size. One of `small`, `normal`, `large`, `xlarge`. > > **reviewsHeading** `string` > > Optional. Leave empty to show just the reviews. > > **reviewsHeadingColor** `string | null` > > Optional — leave empty to track the theme text color. > > **reviewsHeadingColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **reviewsHeadingWeight** `ReviewsHeadingWeight | null` > > Heading weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **reviewsIntro** `string` > > Optional short sentence under the heading. > > **reviewsIntroColor** `string | null` > > Optional — leave empty to use the muted text color. > > **reviewsIntroColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **reviewsIntroWeight** `ReviewsIntroWeight | null` > > Intro weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **reviewsIntroSize** `ReviewsIntroSize | null` > > Intro size. One of `small`, `normal`, `large`, `xlarge`. > > **reviewsAlign** `ReviewsAlign | null` > > Header alignment. One of `center`, `left`. > > **reviewsMinRating** `ReviewsMinRating | null` > > Only show reviews at or above this star rating. One of `0`, `3`, `4`, `5`. > > **reviewsFeaturedOnly** `boolean` > > Show only reviews you have flagged “Featured” in the Google Reviews manager — hand-curate exactly which appear. > > **reviewsCount** `number | null` > > The most reviews to show (newest first). 1 to 30. > > **reviewsLayout** `ReviewsLayout | null` > > Animated carousel: a continuous, auto-scrolling marquee of cards (great on a home page; needs site animations enabled — falls back to the grid when they are off). Grid: a tidy multi-row grid. Masonry: a staggered, Pinterest-style grid that hugs each review’s length. One of `carousel`, `grid`, `masonry`. > > **reviewsColumns** `ReviewsColumns | null` > > How many cards per row (grid) or columns (masonry). Auto fits as many as comfortably fit. One of `auto`, `2`, `3`, `4`. > > **reviewsSpeed** `ReviewsSpeed | null` > > How fast the carousel auto-scrolls. The review carousel runs on its own (gentler) speed scale than the logos/footer marquees so two never scroll in lockstep. One of `vslow`, `slow`, `normal`, `fast`. > > **reviewsDirection** `ReviewsDirection | null` > > Scroll direction. One of `left`, `right`. > > **reviewsGap** `ReviewsGap | null` > > Gap between cards. One of `tight`, `normal`, `roomy`. > > **reviewsShowAvatar** `boolean` > > Show the reviewer’s Google avatar (falls back to a lettered initial when missing or anonymous). > > **reviewsShowRating** `boolean` > > Show star rating. > > **reviewsShowDate** `boolean` > > Show review date. > > **reviewsShowReply** `boolean` > > Include the business’s public reply beneath a review when there is one. > > **reviewsShowAttribution** `boolean` > > A small Google attribution lockup under the section — recommended when showing Google reviews. > > **reviewsCardStyle** `ReviewsCardStyle | null` > > The card surface. Raised is a quiet lit card; Luxe is a frosted glass panel; Outline is a double-rule plaque frame; Plain has no chrome; Poster frames the card with an accent keyline; Spine embeds a color rail along the top; Tint washes the card in the accent color. Showstoppers: Ticket punches notches into the sides, Bracket draws only corner marks, Forge is a machined plate with an engraved frame, Press is a punched index card with a margin rule, Inlay recesses the content into a well. One of `raised`, `luxe`, `outline`, `plain`, `poster`, `edge`, `tint`, `ticket`, `bracket`, `forge`, `press`, `inlay`. > > **reviewsCardStyleRadius** `ReviewsCardStyleRadius | null` > > Corner rounding for each card. Default keeps the widget’s own tuned corners — except Forge, which defaults to tight machined corners matching its engraved frame. One of `default`, `square`, `slight`, `rounded`, `large`. > > **reviewsCardStyleAccentColor** `string | null` > > Colors the Spine rail, Bracket marks, Forge corner/frame and Press margin rule. Leave empty to use the brand accent. > > **reviewsCardStyleAccentColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **reviewsCardStyleForgeScope** `ReviewsCardStyleForgeScope | null` > > Where the Forge plate wears its color: a single corner mark (the machinist’s datum, default) or the whole engraved frame. One of `corner`, `frame`. > > **reviewsCardStyleForgeWeight** `ReviewsCardStyleForgeWeight | null` > > Thickness of the Forge corner mark / colored frame. One of `fine`, `medium`, `bold`. > > **reviewsCardHover** `ReviewsCardHover | null` > > What a card does on hover. Lift/Pop/Press/Glow/Outline are instant; Sheen sweeps a light across; Tilt, Magnetic and Spotlight follow the cursor (need site animations on). Vary it per section so the page is not cookie-cutter. One of `none`, `lift`, `pop`, `press`, `glow`, `border`, `sheen`, `tilt`, `magnetic`, `spotlight`. > > **reviewsCardWidth** `ReviewsCardWidth | null` > > Sets the carousel card width and the minimum card width in the grid/masonry layouts. One of `narrow`, `normal`, `wide`. > > **reviewsCardHeight** `ReviewsCardHeight | null` > > Auto hugs the content; the taller presets give every card a consistent minimum height (grid + carousel). The masonry layout ignores this and staggers card heights itself. One of `auto`, `medium`, `tall`. > > **reviewsCardAlign** `ReviewsCardAlign | null` > > How the avatar, name, stars and text align inside each card. One of `left`, `center`, `right`. > > **reviewsStarColor** `string | null` > > Optional — leave empty to use a warm amber. Applies in both themes. > > **reviewsAccentColor** `string | null` > > Optional — background of the lettered fallback avatar. Leave empty to use the brand accent. > > **reviewsAccentColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **reviewsNameSize** `ReviewsNameSize | null` > > Name size. One of `small`, `normal`, `large`, `xlarge`. > > **reviewsNameWeight** `ReviewsNameWeight | null` > > Name weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **reviewsNameColor** `string | null` > > Optional — leave empty to track the theme text color. > > **reviewsNameColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **reviewsDateSize** `ReviewsDateSize | null` > > Date size. One of `small`, `normal`, `large`, `xlarge`. > > **reviewsDateWeight** `ReviewsDateWeight | null` > > Date weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **reviewsDateColor** `string | null` > > Optional — leave empty to use the faint text color. > > **reviewsDateColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **reviewsTextSize** `ReviewsTextSize | null` > > Review text size. One of `small`, `normal`, `large`, `xlarge`. > > **reviewsTextWeight** `ReviewsTextWeight | null` > > Review text weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **reviewsTextColor** `string | null` > > Optional — leave empty to use the muted text color. > > **reviewsTextColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **reviewsTextClamp** `ReviewsTextClamp | null` > > Cap each review at this many lines (the rest is truncated with an ellipsis) so one very long review can’t blow up the card height — important once real, lengthy reviews come in. Choose “Full text” to never truncate. Short reviews are unaffected. One of `none`, `4`, `6`, `8`, `12`. > > **reviewsBg** `ReviewsBg | null` > > The section’s full-width background band in dark mode. Transparent lets the page background show through. The palette options track the site colors; choose “Custom color…” for a specific color. One of `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`. > > **reviewsBgCustom** `string | null` > > Used when “Section background (dark theme)” is set to Custom color. > > **reviewsBgLight** `ReviewsBgLight | null` > > “Match dark theme” reuses the dark-theme choice; otherwise set the light-mode band independently. One of `inherit`, `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`. > > **reviewsBgLightCustom** `string | null` > > Used when “Section background (light theme)” is set to Custom color. > > **reviewsFontOverrides** `readonly GoogleReviewsWidgetReviewsFontOverridesItem[]` > > A list of `GoogleReviewsWidgetReviewsFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. > > **GoogleReviewsWidgetReviewsFontOverridesItem** > > **id** `string` > > The row’s id, unique in its array. > > **target** `Target | null` > > Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`. > > **source** `Source | null` > > Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`. > > **slot** `Slot | null` > > Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`. > > **curated** `Curated | null` > > Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`. > > **cdnProvider** `CdnProvider | null` > > Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`. > > **cdnFamily** `string` > > Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. > > **cdnWeights** `string` > > Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. > > **uploads** `readonly GoogleReviewsWidgetReviewsFontOverridesItemUploadsItem[]` > > A list of `GoogleReviewsWidgetReviewsFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. > > **GoogleReviewsWidgetReviewsFontOverridesItemUploadsItem** > > **file** `Readonly\\>` *required* > > **Required.** File attachment reference. > > **id** `string` > > The row’s id, unique in its array. > > **weight** `Weight | null` > > Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`. > > **style** `Style | null` > > Style. One of `normal`, `italic`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **fallback** `Fallback | null` > > Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **reviewsCtaLabel** `string` > > The visible button text. Leave empty to hide the button. > > **reviewsCtaUrl** `string` > > Where the button goes — a path (/blog) or full URL. > > **reviewsCtaNewTab** `boolean` > > Opens the link in a new browser tab (adds rel="noopener noreferrer"). > > **reviewsCtaVariant** `ReviewsCtaVariant | null` > > Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`. > > **reviewsCtaSize** `ReviewsCtaSize | null` > > Button size. One of `small`, `normal`, `large`. > > **reviewsCtaRadius** `ReviewsCtaRadius | null` > > Corner radius. One of `pill`, `rounded`, `slight`, `square`. > > **reviewsCtaColor** `string | null` > > Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. > > **reviewsCtaColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) > > **reviewsCtaTextColor** `string | null` > > The text/icon color. Clear it to derive from the button color (readable on solid fills). > > **reviewsCtaTextColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme label color. > > **reviewsCtaHoverColor** `string | null` > > Optional. Drives the hover treatment. Leave empty to derive it from the button color. > > **reviewsCtaHoverColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme hover color. > > **reviewsCtaStyle** `ReviewsCtaStyle | null` > > The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`. > > **reviewsCtaShadowColor** `string | null` > > Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. > > **reviewsCtaShadowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme shadow color. > > **reviewsCtaAnimation** `ReviewsCtaAnimation | null` > > Hover motion. One of `lift`, `scale`, `lift-scale`, `none`. > > **reviewsCtaIcon** `string` > > Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. > > **reviewsCtaIconFamily** `ReviewsCtaIconFamily | null` > > Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`. > > **reviewsCtaIconPosition** `ReviewsCtaIconPosition | null` > > Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`. > > **reviewsCtaIconNudge** `boolean` > > The icon slides toward its side on hover (e.g. an arrow edges outward). > > **sectionCss** `CustomCSS | null` > > A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **TestimonialsWidget** > > A `testimonials` widget: its `type` and its own fields. A field left out takes its default. > > **type** `TestimonialsWidgetType` *required* > > **Required.** The widget’s type: always `testimonials`. One of `testimonials`. > > **id** `string` > > The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. > > **metaType** `MetaType` > > Always `widget`. One of `widget`. > > **testimonialsEyebrow** `string` > > Small label shown above the title. > > **testimonialsEyebrowColor** `string | null` > > Optional. Overrides the eyebrow + its dash. Leave empty to use the secondary (mint) color. > > **testimonialsEyebrowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color, then the mint default. > > **testimonialsEyebrowWeight** `TestimonialsEyebrowWeight | null` > > Eyebrow weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **testimonialsEyebrowSize** `TestimonialsEyebrowSize | null` > > Eyebrow size. One of `small`, `normal`, `large`, `xlarge`. > > **testimonialsHeading** `string` > > Optional. Leave empty to show just the testimonials. > > **testimonialsHeadingColor** `string | null` > > Optional — leave empty to track the theme text color. > > **testimonialsHeadingColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **testimonialsHeadingWeight** `TestimonialsHeadingWeight | null` > > Heading weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **testimonialsIntro** `string` > > Optional short sentence under the heading. > > **testimonialsIntroColor** `string | null` > > Optional — leave empty to use the muted text color. > > **testimonialsIntroColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **testimonialsIntroWeight** `TestimonialsIntroWeight | null` > > Intro weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **testimonialsIntroSize** `TestimonialsIntroSize | null` > > Intro size. One of `small`, `normal`, `large`, `xlarge`. > > **testimonialsAlign** `TestimonialsAlign | null` > > Header alignment. One of `center`, `left`. > > **testimonialsFeaturedOnly** `boolean` > > Show only testimonials you have flagged “Featured” in the Testimonials manager — hand-curate exactly which appear. > > **testimonialsCount** `number | null` > > The most testimonials to show (featured first). 1 to 30. > > **testimonialsLayout** `TestimonialsLayout | null` > > Animated carousel: a continuous, auto-scrolling marquee of cards (great on a home page; needs site animations enabled — falls back to the grid when they are off). Grid: a tidy multi-row grid. Masonry: a staggered, Pinterest-style grid that hugs each quote’s length. One of `carousel`, `grid`, `masonry`. > > **testimonialsColumns** `TestimonialsColumns | null` > > How many cards per row (grid) or columns (masonry). Auto fits as many as comfortably fit. One of `auto`, `2`, `3`, `4`. > > **testimonialsSpeed** `TestimonialsSpeed | null` > > How fast the carousel auto-scrolls. One of `vslow`, `slow`, `normal`, `fast`. > > **testimonialsDirection** `TestimonialsDirection | null` > > Scroll direction. One of `left`, `right`. > > **testimonialsGap** `TestimonialsGap | null` > > Gap between cards. One of `tight`, `normal`, `roomy`. > > **testimonialsCardLayout** `TestimonialsCardLayout | null` > > Quote-led: a large quotation mark over the quote, with the author in a footer (the classic testimonial look). Accent bar: the quote beside a bold accent bar. Classic: the author on top (photo + name), then the quote — like a review card. One of `quote`, `bar`, `classic`. > > **testimonialsShowQuoteMark** `boolean` > > The oversized “ glyph on the quote-led and accent-bar layouts. > > **testimonialsShowAvatar** `boolean` > > Show the author’s photo (falls back to a lettered initial when none is set). > > **testimonialsShowTitle** `boolean` > > Show author role / context. > > **testimonialsShowRating** `boolean` > > Off by default — a testimonial usually leads with the quote. Turn on to show each testimonial’s star rating. > > **testimonialsLinkLabel** `string` > > The text for a testimonial’s optional “Source link” (set per testimonial in the Testimonials manager). Shown only on testimonials that have a link. > > **testimonialsCardStyle** `TestimonialsCardStyle | null` > > The card treatment. Spine (the default) embeds a color rail along the top; Raised is a quiet lit card; Luxe a frosted glass panel; Ticket/Bracket/Forge/Press/Inlay are the graphic showstoppers. One of `raised`, `luxe`, `outline`, `plain`, `poster`, `edge`, `tint`, `ticket`, `bracket`, `forge`, `press`, `inlay`. > > **testimonialsCardStyleRadius** `TestimonialsCardStyleRadius | null` > > Corner rounding for each card. Default keeps the widget’s own tuned corners — except Forge, which defaults to tight machined corners matching its engraved frame. One of `default`, `square`, `slight`, `rounded`, `large`. > > **testimonialsCardStyleAccentColor** `string | null` > > Colors the Spine rail, Bracket marks, Forge corner/frame and Press margin rule. Leave empty to use the brand accent. > > **testimonialsCardStyleAccentColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **testimonialsCardStyleForgeScope** `TestimonialsCardStyleForgeScope | null` > > Where the Forge plate wears its color: a single corner mark (the machinist’s datum, default) or the whole engraved frame. One of `corner`, `frame`. > > **testimonialsCardStyleForgeWeight** `TestimonialsCardStyleForgeWeight | null` > > Thickness of the Forge corner mark / colored frame. One of `fine`, `medium`, `bold`. > > **testimonialsCardHover** `TestimonialsCardHover | null` > > What a card does on hover. Lift/Pop/Press/Glow/Outline are instant; Sheen sweeps a light across; Tilt, Magnetic and Spotlight follow the cursor (need site animations on). Vary it per section so the page is not cookie-cutter. One of `none`, `lift`, `pop`, `press`, `glow`, `border`, `sheen`, `tilt`, `magnetic`, `spotlight`. > > **testimonialsCardWidth** `TestimonialsCardWidth | null` > > Sets the carousel card width and the minimum card width in the grid/masonry layouts. One of `narrow`, `normal`, `wide`. > > **testimonialsCardHeight** `TestimonialsCardHeight | null` > > Auto hugs the content; the taller presets give every card a consistent minimum height (grid + carousel). The masonry layout ignores this and staggers card heights itself. One of `auto`, `medium`, `tall`. > > **testimonialsCardAlign** `TestimonialsCardAlign | null` > > How the quote and author align inside each card. One of `left`, `center`, `right`. > > **testimonialsStarColor** `string | null` > > Optional — leave empty to use a warm amber. Applies in both themes (only when ratings are shown). > > **testimonialsAccentColor** `string | null` > > Optional — the quotation mark, the accent bar, and the lettered-avatar background. Leave empty to use the brand accent. > > **testimonialsAccentColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **testimonialsNameSize** `TestimonialsNameSize | null` > > Name size. One of `small`, `normal`, `large`, `xlarge`. > > **testimonialsNameWeight** `TestimonialsNameWeight | null` > > Name weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **testimonialsNameColor** `string | null` > > Optional — leave empty to track the theme text color. > > **testimonialsNameColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **testimonialsTitleSize** `TestimonialsTitleSize | null` > > Role size. One of `small`, `normal`, `large`, `xlarge`. > > **testimonialsTitleWeight** `TestimonialsTitleWeight | null` > > Role weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **testimonialsTitleColor** `string | null` > > Optional — leave empty to use the faint text color. > > **testimonialsTitleColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **testimonialsQuoteSize** `TestimonialsQuoteSize | null` > > Quote size. One of `small`, `normal`, `large`, `xlarge`. > > **testimonialsQuoteWeight** `TestimonialsQuoteWeight | null` > > Quote weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **testimonialsQuoteColor** `string | null` > > Optional — leave empty to use the theme text color. > > **testimonialsQuoteColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **testimonialsQuoteClamp** `TestimonialsQuoteClamp | null` > > Cap each quote at this many lines (the rest is truncated with an ellipsis) so one very long testimonial can’t blow up the card height. Choose “Full text” to never truncate. Short quotes are unaffected. One of `none`, `4`, `6`, `8`, `12`. > > **testimonialsBg** `TestimonialsBg | null` > > The section’s full-width background band in dark mode. Transparent lets the page background show through. The palette options track the site colors; choose “Custom color…” for a specific color. One of `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`. > > **testimonialsBgCustom** `string | null` > > Used when “Section background (dark theme)” is set to Custom color. > > **testimonialsBgLight** `TestimonialsBgLight | null` > > “Match dark theme” reuses the dark-theme choice; otherwise set the light-mode band independently. One of `inherit`, `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`. > > **testimonialsBgLightCustom** `string | null` > > Used when “Section background (light theme)” is set to Custom color. > > **testimonialsFontOverrides** `readonly TestimonialsWidgetTestimonialsFontOverridesItem[]` > > A list of `TestimonialsWidgetTestimonialsFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. > > **TestimonialsWidgetTestimonialsFontOverridesItem** > > **id** `string` > > The row’s id, unique in its array. > > **target** `Target | null` > > Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`. > > **source** `Source | null` > > Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`. > > **slot** `Slot | null` > > Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`. > > **curated** `Curated | null` > > Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`. > > **cdnProvider** `CdnProvider | null` > > Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`. > > **cdnFamily** `string` > > Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. > > **cdnWeights** `string` > > Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. > > **uploads** `readonly TestimonialsWidgetTestimonialsFontOverridesItemUploadsItem[]` > > A list of `TestimonialsWidgetTestimonialsFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. > > **TestimonialsWidgetTestimonialsFontOverridesItemUploadsItem** > > **file** `Readonly\\>` *required* > > **Required.** File attachment reference. > > **id** `string` > > The row’s id, unique in its array. > > **weight** `Weight | null` > > Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`. > > **style** `Style | null` > > Style. One of `normal`, `italic`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **fallback** `Fallback | null` > > Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **testimonialsCtaLabel** `string` > > The visible button text. Leave empty to hide the button. > > **testimonialsCtaUrl** `string` > > Where the button goes — a path (/blog) or full URL. > > **testimonialsCtaNewTab** `boolean` > > Opens the link in a new browser tab (adds rel="noopener noreferrer"). > > **testimonialsCtaVariant** `TestimonialsCtaVariant | null` > > Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`. > > **testimonialsCtaSize** `TestimonialsCtaSize | null` > > Button size. One of `small`, `normal`, `large`. > > **testimonialsCtaRadius** `TestimonialsCtaRadius | null` > > Corner radius. One of `pill`, `rounded`, `slight`, `square`. > > **testimonialsCtaColor** `string | null` > > Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. > > **testimonialsCtaColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) > > **testimonialsCtaTextColor** `string | null` > > The text/icon color. Clear it to derive from the button color (readable on solid fills). > > **testimonialsCtaTextColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme label color. > > **testimonialsCtaHoverColor** `string | null` > > Optional. Drives the hover treatment. Leave empty to derive it from the button color. > > **testimonialsCtaHoverColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme hover color. > > **testimonialsCtaStyle** `TestimonialsCtaStyle | null` > > The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`. > > **testimonialsCtaShadowColor** `string | null` > > Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. > > **testimonialsCtaShadowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme shadow color. > > **testimonialsCtaAnimation** `TestimonialsCtaAnimation | null` > > Hover motion. One of `lift`, `scale`, `lift-scale`, `none`. > > **testimonialsCtaIcon** `string` > > Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. > > **testimonialsCtaIconFamily** `TestimonialsCtaIconFamily | null` > > Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`. > > **testimonialsCtaIconPosition** `TestimonialsCtaIconPosition | null` > > Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`. > > **testimonialsCtaIconNudge** `boolean` > > The icon slides toward its side on hover (e.g. an arrow edges outward). > > **sectionCss** `CustomCSS | null` > > A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **InstagramFeedWidget** > > A `instagram-feed` widget: its `type` and its own fields. A field left out takes its default. > > **type** `InstagramFeedWidgetType` *required* > > **Required.** The widget’s type: always `instagram-feed`. One of `instagram-feed`. > > **id** `string` > > The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. > > **metaType** `MetaType` > > Always `widget`. One of `widget`. > > **instagramEyebrow** `string` > > Small label shown above the title. > > **instagramEyebrowColor** `string | null` > > Optional. Overrides the eyebrow + its dash. Leave empty to use the secondary (mint) color. > > **instagramEyebrowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color, then the mint default. > > **instagramEyebrowWeight** `InstagramEyebrowWeight | null` > > Eyebrow weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **instagramEyebrowSize** `InstagramEyebrowSize | null` > > Eyebrow size. One of `small`, `normal`, `large`, `xlarge`. > > **instagramHeading** `string` > > Optional. Leave empty to show just the feed. > > **instagramHeadingColor** `string | null` > > Optional — leave empty to track the theme text color. > > **instagramHeadingColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **instagramHeadingWeight** `InstagramHeadingWeight | null` > > Heading weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **instagramIntro** `string` > > Optional short sentence under the heading. > > **instagramIntroColor** `string | null` > > Optional — leave empty to use the muted text color. > > **instagramIntroColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **instagramIntroWeight** `InstagramIntroWeight | null` > > Intro weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **instagramIntroSize** `InstagramIntroSize | null` > > Intro size. One of `small`, `normal`, `large`, `xlarge`. > > **instagramAlign** `InstagramAlign | null` > > Header alignment. One of `center`, `left`. > > **instagramFeaturedOnly** `boolean` > > Show only posts you have flagged “Featured” in the Instagram Posts manager — hand-curate exactly which appear. > > **instagramCount** `number | null` > > The most posts to show (newest first). 1 to 30. > > **instagramMediaFilter** `InstagramMediaFilter | null` > > Filter this feed by media type. “Photos” keeps image and album posts; “Videos & reels” keeps only video posts. This is per-feed display only — it doesn’t change what gets synced. One of `all`, `photos`, `videos`. > > **instagramLayout** `InstagramLayout | null` > > Carousel: a continuous, auto-scrolling marquee strip (great on a home page; needs site animations enabled — falls back to the grid when they are off). Grid: a tidy multi-row grid. Masonry: a staggered grid that hugs each image’s shape. Mosaic Photo Wall: an edge-to-edge, gap-free photo wall where rows are scaled to a common height (like Flickr / Google Photos) — the richest option for photos. One of `carousel`, `grid`, `masonry`, `justified`. > > **instagramColumns** `InstagramColumns | null` > > How many tiles per row (grid) or columns (masonry). Auto fits as many as comfortably fit. (The Mosaic Photo Wall sets its own row layout.) One of `auto`, `2`, `3`, `4`, `5`. > > **instagramJustifiedHeight** `InstagramJustifiedHeight | null` > > The target height of each row in the Mosaic Photo Wall. Taller rows show fewer, bigger photos per row. One of `compact`, `normal`, `tall`. > > **instagramJustifiedVary** `boolean` > > For feeds where every photo is the same shape (e.g. all square): assign each tile a varied shape (cropped around its focal point, never cutting the subject) so the wall still reads as an organic mosaic. Leave off when your photos already vary. > > **instagramSpeed** `InstagramSpeed | null` > > How fast the carousel auto-scrolls. The feed runs on its own speed scale so two marquees on a page never scroll in lockstep. One of `vslow`, `slow`, `normal`, `fast`. > > **instagramDirection** `InstagramDirection | null` > > Scroll direction. One of `left`, `right`. > > **instagramGap** `InstagramGap | null` > > Gap between tiles. One of `tight`, `normal`, `roomy`. > > **instagramAspect** `InstagramAspect | null` > > Crop each image to a consistent shape. “Original” keeps each image’s own ratio (best with the masonry layout). One of `square`, `portrait`, `landscape`, `original`. > > **instagramCardWidth** `InstagramCardWidth | null` > > Sets the carousel tile width and the minimum tile width in the grid/masonry layouts. One of `narrow`, `normal`, `wide`. > > **instagramRadius** `InstagramRadius | null` > > Corner radius. One of `none`, `slight`, `rounded`. > > **instagramCardHover** `InstagramCardHover | null` > > What a tile does on hover. Lift/Glow are best for image tiles; Tilt, Magnetic and Spotlight follow the cursor (need site animations on). This is on top of the image zoom. One of `none`, `lift`, `pop`, `press`, `glow`, `border`, `sheen`, `tilt`, `magnetic`, `spotlight`. > > **instagramShowVideoBadge** `boolean` > > A small corner glyph marking a video, reel, or carousel album. > > **instagramShowPermalinkIcon** `boolean` > > A corner Instagram glyph on each tile — the one opt-in link out to the post (opens in a new tab). The tile itself opens the on-site lightbox. > > **instagramShowCardLikes** `boolean` > > A small heart + like count in the bottom corner of each tile. Off by default. (A post whose account hides like counts on Instagram shows nothing.) > > **instagramGlyphSize** `InstagramGlyphSize | null` > > Size of the corner glyph, the video/reel badge, and the play affordance on video tiles. All three options are larger than the old fixed size. One of `small`, `medium`, `large`. > > **instagramShowCaption** `boolean` > > Off by default (the classic image-only grid). When on, choose where the caption appears below. > > **instagramCaptionMode** `InstagramCaptionMode | null` > > Caption placement. One of `below`, `hover`. > > **instagramAccentColor** `string | null` > > Optional — color of the corner glyph + the hover wash. Leave empty to use the brand accent. > > **instagramAccentColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **instagramLikeColor** `string | null` > > Optional — color of the like heart on the tiles and in the lightbox. Leave empty to use the brand coral. > > **instagramLikeColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **instagramCaptionClamp** `InstagramCaptionClamp | null` > > Cap each caption at this many lines so a long caption can’t blow up the tile. One of `none`, `1`, `2`, `3`, `4`. > > **instagramCaptionSize** `InstagramCaptionSize | null` > > Caption size. One of `small`, `normal`, `large`, `xlarge`. > > **instagramCaptionWeight** `InstagramCaptionWeight | null` > > Caption weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **instagramCaptionColor** `string | null` > > Optional — leave empty to use the muted text color (below mode) / white (hover mode). > > **instagramCaptionColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **instagramShowLikes** `boolean` > > Show the post’s like count in the lightbox. (An account that hides like counts on Instagram reports none — then nothing shows.) > > **instagramCommentsDisplay** `InstagramCommentsDisplay | null` > > How comments appear in the lightbox. “Count only” shows just the total. “Full list” shows the actual comments — requires “Fetch post comments” in Connections → Instagram to be on so the comment text is synced. One of `none`, `count`, `list`. > > **instagramShowCommentAuthors** `boolean` > > Show each commenter’s Instagram handle next to their comment. Turn off for a cleaner, anonymous list of just the comment text. > > **instagramLightboxShowPermalink** `boolean` > > The opt-in outbound link in the lightbox. Turn it off to keep visitors fully on your site (the corner glyph on each tile is a separate setting). > > **instagramBg** `InstagramBg | null` > > The section’s full-width background band in dark mode. Transparent lets the page background show through. The palette options track the site colors; choose “Custom color…” for a specific color. One of `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`. > > **instagramBgCustom** `string | null` > > Used when “Section background (dark theme)” is set to Custom color. > > **instagramBgLight** `InstagramBgLight | null` > > “Match dark theme” reuses the dark-theme choice; otherwise set the light-mode band independently. One of `inherit`, `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`. > > **instagramBgLightCustom** `string | null` > > Used when “Section background (light theme)” is set to Custom color. > > **instagramFontOverrides** `readonly InstagramFeedWidgetInstagramFontOverridesItem[]` > > A list of `InstagramFeedWidgetInstagramFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. > > **InstagramFeedWidgetInstagramFontOverridesItem** > > **id** `string` > > The row’s id, unique in its array. > > **target** `Target | null` > > Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`. > > **source** `Source | null` > > Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`. > > **slot** `Slot | null` > > Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`. > > **curated** `Curated | null` > > Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`. > > **cdnProvider** `CdnProvider | null` > > Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`. > > **cdnFamily** `string` > > Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. > > **cdnWeights** `string` > > Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. > > **uploads** `readonly InstagramFeedWidgetInstagramFontOverridesItemUploadsItem[]` > > A list of `InstagramFeedWidgetInstagramFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. > > **InstagramFeedWidgetInstagramFontOverridesItemUploadsItem** > > **file** `Readonly\\>` *required* > > **Required.** File attachment reference. > > **id** `string` > > The row’s id, unique in its array. > > **weight** `Weight | null` > > Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`. > > **style** `Style | null` > > Style. One of `normal`, `italic`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **fallback** `Fallback | null` > > Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **instagramCtaLabel** `string` > > The visible button text. Leave empty to hide the button. > > **instagramCtaUrl** `string` > > Where the button goes — a path (/blog) or full URL. > > **instagramCtaNewTab** `boolean` > > Opens the link in a new browser tab (adds rel="noopener noreferrer"). > > **instagramCtaVariant** `InstagramCtaVariant | null` > > Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`. > > **instagramCtaSize** `InstagramCtaSize | null` > > Button size. One of `small`, `normal`, `large`. > > **instagramCtaRadius** `InstagramCtaRadius | null` > > Corner radius. One of `pill`, `rounded`, `slight`, `square`. > > **instagramCtaColor** `string | null` > > Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. > > **instagramCtaColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) > > **instagramCtaTextColor** `string | null` > > The text/icon color. Clear it to derive from the button color (readable on solid fills). > > **instagramCtaTextColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme label color. > > **instagramCtaHoverColor** `string | null` > > Optional. Drives the hover treatment. Leave empty to derive it from the button color. > > **instagramCtaHoverColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme hover color. > > **instagramCtaStyle** `InstagramCtaStyle | null` > > The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`. > > **instagramCtaShadowColor** `string | null` > > Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. > > **instagramCtaShadowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme shadow color. > > **instagramCtaAnimation** `InstagramCtaAnimation | null` > > Hover motion. One of `lift`, `scale`, `lift-scale`, `none`. > > **instagramCtaIcon** `string` > > Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. > > **instagramCtaIconFamily** `InstagramCtaIconFamily | null` > > Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`. > > **instagramCtaIconPosition** `InstagramCtaIconPosition | null` > > Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`. > > **instagramCtaIconNudge** `boolean` > > The icon slides toward its side on hover (e.g. an arrow edges outward). > > **sectionCss** `CustomCSS | null` > > A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **GalleryPreviewWidget** > > A `gallery-preview` widget: its `type` and its own fields. A field left out takes its default. > > **type** `GalleryPreviewWidgetType` *required* > > **Required.** The widget’s type: always `gallery-preview`. One of `gallery-preview`. > > **id** `string` > > The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. > > **metaType** `MetaType` > > Always `widget`. One of `widget`. > > **galleryEyebrow** `string` > > Small label shown above the title. > > **galleryEyebrowColor** `string | null` > > Optional. Overrides the eyebrow + its dash. Leave empty to use the secondary (mint) color. > > **galleryEyebrowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color, then the mint default. > > **galleryEyebrowWeight** `GalleryEyebrowWeight | null` > > Eyebrow weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **galleryEyebrowSize** `GalleryEyebrowSize | null` > > Eyebrow size. One of `small`, `normal`, `large`, `xlarge`. > > **galleryHeading** `string` > > Optional. Leave empty to show just the photos. > > **galleryHeadingColor** `string | null` > > Optional — leave empty to track the theme text color. > > **galleryHeadingColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **galleryHeadingWeight** `GalleryHeadingWeight | null` > > Heading weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **galleryIntro** `string` > > Optional short sentence under the heading. > > **galleryIntroColor** `string | null` > > Optional — leave empty to use the muted text color. > > **galleryIntroColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **galleryIntroWeight** `GalleryIntroWeight | null` > > Intro weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **galleryIntroSize** `GalleryIntroSize | null` > > Intro size. One of `small`, `normal`, `large`, `xlarge`. > > **galleryAlign** `GalleryAlign | null` > > Header alignment. One of `center`, `left`. > > **gallerySource** `GallerySource | null` > > Album: a curated set you pick and order by hand — best for a designed page. Folder: automatically shows every image filed in a media-library folder (newest first) — best for bulk collections you organize in the media manager. Feed: a set that refreshes itself on a schedule from an external photo store, so the gallery shows different photos over time. One of `album`, `folder`, `feed`. > > **album** `readonly Readonly\\>[]` > > The Photo Album to display. Create and fill albums in the Photo Albums manager. The related `photo-album` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document (one at most); a document the site can’t find is left out. At most 1 items. > > **galleryFolder** `readonly Readonly\\>[]` > > The media-library folder to display. Every image filed in it (and its subfolders, if enabled) is shown, newest first. The related `image-folder` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document (one at most); a document the site can’t find is left out. At most 1 items. > > **galleryIncludeSubfolders** `boolean` > > Also show images filed in folders inside the selected folder. > > **photoFeed** `readonly Readonly\\>[]` > > The Photo Feed to display. This gallery stays pointed at the feed while the feed replaces its photos on its own schedule. Create and configure feeds in the Photo Feeds manager. The related `photo-feed` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document (one at most); a document the site can’t find is left out. At most 1 items. > > **galleryMaxPhotos** `number | null` > > Cap the teaser to this many photos. 0 shows everything in the selected source (folder photos are newest-first). 0 to 200. > > **galleryLayout** `GalleryLayout | null` > > Mosaic Photo Wall: an edge-to-edge wall where rows are scaled to a common height (like Flickr / Google Photos), cropped around each photo’s focal point — the richest option. Masonry: a staggered grid that hugs each photo’s shape. Grid: a tidy, uniform grid. Spotlight: every group of eight opens on an oversized lead photo, sides alternating on wide screens. Shaped Tiles: a portrait grid whose tiles cycle through slab, arch and orb shapes. Scrolling Banner: one edge-to-edge row that drifts sideways forever, so a long album reads as a ribbon of photos rather than a block — the option for a band between two sections rather than a gallery page. Panorama Wall: several rows, far wider than the screen, traveling sideways at slightly different speeds — and the visitor can push it along or against with a drag or a trackpad swipe. Vertical Ribbon: a band of columns running down the page instead of across it, neighboring columns traveling opposite ways, so the section reads as a moving curtain of photographs. One of `justified`, `masonry`, `grid`, `spotlight`, `shaped`, `banner`, `panorama`, `ribbon`. > > **galleryColumns** `GalleryColumns | null` > > How many tiles per row (grid, shaped tiles) or columns (masonry). Auto fits as many as comfortably fit. (The Mosaic Photo Wall sets its own row layout; Spotlight sets its own pattern.) One of `auto`, `2`, `3`, `4`, `5`. > > **galleryJustifiedHeight** `GalleryJustifiedHeight | null` > > The target height of each row in the Mosaic Photo Wall. Taller rows show fewer, bigger photos per row. One of `compact`, `normal`, `tall`. > > **galleryBannerHeight** `GalleryBannerHeight | null` > > How tall the moving row stands. Each photo keeps its own shape, so a taller banner shows wider photos and fewer of them at once. One of `short`, `normal`, `tall`. > > **galleryBannerSpeed** `GalleryBannerSpeed | null` > > How fast the row drifts. It also surges briefly with the page’s own scrolling, then settles back — so the band reacts to the visitor instead of ignoring them. One of `slow`, `normal`, `fast`. > > **galleryBannerDirection** `GalleryBannerDirection | null` > > Banner direction. One of `left`, `right`. > > **galleryBannerFade** `boolean` > > Fades the row out at both ends so photos scroll in and out instead of being cut off by a hard edge. > > **galleryPanoramaRows** `GalleryPanoramaRows | null` > > How many rows of photos the wall is dealt across. Photos go into the rows in turn, so consecutive shots land in different rows rather than stacking up together. Deep walls want a big set — a row needs at least three photos of its own, so a small album quietly uses fewer, fuller rows than you pick here. One of `2`, `3`, `4`, `5`, `6`, `7`, `8`. > > **galleryPanoramaHeight** `GalleryPanoramaHeight | null` > > How tall each row stands, so the wall’s total depth is this times the number of rows — an eight-row Tall panorama fills a screen and then some. Each photo keeps its own shape, so taller rows show wider photos and fewer of them. One of `short`, `normal`, `tall`. > > **galleryPanoramaSpeed** `GalleryPanoramaSpeed | null` > > How fast the wall travels. Each row takes a slightly different share of this, so the rows shear gently against each other and the block reads as depth rather than as one sliding sheet. It also surges briefly with the page’s own scrolling, then settles back. One of `slow`, `normal`, `fast`. > > **galleryPanoramaDirection** `GalleryPanoramaDirection | null` > > Travel direction. One of `left`, `right`. > > **galleryPanoramaDrag** `boolean` > > Dragging the wall (or swiping sideways on a trackpad or phone) pushes it along or against its travel, and it glides back into its own pace when let go. Vertical scrolling always still scrolls the page. Needs site animations on in Site design → Motion. > > **galleryPanoramaFade** `boolean` > > Fades the rows out at both ends so photos travel in and out instead of being cut off by a hard edge. > > **galleryRibbonColumns** `GalleryRibbonColumns | null` > > How many columns of photos the band is dealt across. Photos go into the columns in turn, so consecutive shots land in different columns rather than stacking up together. Narrow screens show fewer columns than you pick here (two on a phone, three on a tablet) — because photos in a 50-pixel sliver are not photos. A column needs at least three photos of its own, so a small album quietly uses fewer, fuller columns. One of `2`, `3`, `4`, `5`, `6`. > > **galleryRibbonHeight** `GalleryRibbonHeight | null` > > How tall the band stands — the window the columns travel through, not the columns themselves, which are always far taller than it. Each photo keeps its own shape and fills its column’s width, so the columns show more photos at once the taller the band is. One of `short`, `normal`, `tall`. > > **galleryRibbonSpeed** `GalleryRibbonSpeed | null` > > How fast the columns travel. Each takes a slightly different share of this, so the band reads as a weave rather than as one sheet sliding. Slower than the sideways layouts at every setting on purpose: this moves along the same axis the visitor scrolls in, where the same speed feels far more urgent. It also surges briefly with the page’s own scrolling, then settles back. One of `slow`, `normal`, `fast`. > > **galleryRibbonDirection** `GalleryRibbonDirection | null` > > Which way the first column travels. With alternating columns on (below), its neighbors go the other way. One of `up`, `down`. > > **galleryRibbonAlternate** `boolean` > > Send neighboring columns opposite ways, which is what makes the band read as a weave. Turn it off and the whole band travels one way together — quieter, and closer to a conventional scrolling wall. > > **galleryRibbonFade** `boolean` > > Fades the columns out at the top and bottom so photos travel in and out instead of being cut off by a hard edge. > > **galleryJustifiedVary** `boolean` > > For albums where every photo is the same shape (e.g. all square): assign each tile a varied shape (cropped around its focal point, never cutting the subject) so the wall still reads as an organic mosaic. Leave off when your photos already vary. > > **galleryGap** `GalleryGap | null` > > Gap between tiles. One of `tight`, `normal`, `roomy`. > > **galleryRadius** `GalleryRadius | null` > > Corner radius. One of `none`, `slight`, `rounded`. > > **galleryCardStyle** `GalleryCardStyle | null` > > The tile surface. Raised floats each photo on a soft shadow (default); Plain is a clean edge-to-edge wall; Luxe / Outline / Poster frame it; Ticket / Bracket / Forge / Press add graphic structure. The photo fills the tile, so fill-based looks (Tint, Inlay) read as their frame + elevation. On the Shaped Tiles layout the structural looks (Ticket / Bracket / Forge / Press) fall back to their plain surface — their rectangular marks can’t follow an arch or orb. One of `raised`, `luxe`, `outline`, `plain`, `poster`, `edge`, `tint`, `ticket`, `bracket`, `forge`, `press`, `inlay`. > > **galleryCardStyleAccentColor** `string | null` > > Colors the Spine rail, Bracket marks, Forge corner/frame and Press margin rule. Leave empty to use the brand accent. > > **galleryCardStyleAccentColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **galleryCardStyleForgeScope** `GalleryCardStyleForgeScope | null` > > Where the Forge plate wears its color: a single corner mark (the machinist’s datum, default) or the whole engraved frame. One of `corner`, `frame`. > > **galleryCardStyleForgeWeight** `GalleryCardStyleForgeWeight | null` > > Thickness of the Forge corner mark / colored frame. One of `fine`, `medium`, `bold`. > > **galleryCardHover** `GalleryCardHover | null` > > What a tile does on hover, on top of the surface above. Glow (default) / Lift read best on photo tiles; Press collapses a Poster offset; Tilt, Magnetic and Spotlight follow the cursor (need site animations on). This is on top of the image zoom. One of `none`, `lift`, `pop`, `press`, `glow`, `border`, `sheen`, `tilt`, `magnetic`, `spotlight`. > > **galleryShowCaption** `boolean` > > Overlay each photo’s alt text on hover. Off by default (a clean photo wall). The caption always shows in the lightbox. > > **galleryCaptionSize** `GalleryCaptionSize | null` > > Caption size. One of `small`, `normal`, `large`, `xlarge`. > > **galleryCaptionWeight** `GalleryCaptionWeight | null` > > Caption weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **galleryLightbox** `boolean` > > Clicking a photo opens it full-size in an on-site lightbox (with previous / next). Turn off for a purely decorative wall that doesn’t enlarge. > > **galleryAccentColor** `string | null` > > Optional — color of the hover wash / glow. Leave empty to use the brand accent. > > **galleryAccentColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **galleryDrift** `GalleryDrift | null` > > A very slow pan-and-zoom on every photo, each tile on its own rhythm, so the wall stays quietly alive instead of holding perfectly still. Off by default: a still gallery costs nothing to keep on screen, and this runs continuously for as long as the page is open. Turn it on if you also switch on “Rotate photos automatically” below — a photo changing on a wall that is otherwise frozen reads as a glitch. Skipped for visitors who ask for reduced motion, and when site animations are off in Site design → Motion. One of `off`, `subtle`, `bold`. > > **galleryParallax** `GalleryParallax | null` > > Sets every photo at its own depth: as the page scrolls, some slide with it and some against it, so the wall has layers instead of being one flat plane. It only moves while the visitor scrolls — nothing happens when the page is still. Skipped for visitors who ask for reduced motion, and when site animations are off in Site design → Motion. One of `off`, `subtle`, `bold`. > > **galleryShuffle** `GalleryShuffle | null` > > Every so often two photos trade places on the wall, gliding past each other into their new squares. Nothing resizes and nothing else on the wall moves — the grid’s squares are identical, so the photos simply swap seats. It holds still while a visitor’s pointer or keyboard is anywhere in the gallery, so nothing ever moves out from under a click. Skipped for visitors who ask for reduced motion, and when site animations are off in Site design → Motion. One of `off`, `calm`, `steady`, `lively`. > > **galleryShuffleBatch** `number | null` > > Two photos swap with each other; three or more pass their seats along in a ring, so more of the wall is moving at once. Higher numbers read as the wall dealing itself a new hand rather than as two photos changing places. 2 to 6. > > **galleryRotate** `boolean` > > Photos fade out a few at a time and are replaced from the rest of the source, so the gallery keeps changing while a visitor watches. Needs more photos in the source than are on screen — set “Maximum photos” above to less than the source holds. Set “Ambient drift” above to Subtle as well: a photo changing on a wall that is otherwise perfectly still reads as a glitch rather than as movement. Skipped for visitors who ask for reduced motion, and when site animations are off in Site design → Motion. > > **galleryRotateStyle** `GalleryRotateStyle | null` > > Cross-fade: the next photo dissolves over the old one as it eases in — the quietest change. Fade through a color: the tile also dips towards a flat color while the photos dissolve, so it reads as “phasing out” without ever going blank. Slide in: the next photo travels in over the old one, which drifts the same way behind it. Zoom through: the next photo settles out of a slight enlargement. Soften through: the photo blurs out of focus and the next one comes back into it. Wipe across: a clean edge travels over the tile, leaving the next photo behind it. Turn over: the tile turns like a card and comes back showing the next photo — the boldest of the seven. One of `cross`, `veil`, `push`, `scale`, `blur`, `wipe`, `turn`. > > **galleryRotateOrder** `GalleryRotateOrder | null` > > Scattered spreads the changes over the whole wall, never twice in the same corner and never the same tile twice in a row. The other three move through the wall in a set direction, so the changes read as one gesture crossing the gallery rather than as separate events. One of `scatter`, `wave`, `columns`, `rows`. > > **galleryRotateColor** `string | null` > > Optional — leave empty to dip through the page background, which suits both themes. Set white for a brighter bloom, or the brand accent for a bolder pulse. The dip never reaches full strength, so the photo always shows through. > > **galleryRotateColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **galleryRotatePace** `GalleryRotatePace | null` > > The gap between one group of changes and the next. The real timing is deliberately uneven around this figure so the wall never feels metronomic. One of `calm`, `steady`, `lively`, `rapid`. > > **galleryRotateBatch** `number | null` > > How many tiles change per group. They never start on the same frame — each one follows the one before it by a beat, so a group reads as a ripple rather than a blink. 1 is the calmest; higher numbers keep more of the wall in motion. 1 to 6. > > **galleryRotateFade** `GalleryRotateFade | null` > > The length of one change, from the old photo to the new. Longer reads as a gentle phase; shorter as a snap — and short changes are the ones that read as choppy, so lean long. One of `quick`, `normal`, `slow`, `lingering`. > > **galleryRotateReserve** `number | null` > > How many photos beyond the ones on screen to send to the browser for the rotation to draw from — the bigger this is, the longer the gallery goes before a visitor sees a repeat. Retired photos go back to the end of the queue, so it cycles the whole reserve and then starts over. Cheap to raise: a reserved photo is a few URLs, well under 100 bytes once the page is compressed, and its image file is only fetched when it is about to appear. 0 to 500. > > **galleryBg** `GalleryBg | null` > > The section’s full-width background band in dark mode. Transparent lets the page background show through. The palette options track the site colors; choose “Custom color…” for a specific color. One of `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`. > > **galleryBgCustom** `string | null` > > Used when “Section background (dark theme)” is set to Custom color. > > **galleryBgLight** `GalleryBgLight | null` > > “Match dark theme” reuses the dark-theme choice; otherwise set the light-mode band independently. One of `inherit`, `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`. > > **galleryBgLightCustom** `string | null` > > Used when “Section background (light theme)” is set to Custom color. > > **galleryFontOverrides** `readonly GalleryPreviewWidgetGalleryFontOverridesItem[]` > > A list of `GalleryPreviewWidgetGalleryFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. > > **GalleryPreviewWidgetGalleryFontOverridesItem** > > **id** `string` > > The row’s id, unique in its array. > > **target** `Target | null` > > Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`. > > **source** `Source | null` > > Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`. > > **slot** `Slot | null` > > Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`. > > **curated** `Curated | null` > > Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`. > > **cdnProvider** `CdnProvider | null` > > Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`. > > **cdnFamily** `string` > > Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. > > **cdnWeights** `string` > > Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. > > **uploads** `readonly GalleryPreviewWidgetGalleryFontOverridesItemUploadsItem[]` > > A list of `GalleryPreviewWidgetGalleryFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. > > **GalleryPreviewWidgetGalleryFontOverridesItemUploadsItem** > > **file** `Readonly\\>` *required* > > **Required.** File attachment reference. > > **id** `string` > > The row’s id, unique in its array. > > **weight** `Weight | null` > > Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`. > > **style** `Style | null` > > Style. One of `normal`, `italic`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **fallback** `Fallback | null` > > Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **galleryCtaLabel** `string` > > The visible button text. Leave empty to hide the button. > > **galleryCtaUrl** `string` > > Where the button goes — a path (/blog) or full URL. > > **galleryCtaNewTab** `boolean` > > Opens the link in a new browser tab (adds rel="noopener noreferrer"). > > **galleryCtaVariant** `GalleryCtaVariant | null` > > Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`. > > **galleryCtaSize** `GalleryCtaSize | null` > > Button size. One of `small`, `normal`, `large`. > > **galleryCtaRadius** `GalleryCtaRadius | null` > > Corner radius. One of `pill`, `rounded`, `slight`, `square`. > > **galleryCtaColor** `string | null` > > Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. > > **galleryCtaColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) > > **galleryCtaTextColor** `string | null` > > The text/icon color. Clear it to derive from the button color (readable on solid fills). > > **galleryCtaTextColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme label color. > > **galleryCtaHoverColor** `string | null` > > Optional. Drives the hover treatment. Leave empty to derive it from the button color. > > **galleryCtaHoverColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme hover color. > > **galleryCtaStyle** `GalleryCtaStyle | null` > > The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`. > > **galleryCtaShadowColor** `string | null` > > Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. > > **galleryCtaShadowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme shadow color. > > **galleryCtaAnimation** `GalleryCtaAnimation | null` > > Hover motion. One of `lift`, `scale`, `lift-scale`, `none`. > > **galleryCtaIcon** `string` > > Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. > > **galleryCtaIconFamily** `GalleryCtaIconFamily | null` > > Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`. > > **galleryCtaIconPosition** `GalleryCtaIconPosition | null` > > Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`. > > **galleryCtaIconNudge** `boolean` > > The icon slides toward its side on hover (e.g. an arrow edges outward). > > **sectionCss** `CustomCSS | null` > > A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **GalleryFullWidget** > > A `gallery-full` widget: its `type` and its own fields. A field left out takes its default. > > **type** `GalleryFullWidgetType` *required* > > **Required.** The widget’s type: always `gallery-full`. One of `gallery-full`. > > **id** `string` > > The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. > > **metaType** `MetaType` > > Always `widget`. One of `widget`. > > **galleryEyebrow** `string` > > Small label shown above the title. > > **galleryEyebrowColor** `string | null` > > Optional. Overrides the eyebrow + its dash. Leave empty to use the secondary (mint) color. > > **galleryEyebrowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color, then the mint default. > > **galleryEyebrowWeight** `GalleryEyebrowWeight | null` > > Eyebrow weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **galleryEyebrowSize** `GalleryEyebrowSize | null` > > Eyebrow size. One of `small`, `normal`, `large`, `xlarge`. > > **galleryHeading** `string` > > Optional. Leave empty to show just the photos. > > **galleryHeadingColor** `string | null` > > Optional — leave empty to track the theme text color. > > **galleryHeadingColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **galleryHeadingWeight** `GalleryHeadingWeight | null` > > Heading weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **galleryIntro** `string` > > Optional short sentence under the heading. > > **galleryIntroColor** `string | null` > > Optional — leave empty to use the muted text color. > > **galleryIntroColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **galleryIntroWeight** `GalleryIntroWeight | null` > > Intro weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **galleryIntroSize** `GalleryIntroSize | null` > > Intro size. One of `small`, `normal`, `large`, `xlarge`. > > **galleryAlign** `GalleryAlign | null` > > Header alignment. One of `center`, `left`. > > **gallerySource** `GallerySource | null` > > Album: a curated set you pick and order by hand — best for a designed page. Folder: automatically shows every image filed in a media-library folder (newest first) — best for bulk collections you organize in the media manager. Feed: a set that refreshes itself on a schedule from an external photo store, so the gallery shows different photos over time. One of `album`, `folder`, `feed`. > > **album** `readonly Readonly\\>[]` > > The Photo Album to display. Create and fill albums in the Photo Albums manager. The related `photo-album` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document (one at most); a document the site can’t find is left out. At most 1 items. > > **galleryFolder** `readonly Readonly\\>[]` > > The media-library folder to display. Every image filed in it (and its subfolders, if enabled) is shown, newest first. The related `image-folder` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document (one at most); a document the site can’t find is left out. At most 1 items. > > **galleryIncludeSubfolders** `boolean` > > Also show images filed in folders inside the selected folder. > > **photoFeed** `readonly Readonly\\>[]` > > The Photo Feed to display. This gallery stays pointed at the feed while the feed replaces its photos on its own schedule. Create and configure feeds in the Photo Feeds manager. The related `photo-feed` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document (one at most); a document the site can’t find is left out. At most 1 items. > > **galleryMaxPhotos** `number | null` > > The most photos to show. 0 (default) shows everything in the selected source (folder photos are newest-first). 0 to 200. > > **galleryLayout** `GalleryLayout | null` > > Mosaic Photo Wall: an edge-to-edge wall where rows are scaled to a common height (like Flickr / Google Photos), cropped around each photo’s focal point — the richest option. Masonry: a staggered grid that hugs each photo’s shape. Grid: a tidy, uniform grid. Spotlight: every group of eight opens on an oversized lead photo, sides alternating on wide screens. Shaped Tiles: a portrait grid whose tiles cycle through slab, arch and orb shapes. Scrolling Banner: one edge-to-edge row that drifts sideways forever, so a long album reads as a ribbon of photos rather than a block — the option for a band between two sections rather than a gallery page. Panorama Wall: several rows, far wider than the screen, traveling sideways at slightly different speeds — and the visitor can push it along or against with a drag or a trackpad swipe. Vertical Ribbon: a band of columns running down the page instead of across it, neighboring columns traveling opposite ways, so the section reads as a moving curtain of photographs. One of `justified`, `masonry`, `grid`, `spotlight`, `shaped`, `banner`, `panorama`, `ribbon`. > > **galleryColumns** `GalleryColumns | null` > > How many tiles per row (grid, shaped tiles) or columns (masonry). Auto fits as many as comfortably fit. (The Mosaic Photo Wall sets its own row layout; Spotlight sets its own pattern.) One of `auto`, `2`, `3`, `4`, `5`. > > **galleryJustifiedHeight** `GalleryJustifiedHeight | null` > > The target height of each row in the Mosaic Photo Wall. Taller rows show fewer, bigger photos per row. One of `compact`, `normal`, `tall`. > > **galleryBannerHeight** `GalleryBannerHeight | null` > > How tall the moving row stands. Each photo keeps its own shape, so a taller banner shows wider photos and fewer of them at once. One of `short`, `normal`, `tall`. > > **galleryBannerSpeed** `GalleryBannerSpeed | null` > > How fast the row drifts. It also surges briefly with the page’s own scrolling, then settles back — so the band reacts to the visitor instead of ignoring them. One of `slow`, `normal`, `fast`. > > **galleryBannerDirection** `GalleryBannerDirection | null` > > Banner direction. One of `left`, `right`. > > **galleryBannerFade** `boolean` > > Fades the row out at both ends so photos scroll in and out instead of being cut off by a hard edge. > > **galleryPanoramaRows** `GalleryPanoramaRows | null` > > How many rows of photos the wall is dealt across. Photos go into the rows in turn, so consecutive shots land in different rows rather than stacking up together. Deep walls want a big set — a row needs at least three photos of its own, so a small album quietly uses fewer, fuller rows than you pick here. One of `2`, `3`, `4`, `5`, `6`, `7`, `8`. > > **galleryPanoramaHeight** `GalleryPanoramaHeight | null` > > How tall each row stands, so the wall’s total depth is this times the number of rows — an eight-row Tall panorama fills a screen and then some. Each photo keeps its own shape, so taller rows show wider photos and fewer of them. One of `short`, `normal`, `tall`. > > **galleryPanoramaSpeed** `GalleryPanoramaSpeed | null` > > How fast the wall travels. Each row takes a slightly different share of this, so the rows shear gently against each other and the block reads as depth rather than as one sliding sheet. It also surges briefly with the page’s own scrolling, then settles back. One of `slow`, `normal`, `fast`. > > **galleryPanoramaDirection** `GalleryPanoramaDirection | null` > > Travel direction. One of `left`, `right`. > > **galleryPanoramaDrag** `boolean` > > Dragging the wall (or swiping sideways on a trackpad or phone) pushes it along or against its travel, and it glides back into its own pace when let go. Vertical scrolling always still scrolls the page. Needs site animations on in Site design → Motion. > > **galleryPanoramaFade** `boolean` > > Fades the rows out at both ends so photos travel in and out instead of being cut off by a hard edge. > > **galleryRibbonColumns** `GalleryRibbonColumns | null` > > How many columns of photos the band is dealt across. Photos go into the columns in turn, so consecutive shots land in different columns rather than stacking up together. Narrow screens show fewer columns than you pick here (two on a phone, three on a tablet) — because photos in a 50-pixel sliver are not photos. A column needs at least three photos of its own, so a small album quietly uses fewer, fuller columns. One of `2`, `3`, `4`, `5`, `6`. > > **galleryRibbonHeight** `GalleryRibbonHeight | null` > > How tall the band stands — the window the columns travel through, not the columns themselves, which are always far taller than it. Each photo keeps its own shape and fills its column’s width, so the columns show more photos at once the taller the band is. One of `short`, `normal`, `tall`. > > **galleryRibbonSpeed** `GalleryRibbonSpeed | null` > > How fast the columns travel. Each takes a slightly different share of this, so the band reads as a weave rather than as one sheet sliding. Slower than the sideways layouts at every setting on purpose: this moves along the same axis the visitor scrolls in, where the same speed feels far more urgent. It also surges briefly with the page’s own scrolling, then settles back. One of `slow`, `normal`, `fast`. > > **galleryRibbonDirection** `GalleryRibbonDirection | null` > > Which way the first column travels. With alternating columns on (below), its neighbors go the other way. One of `up`, `down`. > > **galleryRibbonAlternate** `boolean` > > Send neighboring columns opposite ways, which is what makes the band read as a weave. Turn it off and the whole band travels one way together — quieter, and closer to a conventional scrolling wall. > > **galleryRibbonFade** `boolean` > > Fades the columns out at the top and bottom so photos travel in and out instead of being cut off by a hard edge. > > **galleryJustifiedVary** `boolean` > > For albums where every photo is the same shape (e.g. all square): assign each tile a varied shape (cropped around its focal point, never cutting the subject) so the wall still reads as an organic mosaic. Leave off when your photos already vary. > > **galleryGap** `GalleryGap | null` > > Gap between tiles. One of `tight`, `normal`, `roomy`. > > **galleryRadius** `GalleryRadius | null` > > Corner radius. One of `none`, `slight`, `rounded`. > > **galleryCardStyle** `GalleryCardStyle | null` > > The tile surface. Raised floats each photo on a soft shadow (default); Plain is a clean edge-to-edge wall; Luxe / Outline / Poster frame it; Ticket / Bracket / Forge / Press add graphic structure. The photo fills the tile, so fill-based looks (Tint, Inlay) read as their frame + elevation. On the Shaped Tiles layout the structural looks (Ticket / Bracket / Forge / Press) fall back to their plain surface — their rectangular marks can’t follow an arch or orb. One of `raised`, `luxe`, `outline`, `plain`, `poster`, `edge`, `tint`, `ticket`, `bracket`, `forge`, `press`, `inlay`. > > **galleryCardStyleAccentColor** `string | null` > > Colors the Spine rail, Bracket marks, Forge corner/frame and Press margin rule. Leave empty to use the brand accent. > > **galleryCardStyleAccentColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **galleryCardStyleForgeScope** `GalleryCardStyleForgeScope | null` > > Where the Forge plate wears its color: a single corner mark (the machinist’s datum, default) or the whole engraved frame. One of `corner`, `frame`. > > **galleryCardStyleForgeWeight** `GalleryCardStyleForgeWeight | null` > > Thickness of the Forge corner mark / colored frame. One of `fine`, `medium`, `bold`. > > **galleryCardHover** `GalleryCardHover | null` > > What a tile does on hover, on top of the surface above. Glow (default) / Lift read best on photo tiles; Press collapses a Poster offset; Tilt, Magnetic and Spotlight follow the cursor (need site animations on). This is on top of the image zoom. One of `none`, `lift`, `pop`, `press`, `glow`, `border`, `sheen`, `tilt`, `magnetic`, `spotlight`. > > **galleryShowCaption** `boolean` > > Overlay each photo’s alt text on hover. Off by default (a clean photo wall). The caption always shows in the lightbox. > > **galleryCaptionSize** `GalleryCaptionSize | null` > > Caption size. One of `small`, `normal`, `large`, `xlarge`. > > **galleryCaptionWeight** `GalleryCaptionWeight | null` > > Caption weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **galleryLightbox** `boolean` > > Clicking a photo opens it full-size in an on-site lightbox (with previous / next). Turn off for a purely decorative wall that doesn’t enlarge. > > **galleryAccentColor** `string | null` > > Optional — color of the hover wash / glow. Leave empty to use the brand accent. > > **galleryAccentColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **galleryDrift** `GalleryDrift | null` > > A very slow pan-and-zoom on every photo, each tile on its own rhythm, so the wall stays quietly alive instead of holding perfectly still. Off by default: a still gallery costs nothing to keep on screen, and this runs continuously for as long as the page is open. Turn it on if you also switch on “Rotate photos automatically” below — a photo changing on a wall that is otherwise frozen reads as a glitch. Skipped for visitors who ask for reduced motion, and when site animations are off in Site design → Motion. One of `off`, `subtle`, `bold`. > > **galleryParallax** `GalleryParallax | null` > > Sets every photo at its own depth: as the page scrolls, some slide with it and some against it, so the wall has layers instead of being one flat plane. It only moves while the visitor scrolls — nothing happens when the page is still. Skipped for visitors who ask for reduced motion, and when site animations are off in Site design → Motion. One of `off`, `subtle`, `bold`. > > **galleryShuffle** `GalleryShuffle | null` > > Every so often two photos trade places on the wall, gliding past each other into their new squares. Nothing resizes and nothing else on the wall moves — the grid’s squares are identical, so the photos simply swap seats. It holds still while a visitor’s pointer or keyboard is anywhere in the gallery, so nothing ever moves out from under a click. Skipped for visitors who ask for reduced motion, and when site animations are off in Site design → Motion. One of `off`, `calm`, `steady`, `lively`. > > **galleryShuffleBatch** `number | null` > > Two photos swap with each other; three or more pass their seats along in a ring, so more of the wall is moving at once. Higher numbers read as the wall dealing itself a new hand rather than as two photos changing places. 2 to 6. > > **galleryRotate** `boolean` > > Photos fade out a few at a time and are replaced from the rest of the source, so the gallery keeps changing while a visitor watches. Needs more photos in the source than are on screen — set “Maximum photos” above to less than the source holds. Set “Ambient drift” above to Subtle as well: a photo changing on a wall that is otherwise perfectly still reads as a glitch rather than as movement. Skipped for visitors who ask for reduced motion, and when site animations are off in Site design → Motion. > > **galleryRotateStyle** `GalleryRotateStyle | null` > > Cross-fade: the next photo dissolves over the old one as it eases in — the quietest change. Fade through a color: the tile also dips towards a flat color while the photos dissolve, so it reads as “phasing out” without ever going blank. Slide in: the next photo travels in over the old one, which drifts the same way behind it. Zoom through: the next photo settles out of a slight enlargement. Soften through: the photo blurs out of focus and the next one comes back into it. Wipe across: a clean edge travels over the tile, leaving the next photo behind it. Turn over: the tile turns like a card and comes back showing the next photo — the boldest of the seven. One of `cross`, `veil`, `push`, `scale`, `blur`, `wipe`, `turn`. > > **galleryRotateOrder** `GalleryRotateOrder | null` > > Scattered spreads the changes over the whole wall, never twice in the same corner and never the same tile twice in a row. The other three move through the wall in a set direction, so the changes read as one gesture crossing the gallery rather than as separate events. One of `scatter`, `wave`, `columns`, `rows`. > > **galleryRotateColor** `string | null` > > Optional — leave empty to dip through the page background, which suits both themes. Set white for a brighter bloom, or the brand accent for a bolder pulse. The dip never reaches full strength, so the photo always shows through. > > **galleryRotateColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **galleryRotatePace** `GalleryRotatePace | null` > > The gap between one group of changes and the next. The real timing is deliberately uneven around this figure so the wall never feels metronomic. One of `calm`, `steady`, `lively`, `rapid`. > > **galleryRotateBatch** `number | null` > > How many tiles change per group. They never start on the same frame — each one follows the one before it by a beat, so a group reads as a ripple rather than a blink. 1 is the calmest; higher numbers keep more of the wall in motion. 1 to 6. > > **galleryRotateFade** `GalleryRotateFade | null` > > The length of one change, from the old photo to the new. Longer reads as a gentle phase; shorter as a snap — and short changes are the ones that read as choppy, so lean long. One of `quick`, `normal`, `slow`, `lingering`. > > **galleryRotateReserve** `number | null` > > How many photos beyond the ones on screen to send to the browser for the rotation to draw from — the bigger this is, the longer the gallery goes before a visitor sees a repeat. Retired photos go back to the end of the queue, so it cycles the whole reserve and then starts over. Cheap to raise: a reserved photo is a few URLs, well under 100 bytes once the page is compressed, and its image file is only fetched when it is about to appear. 0 to 500. > > **galleryBg** `GalleryBg | null` > > The section’s full-width background band in dark mode. Transparent lets the page background show through. The palette options track the site colors; choose “Custom color…” for a specific color. One of `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`. > > **galleryBgCustom** `string | null` > > Used when “Section background (dark theme)” is set to Custom color. > > **galleryBgLight** `GalleryBgLight | null` > > “Match dark theme” reuses the dark-theme choice; otherwise set the light-mode band independently. One of `inherit`, `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`. > > **galleryBgLightCustom** `string | null` > > Used when “Section background (light theme)” is set to Custom color. > > **galleryFontOverrides** `readonly GalleryFullWidgetGalleryFontOverridesItem[]` > > A list of `GalleryFullWidgetGalleryFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. > > **GalleryFullWidgetGalleryFontOverridesItem** > > **id** `string` > > The row’s id, unique in its array. > > **target** `Target | null` > > Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`. > > **source** `Source | null` > > Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`. > > **slot** `Slot | null` > > Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`. > > **curated** `Curated | null` > > Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`. > > **cdnProvider** `CdnProvider | null` > > Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`. > > **cdnFamily** `string` > > Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. > > **cdnWeights** `string` > > Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. > > **uploads** `readonly GalleryFullWidgetGalleryFontOverridesItemUploadsItem[]` > > A list of `GalleryFullWidgetGalleryFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. > > **GalleryFullWidgetGalleryFontOverridesItemUploadsItem** > > **file** `Readonly\\>` *required* > > **Required.** File attachment reference. > > **id** `string` > > The row’s id, unique in its array. > > **weight** `Weight | null` > > Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`. > > **style** `Style | null` > > Style. One of `normal`, `italic`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **fallback** `Fallback | null` > > Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **galleryCtaLabel** `string` > > The visible button text. Leave empty to hide the button. > > **galleryCtaUrl** `string` > > Where the button goes — a path (/blog) or full URL. > > **galleryCtaNewTab** `boolean` > > Opens the link in a new browser tab (adds rel="noopener noreferrer"). > > **galleryCtaVariant** `GalleryCtaVariant | null` > > Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`. > > **galleryCtaSize** `GalleryCtaSize | null` > > Button size. One of `small`, `normal`, `large`. > > **galleryCtaRadius** `GalleryCtaRadius | null` > > Corner radius. One of `pill`, `rounded`, `slight`, `square`. > > **galleryCtaColor** `string | null` > > Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. > > **galleryCtaColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) > > **galleryCtaTextColor** `string | null` > > The text/icon color. Clear it to derive from the button color (readable on solid fills). > > **galleryCtaTextColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme label color. > > **galleryCtaHoverColor** `string | null` > > Optional. Drives the hover treatment. Leave empty to derive it from the button color. > > **galleryCtaHoverColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme hover color. > > **galleryCtaStyle** `GalleryCtaStyle | null` > > The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`. > > **galleryCtaShadowColor** `string | null` > > Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. > > **galleryCtaShadowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme shadow color. > > **galleryCtaAnimation** `GalleryCtaAnimation | null` > > Hover motion. One of `lift`, `scale`, `lift-scale`, `none`. > > **galleryCtaIcon** `string` > > Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. > > **galleryCtaIconFamily** `GalleryCtaIconFamily | null` > > Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`. > > **galleryCtaIconPosition** `GalleryCtaIconPosition | null` > > Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`. > > **galleryCtaIconNudge** `boolean` > > The icon slides toward its side on hover (e.g. an arrow edges outward). > > **sectionCss** `CustomCSS | null` > > A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **PricingWidget** > > A `pricing` widget: its `type` and its own fields. A field left out takes its default. > > **type** `PricingWidgetType` *required* > > **Required.** The widget’s type: always `pricing`. One of `pricing`. > > **id** `string` > > The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. > > **metaType** `MetaType` > > Always `widget`. One of `widget`. > > **pricingEyebrowEnabled** `boolean` > > A small label above the heading (e.g. "Pricing"). > > **pricingEyebrow** `string` > > Eyebrow. > > **pricingEyebrowColor** `string | null` > > Optional — leave empty to use the secondary (mint) color. > > **pricingEyebrowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **pricingEyebrowWeight** `PricingEyebrowWeight | null` > > Eyebrow weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **pricingEyebrowSize** `PricingEyebrowSize | null` > > Eyebrow size. One of `small`, `normal`, `large`, `xlarge`. > > **pricingHeading** `string` > > Optional. Leave empty to show just the cards. > > **pricingHeadingColor** `string | null` > > Optional — leave empty to track the theme text color. > > **pricingHeadingColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **pricingHeadingWeight** `PricingHeadingWeight | null` > > Heading weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **pricingHeadingSize** `PricingHeadingSize | null` > > Heading size. One of `small`, `normal`, `large`, `xlarge`, `xxlarge`. > > **pricingIntro** `string` > > Optional short sentence under the heading. > > **pricingIntroColor** `string | null` > > Optional — leave empty to use the muted text color. > > **pricingIntroColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **pricingIntroWeight** `PricingIntroWeight | null` > > Intro weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **pricingIntroSize** `PricingIntroSize | null` > > Intro size. One of `small`, `normal`, `large`, `xlarge`, `xxlarge`. > > **pricingColumns** `PricingColumns | null` > > Auto fits as many as comfortably fit and works for any number of cards. Or lock a maximum per row. One of `auto`, `2`, `3`, `4`. > > **pricingGap** `PricingGap | null` > > Gap between cards. One of `tight`, `normal`, `roomy`. > > **pricingCardStyle** `PricingCardStyle | null` > > The base treatment for every tier (a highlighted tier always gets its own bold framed look). Raised is a quiet lit card; Luxe a frosted glass panel; Outline a plaque frame; Spine adds a color rail; Tint an accent wash; Ticket/Bracket/Forge/Press/Inlay are the graphic showstoppers. One of `raised`, `luxe`, `outline`, `plain`, `poster`, `edge`, `tint`, `ticket`, `bracket`, `forge`, `press`, `inlay`. > > **pricingCardStyleRadius** `PricingCardStyleRadius | null` > > Corner rounding for each card. Default keeps the widget’s own tuned corners — except Forge, which defaults to tight machined corners matching its engraved frame. One of `default`, `square`, `slight`, `rounded`, `large`. > > **pricingCardStyleAccentColor** `string | null` > > Colors the Spine rail, Bracket marks, Forge corner/frame and Press margin rule. Leave empty to use the brand accent. > > **pricingCardStyleAccentColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **pricingCardStyleForgeScope** `PricingCardStyleForgeScope | null` > > Where the Forge plate wears its color: a single corner mark (the machinist’s datum, default) or the whole engraved frame. One of `corner`, `frame`. > > **pricingCardStyleForgeWeight** `PricingCardStyleForgeWeight | null` > > Thickness of the Forge corner mark / colored frame. One of `fine`, `medium`, `bold`. > > **pricingAlign** `PricingAlign | null` > > Aligns the section header and the text inside each card. One of `center`, `left`. > > **pricingEqualHeight** `boolean` > > Stretch every card to the tallest one and pin each button to the bottom, so the cards line up even with uneven feature lists. > > **pricingFeatureMarkers** `boolean` > > A check (included) or cross (not included) before each feature. Off = a plain list. > > **pricingCardHover** `PricingCardHover | null` > > How a card reacts to the pointer. Rise floats it up on an accent underglow; Selection ring previews the highlighted look + tints the price; Spotlight washes accent light over the price; Checklist lights up the ✓ marks one-by-one; Tilt is a 3-D parallax that only runs when site animations are on. One of `none`, `rise`, `ring`, `spotlight`, `checklist`, `tilt`. > > **pricingHoverColor** `string | null` > > Border / glow / spotlight / checkmark color on hover. Leave empty to use the highlight accent (then the site accent). > > **pricingHoverColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme hover accent. > > **pricingEntrance** `PricingEntrance | null` > > How the cards animate in as they scroll into view. Featured-led makes the highlighted tier settle last with a little emphasis (draws the eye to the recommended plan); Simple stagger fades them in evenly. Only plays when site animations are on (Site design → Motion) — otherwise the cards are simply shown. One of `featured`, `stagger`, `none`. > > **pricingNameSize** `PricingNameSize | null` > > Size of each card’s name / title. One of `small`, `normal`, `large`, `xlarge`, `xxlarge`. > > **pricingPriceSize** `PricingPriceSize | null` > > Size of the price amount (the period and price note scale with it). One of `small`, `normal`, `large`, `xlarge`, `xxlarge`. > > **pricingDescSize** `PricingDescSize | null` > > Size of each card’s description blurb. One of `small`, `normal`, `large`, `xlarge`, `xxlarge`. > > **pricingFeatureSize** `PricingFeatureSize | null` > > Size of the feature list text (notes and check marks scale with it). One of `small`, `normal`, `large`, `xlarge`, `xxlarge`. > > **pricingHighlightBadge** `string` > > Ribbon text shown on a highlighted tier that doesn’t set its own badge. Each tier can override it (or badge a non-highlighted tier) below. Leave empty for no automatic badge. > > **pricingAccentColor** `string | null` > > Color for the highlighted tier’s border + ring and each tier’s badge. Leave empty to use the site accent color. > > **pricingAccentColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme accent. > > **pricingTiers** `readonly PricingWidgetPricingTiersItem[]` > > A list of `PricingWidgetPricingTiersItem`. Each card is one tier / package / service. Toggle “Highlight” on the one you want to stand out. > > **PricingWidgetPricingTiersItem** > > **name** `string` *required* > > **Required.** Tier / package / service name — e.g. "Starter", "Studio", "Agency". > > **id** `string` > > The row’s id, unique in its array. > > **icon** `string` > > Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. > > **iconFamily** `IconFamily | null` > > Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`. > > **iconColor** `string | null` > > Optional — leave empty to use the design’s own color rhythm. > > **iconAnimation** `IconAnimation | null` > > Icon animation. One of `none`, `fa-beat`, `fa-bounce`, `fa-fade`, `fa-beat-fade`, `fa-flip`, `fa-shake`, `fa-spin`. > > **iconSize** `IconSize | null` > > Relative to the component’s base icon size. One of `default`, `sm`, `lg`, `xl`, `2xl`, `2x`, `3x`, `4x`, `5x`. > > **iconGap** `IconGap | null` > > Breathing room below the icon, before the card name. One of `none`, `small`, `normal`, `large`, `xlarge`. > > **badge** `string` > > A small ribbon on the card, e.g. "Best value", "Limited spots". Overrides the default highlight badge for this tier; works on any tier, highlighted or not. Empty on a highlighted tier falls back to the section’s "Default highlight badge". > > **highlighted** `boolean` > > Emphasize this tier — accent border + ring, a subtle lift, and the Featured button look. > > **textAlign** `TextAlign | null` > > How this card’s text lines up. Normal = the section default (a centered section keeps the feature list left-aligned, as now). Center also centers the feature list; Left / Right align everything that way. One of `normal`, `left`, `center`, `right`. > > **price** `string` > > Free text, so it fits any model — "$45", "From $200", "Custom", "Call for quote". > > **period** `string` > > Shown after the price, e.g. "/ month", "per night", "per session". Leave empty for a flat price. > > **priceNote** `string` > > A small line under the price, e.g. "per seat", "billed annually", "+ tax". > > **description** `string` > > A short blurb under the name. > > **features** `readonly PricingWidgetPricingTiersItemFeaturesItem[]` > > A list of `PricingWidgetPricingTiersItemFeaturesItem`. The bullet list of what’s included. > > **PricingWidgetPricingTiersItemFeaturesItem** > > **text** `string` *required* > > **Required.** Feature. > > **id** `string` > > The row’s id, unique in its array. > > **included** `boolean` > > On = a check mark; off = a crossed-out / muted line (e.g. a feature this tier lacks). > > **note** `string` > > A small qualifier shown after the feature, e.g. "up to 5", "add-on". > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **ctaLabel** `string` > > This card’s button text. Leave empty to use the shared button label (set in the Pricing · Buttons tab); clear it everywhere to hide the button. > > **ctaUrl** `string` > > Where the button goes — a path (/contact-us) or full URL. Leave empty to inherit the shared button link. > > **ctaNewTab** `boolean` > > Open button in new tab. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **pricingBg** `PricingBg | null` > > The section’s full-width background band in dark mode. Transparent lets the page background show through. The palette options track the site colors; choose “Custom color…” for a specific color. One of `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`. > > **pricingBgCustom** `string | null` > > Used when “Section background (dark theme)” is set to Custom color. > > **pricingBgLight** `PricingBgLight | null` > > “Match dark theme” reuses the dark-theme choice; otherwise set the light-mode band independently. One of `inherit`, `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`. > > **pricingBgLightCustom** `string | null` > > Used when “Section background (light theme)” is set to Custom color. > > **pricingFontOverrides** `readonly PricingWidgetPricingFontOverridesItem[]` > > A list of `PricingWidgetPricingFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. > > **PricingWidgetPricingFontOverridesItem** > > **id** `string` > > The row’s id, unique in its array. > > **target** `Target | null` > > Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`. > > **source** `Source | null` > > Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`. > > **slot** `Slot | null` > > Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`. > > **curated** `Curated | null` > > Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`. > > **cdnProvider** `CdnProvider | null` > > Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`. > > **cdnFamily** `string` > > Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. > > **cdnWeights** `string` > > Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. > > **uploads** `readonly PricingWidgetPricingFontOverridesItemUploadsItem[]` > > A list of `PricingWidgetPricingFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. > > **PricingWidgetPricingFontOverridesItemUploadsItem** > > **file** `Readonly\\>` *required* > > **Required.** File attachment reference. > > **id** `string` > > The row’s id, unique in its array. > > **weight** `Weight | null` > > Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`. > > **style** `Style | null` > > Style. One of `normal`, `italic`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **fallback** `Fallback | null` > > Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **pricingFeaturedCtaLabel** `string` > > The visible button text. Leave empty to hide the button. > > **pricingFeaturedCtaUrl** `string` > > Where the button goes — a path (/blog) or full URL. > > **pricingFeaturedCtaNewTab** `boolean` > > Opens the link in a new browser tab (adds rel="noopener noreferrer"). > > **pricingFeaturedCtaVariant** `PricingFeaturedCtaVariant | null` > > Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`. > > **pricingFeaturedCtaSize** `PricingFeaturedCtaSize | null` > > Button size. One of `small`, `normal`, `large`. > > **pricingFeaturedCtaRadius** `PricingFeaturedCtaRadius | null` > > Corner radius. One of `pill`, `rounded`, `slight`, `square`. > > **pricingFeaturedCtaColor** `string | null` > > Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. > > **pricingFeaturedCtaColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) > > **pricingFeaturedCtaTextColor** `string | null` > > The text/icon color. Clear it to derive from the button color (readable on solid fills). > > **pricingFeaturedCtaTextColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme label color. > > **pricingFeaturedCtaHoverColor** `string | null` > > Optional. Drives the hover treatment. Leave empty to derive it from the button color. > > **pricingFeaturedCtaHoverColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme hover color. > > **pricingFeaturedCtaStyle** `PricingFeaturedCtaStyle | null` > > The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`. > > **pricingFeaturedCtaShadowColor** `string | null` > > Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. > > **pricingFeaturedCtaShadowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme shadow color. > > **pricingFeaturedCtaAnimation** `PricingFeaturedCtaAnimation | null` > > Hover motion. One of `lift`, `scale`, `lift-scale`, `none`. > > **pricingFeaturedCtaIcon** `string` > > Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. > > **pricingFeaturedCtaIconFamily** `PricingFeaturedCtaIconFamily | null` > > Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`. > > **pricingFeaturedCtaIconPosition** `PricingFeaturedCtaIconPosition | null` > > Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`. > > **pricingFeaturedCtaIconNudge** `boolean` > > The icon slides toward its side on hover (e.g. an arrow edges outward). > > **pricingCtaLabel** `string` > > The visible button text. Leave empty to hide the button. > > **pricingCtaUrl** `string` > > Where the button goes — a path (/blog) or full URL. > > **pricingCtaNewTab** `boolean` > > Opens the link in a new browser tab (adds rel="noopener noreferrer"). > > **pricingCtaVariant** `PricingCtaVariant | null` > > Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`. > > **pricingCtaSize** `PricingCtaSize | null` > > Button size. One of `small`, `normal`, `large`. > > **pricingCtaRadius** `PricingCtaRadius | null` > > Corner radius. One of `pill`, `rounded`, `slight`, `square`. > > **pricingCtaColor** `string | null` > > Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. > > **pricingCtaColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) > > **pricingCtaTextColor** `string | null` > > The text/icon color. Clear it to derive from the button color (readable on solid fills). > > **pricingCtaTextColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme label color. > > **pricingCtaHoverColor** `string | null` > > Optional. Drives the hover treatment. Leave empty to derive it from the button color. > > **pricingCtaHoverColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme hover color. > > **pricingCtaStyle** `PricingCtaStyle | null` > > The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`. > > **pricingCtaShadowColor** `string | null` > > Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. > > **pricingCtaShadowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme shadow color. > > **pricingCtaAnimation** `PricingCtaAnimation | null` > > Hover motion. One of `lift`, `scale`, `lift-scale`, `none`. > > **pricingCtaIcon** `string` > > Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. > > **pricingCtaIconFamily** `PricingCtaIconFamily | null` > > Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`. > > **pricingCtaIconPosition** `PricingCtaIconPosition | null` > > Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`. > > **pricingCtaIconNudge** `boolean` > > The icon slides toward its side on hover (e.g. an arrow edges outward). > > **sectionCss** `CustomCSS | null` > > A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **NewsletterWidget** > > A `newsletter` widget: its `type` and its own fields. A field left out takes its default. > > **type** `NewsletterWidgetType` *required* > > **Required.** The widget’s type: always `newsletter`. One of `newsletter`. > > **id** `string` > > The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. > > **metaType** `MetaType` > > Always `widget`. One of `widget`. > > **newsletterForm** `readonly Readonly\\>[]` > > The Form (Forms manager) that receives these submissions and routes them — configure its destinations on the form’s Actions tab. Create one if you have not yet. The related `@apostrophecms/form` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document (one at most); a document the site can’t find is left out. At most 1 items. > > **newsletterEyebrowEnabled** `boolean` > > Show eyebrow. > > **newsletterEyebrow** `string` > > Small label shown above the title. > > **newsletterEyebrowColor** `string | null` > > Optional. Overrides the eyebrow + its dash. Leave empty to use the secondary (mint) color. > > **newsletterEyebrowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color, then the mint default. > > **newsletterEyebrowWeight** `NewsletterEyebrowWeight | null` > > Eyebrow weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **newsletterEyebrowSize** `NewsletterEyebrowSize | null` > > Eyebrow size. One of `small`, `normal`, `large`, `xlarge`. > > **newsletterHeading** `string` > > Heading. > > **newsletterHeadingColor** `string | null` > > Optional — leave empty to track the theme text color. > > **newsletterHeadingColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **newsletterHeadingWeight** `NewsletterHeadingWeight | null` > > Weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **newsletterHeadingSize** `NewsletterHeadingSize | null` > > Size. One of `small`, `normal`, `large`, `xlarge`, `xxlarge`. > > **newsletterIntro** `string` > > Optional short sentence under the heading. > > **newsletterIntroColor** `string | null` > > Optional — leave empty to use the muted text color. > > **newsletterIntroColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **newsletterIntroWeight** `NewsletterIntroWeight | null` > > Weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **newsletterIntroSize** `NewsletterIntroSize | null` > > Size. One of `small`, `normal`, `large`, `xlarge`, `xxlarge`. > > **newsletterBand** `NewsletterBand | null` > > Plain sits on the page; Raised is a contained card; Accent is a solid brand-color band. One of `plain`, `raised`, `accent`. > > **newsletterAccentColor** `string | null` > > The accent band color. Leave empty to use the site accent color. > > **newsletterAccentColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color, then the accent. > > **newsletterAlign** `NewsletterAlign | null` > > Alignment. One of `center`, `left`. > > **newsletterLayout** `NewsletterLayout | null` > > Inline puts the field + button on one row (stacks on small screens); Stacked always stacks them. One of `inline`, `stacked`. > > **newsletterWidth** `NewsletterWidth | null` > > Content width. One of `narrow`, `normal`, `wide`. > > **newsletterNameEnabled** `boolean` > > Collect a name. > > **newsletterNameLabel** `string` > > Name label. > > **newsletterNamePlaceholder** `string` > > Name placeholder. > > **newsletterEmailLabel** `string` > > Email label. > > **newsletterEmailPlaceholder** `string` > > Email placeholder. > > **newsletterConsentEnabled** `boolean` > > Optional opt-in checkbox (e.g. for GDPR-style explicit consent). > > **newsletterConsentText** `string` > > Consent statement. > > **newsletterDisclaimer** `string` > > A small line under the form, e.g. an unsubscribe note. > > **newsletterSuccessMessage** `string` > > Success message. > > **newsletterErrorMessage** `string` > > Error message. > > **newsletterBg** `NewsletterBg | null` > > The section’s full-width background band in dark mode. Transparent lets the page background show through. The palette options track the site colors; choose “Custom color…” for a specific color. One of `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`. > > **newsletterBgCustom** `string | null` > > Used when “Section background (dark theme)” is set to Custom color. > > **newsletterBgLight** `NewsletterBgLight | null` > > “Match dark theme” reuses the dark-theme choice; otherwise set the light-mode band independently. One of `inherit`, `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`. > > **newsletterBgLightCustom** `string | null` > > Used when “Section background (light theme)” is set to Custom color. > > **newsletterFontOverrides** `readonly NewsletterWidgetNewsletterFontOverridesItem[]` > > A list of `NewsletterWidgetNewsletterFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. > > **NewsletterWidgetNewsletterFontOverridesItem** > > **id** `string` > > The row’s id, unique in its array. > > **target** `Target | null` > > Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`. > > **source** `Source | null` > > Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`. > > **slot** `Slot | null` > > Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`. > > **curated** `Curated | null` > > Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`. > > **cdnProvider** `CdnProvider | null` > > Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`. > > **cdnFamily** `string` > > Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. > > **cdnWeights** `string` > > Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. > > **uploads** `readonly NewsletterWidgetNewsletterFontOverridesItemUploadsItem[]` > > A list of `NewsletterWidgetNewsletterFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. > > **NewsletterWidgetNewsletterFontOverridesItemUploadsItem** > > **file** `Readonly\\>` *required* > > **Required.** File attachment reference. > > **id** `string` > > The row’s id, unique in its array. > > **weight** `Weight | null` > > Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`. > > **style** `Style | null` > > Style. One of `normal`, `italic`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **fallback** `Fallback | null` > > Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **newsletterSubmitLabel** `string` > > The visible button text. Leave empty to hide the button. > > **newsletterSubmitVariant** `NewsletterSubmitVariant | null` > > Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`. > > **newsletterSubmitSize** `NewsletterSubmitSize | null` > > Button size. One of `small`, `normal`, `large`. > > **newsletterSubmitRadius** `NewsletterSubmitRadius | null` > > Corner radius. One of `pill`, `rounded`, `slight`, `square`. > > **newsletterSubmitColor** `string | null` > > Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. > > **newsletterSubmitColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) > > **newsletterSubmitTextColor** `string | null` > > The text/icon color. Clear it to derive from the button color (readable on solid fills). > > **newsletterSubmitTextColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme label color. > > **newsletterSubmitHoverColor** `string | null` > > Optional. Drives the hover treatment. Leave empty to derive it from the button color. > > **newsletterSubmitHoverColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme hover color. > > **newsletterSubmitStyle** `NewsletterSubmitStyle | null` > > The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`. > > **newsletterSubmitShadowColor** `string | null` > > Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. > > **newsletterSubmitShadowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme shadow color. > > **newsletterSubmitAnimation** `NewsletterSubmitAnimation | null` > > Hover motion. One of `lift`, `scale`, `lift-scale`, `none`. > > **newsletterSubmitIcon** `string` > > Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. > > **newsletterSubmitIconFamily** `NewsletterSubmitIconFamily | null` > > Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`. > > **newsletterSubmitIconPosition** `NewsletterSubmitIconPosition | null` > > Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`. > > **newsletterSubmitIconNudge** `boolean` > > The icon slides toward its side on hover (e.g. an arrow edges outward). > > **sectionCss** `CustomCSS | null` > > A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **SmsSignupWidget** > > A `sms-signup` widget: its `type` and its own fields. A field left out takes its default. > > **type** `SmsSignupWidgetType` *required* > > **Required.** The widget’s type: always `sms-signup`. One of `sms-signup`. > > **smsSignupConsentText** `string` *required* > > **Required.** Shown beside a required checkbox; the form shows only once this is filled in. Be specific about what they are agreeing to. The brand name is added automatically from Site settings. > > **id** `string` > > The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. > > **metaType** `MetaType` > > Always `widget`. One of `widget`. > > **smsSignupForm** `readonly Readonly\\>[]` > > The Form (Forms manager) that receives these SMS opt-ins and routes them — configure its destinations on the form’s Actions tab. The related `@apostrophecms/form` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document (one at most); a document the site can’t find is left out. At most 1 items. > > **smsSignupEyebrowEnabled** `boolean` > > Show eyebrow. > > **smsSignupEyebrow** `string` > > Small label shown above the title. > > **smsSignupEyebrowColor** `string | null` > > Optional. Overrides the eyebrow + its dash. Leave empty to use the secondary (mint) color. > > **smsSignupEyebrowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color, then the mint default. > > **smsSignupEyebrowWeight** `SmsSignupEyebrowWeight | null` > > Eyebrow weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **smsSignupEyebrowSize** `SmsSignupEyebrowSize | null` > > Eyebrow size. One of `small`, `normal`, `large`, `xlarge`. > > **smsSignupHeading** `string` > > Heading. > > **smsSignupHeadingColor** `string | null` > > Optional — leave empty to track the theme text color. > > **smsSignupHeadingColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **smsSignupHeadingWeight** `SmsSignupHeadingWeight | null` > > Weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **smsSignupHeadingSize** `SmsSignupHeadingSize | null` > > Size. One of `small`, `normal`, `large`, `xlarge`, `xxlarge`. > > **smsSignupIntro** `string` > > Optional short sentence under the heading. > > **smsSignupIntroColor** `string | null` > > Optional — leave empty to use the muted text color. > > **smsSignupIntroColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **smsSignupIntroWeight** `SmsSignupIntroWeight | null` > > Weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **smsSignupIntroSize** `SmsSignupIntroSize | null` > > Size. One of `small`, `normal`, `large`, `xlarge`, `xxlarge`. > > **smsSignupBand** `SmsSignupBand | null` > > Plain sits on the page; Raised is a contained card; Accent is a solid brand-color band. One of `plain`, `raised`, `accent`. > > **smsSignupAccentColor** `string | null` > > The accent band color. Leave empty to use the site accent color. > > **smsSignupAccentColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color, then the accent. > > **smsSignupAlign** `SmsSignupAlign | null` > > Alignment. One of `center`, `left`. > > **smsSignupLayout** `SmsSignupLayout | null` > > Inline puts the field + button on one row (stacks on small screens); Stacked always stacks them. One of `inline`, `stacked`. > > **smsSignupWidth** `SmsSignupWidth | null` > > Content width. One of `narrow`, `normal`, `wide`. > > **smsSignupNameEnabled** `boolean` > > Collect a name. > > **smsSignupNameLabel** `string` > > Name label. > > **smsSignupNamePlaceholder** `string` > > Name placeholder. > > **smsSignupPhoneLabel** `string` > > Phone label. > > **smsSignupPhonePlaceholder** `string` > > Phone placeholder. > > **smsSignupTermsText** `string` > > Carrier-compliance fine print shown under the form. > > **smsSignupPrivacyUrl** `string` > > Optional — linked from the fine print. > > **smsSignupTermsUrl** `string` > > Optional — linked from the fine print. > > **smsSignupSuccessMessage** `string` > > Success message. > > **smsSignupErrorMessage** `string` > > Error message. > > **smsSignupBg** `SmsSignupBg | null` > > The section’s full-width background band in dark mode. Transparent lets the page background show through. The palette options track the site colors; choose “Custom color…” for a specific color. One of `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`. > > **smsSignupBgCustom** `string | null` > > Used when “Section background (dark theme)” is set to Custom color. > > **smsSignupBgLight** `SmsSignupBgLight | null` > > “Match dark theme” reuses the dark-theme choice; otherwise set the light-mode band independently. One of `inherit`, `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`. > > **smsSignupBgLightCustom** `string | null` > > Used when “Section background (light theme)” is set to Custom color. > > **smsSignupFontOverrides** `readonly SmsSignupWidgetSmsSignupFontOverridesItem[]` > > A list of `SmsSignupWidgetSmsSignupFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. > > **SmsSignupWidgetSmsSignupFontOverridesItem** > > **id** `string` > > The row’s id, unique in its array. > > **target** `Target | null` > > Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`. > > **source** `Source | null` > > Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`. > > **slot** `Slot | null` > > Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`. > > **curated** `Curated | null` > > Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`. > > **cdnProvider** `CdnProvider | null` > > Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`. > > **cdnFamily** `string` > > Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. > > **cdnWeights** `string` > > Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. > > **uploads** `readonly SmsSignupWidgetSmsSignupFontOverridesItemUploadsItem[]` > > A list of `SmsSignupWidgetSmsSignupFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. > > **SmsSignupWidgetSmsSignupFontOverridesItemUploadsItem** > > **file** `Readonly\\>` *required* > > **Required.** File attachment reference. > > **id** `string` > > The row’s id, unique in its array. > > **weight** `Weight | null` > > Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`. > > **style** `Style | null` > > Style. One of `normal`, `italic`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **fallback** `Fallback | null` > > Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **smsSignupSubmitLabel** `string` > > The visible button text. Leave empty to hide the button. > > **smsSignupSubmitVariant** `SmsSignupSubmitVariant | null` > > Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`. > > **smsSignupSubmitSize** `SmsSignupSubmitSize | null` > > Button size. One of `small`, `normal`, `large`. > > **smsSignupSubmitRadius** `SmsSignupSubmitRadius | null` > > Corner radius. One of `pill`, `rounded`, `slight`, `square`. > > **smsSignupSubmitColor** `string | null` > > Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. > > **smsSignupSubmitColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) > > **smsSignupSubmitTextColor** `string | null` > > The text/icon color. Clear it to derive from the button color (readable on solid fills). > > **smsSignupSubmitTextColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme label color. > > **smsSignupSubmitHoverColor** `string | null` > > Optional. Drives the hover treatment. Leave empty to derive it from the button color. > > **smsSignupSubmitHoverColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme hover color. > > **smsSignupSubmitStyle** `SmsSignupSubmitStyle | null` > > The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`. > > **smsSignupSubmitShadowColor** `string | null` > > Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. > > **smsSignupSubmitShadowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme shadow color. > > **smsSignupSubmitAnimation** `SmsSignupSubmitAnimation | null` > > Hover motion. One of `lift`, `scale`, `lift-scale`, `none`. > > **smsSignupSubmitIcon** `string` > > Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. > > **smsSignupSubmitIconFamily** `SmsSignupSubmitIconFamily | null` > > Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`. > > **smsSignupSubmitIconPosition** `SmsSignupSubmitIconPosition | null` > > Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`. > > **smsSignupSubmitIconNudge** `boolean` > > The icon slides toward its side on hover (e.g. an arrow edges outward). > > **sectionCss** `CustomCSS | null` > > A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **FormRenderWidget** > > A `form-render` widget: its `type` and its own fields. A field left out takes its default. > > **type** `FormRenderWidgetType` *required* > > **Required.** The widget’s type: always `form-render`. One of `form-render`. > > **id** `string` > > The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. > > **metaType** `MetaType` > > Always `widget`. One of `widget`. > > **form** `readonly Readonly\\>[]` > > The form to show here. Build and edit the form itself in the Forms manager (create one there first if needed). The related `@apostrophecms/form` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document (one at most); a document the site can’t find is left out. At most 1 items. > > **styleOverride** `boolean` > > Off: the form renders with the styling saved on the form itself. On: the styling below replaces it here only — the form’s fields and other placements are unaffected. > > **formFontOverrides** `readonly FormRenderWidgetFormFontOverridesItem[]` > > A list of `FormRenderWidgetFormFontOverridesItem`. Optional. Set part of this form in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. > > **FormRenderWidgetFormFontOverridesItem** > > **id** `string` > > The row’s id, unique in its array. > > **target** `Target | null` > > Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`. > > **source** `Source | null` > > Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`. > > **slot** `Slot | null` > > Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`. > > **curated** `Curated | null` > > Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`. > > **cdnProvider** `CdnProvider | null` > > Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`. > > **cdnFamily** `string` > > Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. > > **cdnWeights** `string` > > Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. > > **uploads** `readonly FormRenderWidgetFormFontOverridesItemUploadsItem[]` > > A list of `FormRenderWidgetFormFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. > > **FormRenderWidgetFormFontOverridesItemUploadsItem** > > **file** `Readonly\\>` *required* > > **Required.** File attachment reference. > > **id** `string` > > The row’s id, unique in its array. > > **weight** `Weight | null` > > Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`. > > **style** `Style | null` > > Style. One of `normal`, `italic`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **fallback** `Fallback | null` > > Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **formEyebrowEnabled** `boolean` > > Show eyebrow. > > **formEyebrow** `string` > > Small label shown above the title. > > **formEyebrowColor** `string | null` > > Optional. Overrides the eyebrow + its dash. Leave empty to use the secondary (mint) color. > > **formEyebrowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color, then the mint default. > > **formEyebrowWeight** `FormEyebrowWeight | null` > > Eyebrow weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **formEyebrowSize** `FormEyebrowSize | null` > > Eyebrow size. One of `small`, `normal`, `large`, `xlarge`. > > **formHeading** `string` > > Heading. > > **formHeadingColor** `string | null` > > Optional — leave empty to track the theme text color. > > **formHeadingColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **formHeadingWeight** `FormHeadingWeight | null` > > Weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **formHeadingSize** `FormHeadingSize | null` > > Size. One of `small`, `normal`, `large`, `xlarge`, `xxlarge`. > > **formIntro** `string` > > Optional short sentence under the heading. > > **formIntroColor** `string | null` > > Optional — leave empty to use the muted text color. > > **formIntroColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **formIntroWeight** `FormIntroWeight | null` > > Weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **formIntroSize** `FormIntroSize | null` > > Size. One of `small`, `normal`, `large`, `xlarge`, `xxlarge`. > > **formBand** `FormBand | null` > > Plain sits on the page; Raised is a contained card; Accent is a solid brand-color band. One of `plain`, `raised`, `accent`. > > **formAccentColor** `string | null` > > The accent band color. Leave empty to use the site accent color. > > **formAccentColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color, then the accent. > > **formAlign** `FormAlign | null` > > Alignment of the section header (the form fields stay left-aligned for legibility). One of `center`, `left`. > > **formWidth** `FormWidth | null` > > Content width. One of `narrow`, `normal`, `wide`. > > **formLabelGap** `FormLabelGap | null` > > Vertical space between each field’s label and its input. One of `compact`, `normal`, `roomy`, `spacious`. > > **formBg** `FormBg | null` > > The section’s full-width background band in dark mode. Transparent lets the page background show through. The palette options track the site colors; choose “Custom color…” for a specific color. One of `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`. > > **formBgCustom** `string | null` > > Used when “Section background (dark theme)” is set to Custom color. > > **formBgLight** `FormBgLight | null` > > “Match dark theme” reuses the dark-theme choice; otherwise set the light-mode band independently. One of `inherit`, `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`. > > **formBgLightCustom** `string | null` > > Used when “Section background (light theme)” is set to Custom color. > > **formSubmitLabel** `string` > > The visible button text. Leave empty to hide the button. > > **formSubmitVariant** `FormSubmitVariant | null` > > Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`. > > **formSubmitSize** `FormSubmitSize | null` > > Button size. One of `small`, `normal`, `large`. > > **formSubmitRadius** `FormSubmitRadius | null` > > Corner radius. One of `pill`, `rounded`, `slight`, `square`. > > **formSubmitColor** `string | null` > > Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. > > **formSubmitColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) > > **formSubmitTextColor** `string | null` > > The text/icon color. Clear it to derive from the button color (readable on solid fills). > > **formSubmitTextColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme label color. > > **formSubmitHoverColor** `string | null` > > Optional. Drives the hover treatment. Leave empty to derive it from the button color. > > **formSubmitHoverColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme hover color. > > **formSubmitStyle** `FormSubmitStyle | null` > > The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`. > > **formSubmitShadowColor** `string | null` > > Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. > > **formSubmitShadowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme shadow color. > > **formSubmitAnimation** `FormSubmitAnimation | null` > > Hover motion. One of `lift`, `scale`, `lift-scale`, `none`. > > **formSubmitIcon** `string` > > Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. > > **formSubmitIconFamily** `FormSubmitIconFamily | null` > > Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`. > > **formSubmitIconPosition** `FormSubmitIconPosition | null` > > Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`. > > **formSubmitIconNudge** `boolean` > > The icon slides toward its side on hover (e.g. an arrow edges outward). > > **sectionCss** `CustomCSS | null` > > A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **FinalCtaWidget** > > A `final-cta` widget: its `type` and its own fields. A field left out takes its default. > > **type** `FinalCtaWidgetType` *required* > > **Required.** The widget’s type: always `final-cta`. One of `final-cta`. > > **id** `string` > > The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. > > **metaType** `MetaType` > > Always `widget`. One of `widget`. > > **ctaAlign** `CtaAlign | null` > > Content alignment. One of `center`, `left`. > > **ctaEyebrowEnabled** `boolean` > > Show eyebrow / kicker. > > **ctaEyebrow** `string` > > Small label shown above the title. > > **ctaEyebrowColor** `string | null` > > Optional. Overrides the eyebrow + its dash. Leave empty to use the secondary (mint) color. > > **ctaEyebrowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color, then the mint default. > > **ctaEyebrowWeight** `CtaEyebrowWeight | null` > > Eyebrow weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **ctaEyebrowSize** `CtaEyebrowSize | null` > > Eyebrow size. One of `small`, `normal`, `large`, `xlarge`. > > **ctaIconPlacement** `CtaIconPlacement | null` > > An optional Font Awesome icon above the headline. One of `none`, `top`. > > **ctaIcon** `string` > > Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. > > **ctaIconFamily** `CtaIconFamily | null` > > Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`. > > **ctaIconColor** `string | null` > > Optional — leave empty to use the design’s own color rhythm. > > **ctaIconAnimation** `CtaIconAnimation | null` > > Icon animation. One of `none`, `fa-beat`, `fa-bounce`, `fa-fade`, `fa-beat-fade`, `fa-flip`, `fa-shake`, `fa-spin`. > > **ctaIconSize** `CtaIconSize | null` > > Relative to the component’s base icon size. One of `default`, `sm`, `lg`, `xl`, `2xl`, `2x`, `3x`, `4x`, `5x`. > > **ctaIconTilt** `CtaIconTilt | null` > > A slight rotation for a more playful look. One of `none`, `left`, `right`. > > **ctaHeadline** `string` > > Headline. > > **ctaHeadlineColor** `string | null` > > Optional. Overrides the headline color. Leave empty for the on-accent (legible-on-band) default. > > **ctaHeadlineColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color, then the on-accent default. > > **ctaHeadlineWeight** `CtaHeadlineWeight | null` > > Headline weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **ctaBody** `string` > > Supporting copy. > > **ctaBodyColor** `string | null` > > Optional. Overrides the supporting-copy color. Leave empty for the softened on-accent default. > > **ctaBodyColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color, then the softened on-accent default. > > **ctaBodyWeight** `CtaBodyWeight | null` > > Body weight. One of `normal`, `medium`, `semibold`, `bold`. > > **ctaBackgroundType** `CtaBackgroundType | null` > > Solid keeps the loud color block; Image places a photo behind the text with a readability overlay. One of `solid`, `image`. > > **ctaBackgroundColor** `string | null` > > The solid band color (and the fallback behind a background image). Leave empty to use the site accent color. > > **ctaBackgroundColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color, then the accent. > > **ctaImage** `ImageArea` > > An `ImageArea`. Widgets, top to bottom: send `{ "items": [ … ] }`, one object per widget with its `type`. Writing it replaces the whole area. Its fields are listed under the first `ImageArea` above. > > **ctaOverlayColor** `string | null` > > Scrim over the image to keep the text readable. Leave empty to use the accent color. > > **ctaOverlayColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme overlay, then the accent. > > **ctaOverlayOpacity** `number | null` > > Overlay opacity (%). 0 to 100. > > **ctaRings** `boolean` > > The two large outlined circles on the band. > > **ctaRingColor** `string | null` > > Drawn at a low opacity. Leave empty to use the on-accent (white-ish) default. > > **ctaFontOverrides** `readonly FinalCtaWidgetCtaFontOverridesItem[]` > > A list of `FinalCtaWidgetCtaFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. > > **FinalCtaWidgetCtaFontOverridesItem** > > **id** `string` > > The row’s id, unique in its array. > > **target** `Target | null` > > Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`. > > **source** `Source | null` > > Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`. > > **slot** `Slot | null` > > Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`. > > **curated** `Curated | null` > > Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`. > > **cdnProvider** `CdnProvider | null` > > Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`. > > **cdnFamily** `string` > > Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. > > **cdnWeights** `string` > > Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. > > **uploads** `readonly FinalCtaWidgetCtaFontOverridesItemUploadsItem[]` > > A list of `FinalCtaWidgetCtaFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. > > **FinalCtaWidgetCtaFontOverridesItemUploadsItem** > > **file** `Readonly\\>` *required* > > **Required.** File attachment reference. > > **id** `string` > > The row’s id, unique in its array. > > **weight** `Weight | null` > > Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`. > > **style** `Style | null` > > Style. One of `normal`, `italic`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **fallback** `Fallback | null` > > Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **ctaPrimaryLabel** `string` > > The visible button text. Leave empty to hide the button. > > **ctaPrimaryUrl** `string` > > Where the button goes — a path (/blog) or full URL. > > **ctaPrimaryNewTab** `boolean` > > Opens the link in a new browser tab (adds rel="noopener noreferrer"). > > **ctaPrimaryVariant** `CtaPrimaryVariant | null` > > Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`. > > **ctaPrimarySize** `CtaPrimarySize | null` > > Button size. One of `small`, `normal`, `large`. > > **ctaPrimaryRadius** `CtaPrimaryRadius | null` > > Corner radius. One of `pill`, `rounded`, `slight`, `square`. > > **ctaPrimaryColor** `string | null` > > Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. > > **ctaPrimaryColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) > > **ctaPrimaryTextColor** `string | null` > > The text/icon color. Clear it to derive from the button color (readable on solid fills). > > **ctaPrimaryTextColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme label color. > > **ctaPrimaryHoverColor** `string | null` > > Optional. Drives the hover treatment. Leave empty to derive it from the button color. > > **ctaPrimaryHoverColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme hover color. > > **ctaPrimaryStyle** `CtaPrimaryStyle | null` > > The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`. > > **ctaPrimaryShadowColor** `string | null` > > Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. > > **ctaPrimaryShadowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme shadow color. > > **ctaPrimaryAnimation** `CtaPrimaryAnimation | null` > > Hover motion. One of `lift`, `scale`, `lift-scale`, `none`. > > **ctaPrimaryIcon** `string` > > Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. > > **ctaPrimaryIconFamily** `CtaPrimaryIconFamily | null` > > Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`. > > **ctaPrimaryIconPosition** `CtaPrimaryIconPosition | null` > > Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`. > > **ctaPrimaryIconNudge** `boolean` > > The icon slides toward its side on hover (e.g. an arrow edges outward). > > **ctaSecondaryLabel** `string` > > The visible button text. Leave empty to hide the button. > > **ctaSecondaryUrl** `string` > > Where the button goes — a path (/blog) or full URL. > > **ctaSecondaryNewTab** `boolean` > > Opens the link in a new browser tab (adds rel="noopener noreferrer"). > > **ctaSecondaryVariant** `CtaSecondaryVariant | null` > > Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`. > > **ctaSecondarySize** `CtaSecondarySize | null` > > Button size. One of `small`, `normal`, `large`. > > **ctaSecondaryRadius** `CtaSecondaryRadius | null` > > Corner radius. One of `pill`, `rounded`, `slight`, `square`. > > **ctaSecondaryColor** `string | null` > > Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. > > **ctaSecondaryColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) > > **ctaSecondaryTextColor** `string | null` > > The text/icon color. Clear it to derive from the button color (readable on solid fills). > > **ctaSecondaryTextColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme label color. > > **ctaSecondaryHoverColor** `string | null` > > Optional. Drives the hover treatment. Leave empty to derive it from the button color. > > **ctaSecondaryHoverColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme hover color. > > **ctaSecondaryStyle** `CtaSecondaryStyle | null` > > The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`. > > **ctaSecondaryShadowColor** `string | null` > > Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. > > **ctaSecondaryShadowColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme shadow color. > > **ctaSecondaryAnimation** `CtaSecondaryAnimation | null` > > Hover motion. One of `lift`, `scale`, `lift-scale`, `none`. > > **ctaSecondaryIcon** `string` > > Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. > > **ctaSecondaryIconFamily** `CtaSecondaryIconFamily | null` > > Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`. > > **ctaSecondaryIconPosition** `CtaSecondaryIconPosition | null` > > Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`. > > **ctaSecondaryIconNudge** `boolean` > > The icon slides toward its side on hover (e.g. an arrow edges outward). > > **sectionCss** `CustomCSS | null` > > A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **comingSoonIcon** `string | null | undefined` > > **Optional.** Leave it out and the site uses `"sparkles"`. Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. > > **comingSoonIconFamily** `ComingSoonIconFamily | null | undefined` > > **Optional.** Leave it out and the site uses `"classic-regular"`. Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`. > > **comingSoonIconColor** `string | null | undefined` > > **Optional.** Leave it out (or pass `null`) and it isn’t sent: the site’s default applies. Optional — leave empty to use the design’s own color rhythm. > > **comingSoonIconAnimation** `ComingSoonIconAnimation | null | undefined` > > **Optional.** Leave it out and the site uses `"none"`. Icon animation. One of `none`, `fa-beat`, `fa-bounce`, `fa-fade`, `fa-beat-fade`, `fa-flip`, `fa-shake`, `fa-spin`. > > **comingSoonIconSize** `ComingSoonIconSize | null | undefined` > > **Optional.** Leave it out and the site uses `"5x"`. Relative to the component’s base icon size. One of `default`, `sm`, `lg`, `xl`, `2xl`, `2x`, `3x`, `4x`, `5x`. > > **comingSoonNote** `string | null | undefined` > > **Optional.** Leave it out and the site uses `""`. Optional. Shown under the icon while this page has no content. Leave empty for a tasteful default line. > > **backLinkColor** `string | null | undefined` > > **Optional.** Leave it out (or pass `null`) and it isn’t sent: the site’s default applies. Optional. Color of the "← back" link at the top of every post. Leave empty to use the site accent color. > > **backLinkColorLight** `string | null | undefined` > > **Optional.** Leave it out (or pass `null`) and it isn’t sent: the site’s default applies. Optional light-theme override. Falls back to the dark-theme color, then the accent. > > **backLinkWeight** `BackLinkWeight | null | undefined` > > **Optional.** Leave it out and the site uses `"semibold"`. Back link weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **backLinkSize** `BackLinkSize | null | undefined` > > **Optional.** Leave it out and the site uses `"normal"`. Back link size. One of `small`, `normal`, `large`, `xlarge`. > > **aboveSections** `SectionsArea | null | undefined` > > **Optional.** Leave it out (or pass `null`) and it isn’t sent: the site’s default applies. Widgets, top to bottom: send `{ "items": [ … ] }`, one object per widget with its `type`. Writing it replaces the whole area. A new document starts with `page-header`. > > **postList** `BlogListArea | null | undefined` > > **Optional.** Leave it out (or pass `null`) and it isn’t sent: the site’s default applies. Widgets, top to bottom: send `{ "items": [ … ] }`, one object per widget with its `type`. Writing it replaces the whole area. A new document starts with `blog-list`. > > **BlogListArea** > > **metaType** `AfterContentAreaMetaType` > > Always `area`. One of `area`. > > **id** `string` > > The area’s id, set by the site: leave it out when you write one. > > **items** `readonly BlogListWidget[]` > > A list of `BlogListWidget`. The widgets, top to bottom. Each is an object with its `type` and that widget’s own fields; `_id` and `metaType` may be left out (the site sets them). At most 1 items. > > **BlogListWidget** > > A `blog-list` widget: its `type` and its own fields. A field left out takes its default. > > **type** `BlogListWidgetType` *required* > > **Required.** The widget’s type: always `blog-list`. One of `blog-list`. > > **id** `string` > > The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. > > **metaType** `MetaType` > > Always `widget`. One of `widget`. > > **blogLayout** `BlogLayout | null` > > How posts are arranged. One of `card`, `list`, `compact`, `featured`, `masonry`. > > **blogColumns** `BlogColumns | null` > > Applies to the Card grid and Masonry layouts. One of `auto`, `2`, `3`. > > **blogEntrance** `BlogEntrance | null` > > How posts animate in as they scroll into view. Only plays when site animations are on (Site design → Motion) — otherwise the posts are simply shown. In the Featured + grid layout the banner rises first, then the grid staggers in. One of `stagger`, `none`. > > **blogCardImageAspect** `BlogCardImageAspect | null` > > Aspect ratio of the featured image. Choose “Hidden” for text-only cards. One of `16/10`, `4/3`, `3/2`, `1/1`, `none`. > > **blogCardImageHover** `BlogCardImageHover | null` > > Image hover. One of `zoom`, `none`. > > **blogCardImageFill** `boolean` > > Use the featured image as the full card background, with the title and meta overlaid on a dark scrim. Posts with no image fall back to a normal card. > > **blogCardPreset** `BlogCardPreset | null` > > The card surface. Raised is a quiet lit card; Luxe a frosted glass panel; Outline a plaque frame; Spine adds a color rail; Tint an accent wash; Ticket/Bracket/Forge/Press/Inlay are the graphic showstoppers. (On image-led cards the photo covers the top edge.) One of `raised`, `luxe`, `outline`, `plain`, `poster`, `edge`, `tint`, `ticket`, `bracket`, `forge`, `press`, `inlay`. > > **blogCardPresetRadius** `BlogCardPresetRadius | null` > > Corner rounding for each card. Default keeps the widget’s own tuned corners — except Forge, which defaults to tight machined corners matching its engraved frame. One of `default`, `square`, `slight`, `rounded`, `large`. > > **blogCardPresetAccentColor** `string | null` > > Colors the Spine rail, Bracket marks, Forge corner/frame and Press margin rule. Leave empty to use the brand accent. > > **blogCardPresetAccentColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color. > > **blogCardPresetForgeScope** `BlogCardPresetForgeScope | null` > > Where the Forge plate wears its color: a single corner mark (the machinist’s datum, default) or the whole engraved frame. One of `corner`, `frame`. > > **blogCardPresetForgeWeight** `BlogCardPresetForgeWeight | null` > > Thickness of the Forge corner mark / colored frame. One of `fine`, `medium`, `bold`. > > **blogCardHover** `BlogCardHover | null` > > What a card does on hover. Lift/Pop/Press/Glow/Outline are instant; Sheen sweeps a light across; Tilt (3-D + glare), Magnetic and Spotlight follow the cursor (need site animations on). The Hover color below tints these. One of `none`, `lift`, `pop`, `press`, `glow`, `border`, `sheen`, `tilt`, `magnetic`, `spotlight`. > > **blogCardHoverColor** `string | null` > > Border / shadow / glow color on hover. Leave empty to use the site accent color. > > **blogCardHoverColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color, then the accent. > > **blogCardShowCategory** `boolean` > > Show category. > > **blogCardCategoryStyle** `BlogCardCategoryStyle | null` > > How the category badge uses its color (set per category under Blog Categories). Filled = colored background; Outline = colored border + text; Minimal = colored text only. One of `filled`, `outline`, `minimal`. > > **blogCardShowDate** `boolean` > > Show date. > > **blogCardShowExcerpt** `boolean` > > Show excerpt. > > **blogCardExcerptLines** `BlogCardExcerptLines | null` > > How many lines of the excerpt to show before truncating. One of `2`, `3`, `4`, `none`. > > **blogCardShowAuthor** `boolean` > > Show author. > > **blogCardShowReadMore** `boolean` > > Show “Read post” link. > > **blogCardReadMorePlacement** `BlogCardReadMorePlacement | null` > > Auto puts it on the right of horizontal cards (list / compact / featured) and below the text on grid cards. Or force one placement everywhere. One of `auto`, `below`, `right`. > > **blogCardReadMoreColor** `string | null` > > Optional. Overrides the “Read post” link color. Leave empty to use the site accent color. > > **blogCardReadMoreColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color, then the accent. > > **blogCardReadMoreHoverColor** `string | null` > > Optional. Color of the “Read post” link when the card is hovered. Leave empty to use the accent color. > > **blogCardReadMoreHoverColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme hover color, then the accent. > > **blogCardTitleColor** `string | null` > > Optional. Overrides the card title color. Leave empty to track the theme’s text color. > > **blogCardTitleColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color, then the theme default. > > **blogCardTitleWeight** `BlogCardTitleWeight | null` > > Title weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **blogCardTitleHoverColor** `string | null` > > Optional. Title color when the card is hovered. Leave empty to use the site accent color. > > **blogCardTitleHoverColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme hover color, then the accent. > > **blogCardTextColor** `string | null` > > Optional. Overrides the excerpt text color. Leave empty for the muted default. > > **blogCardTextColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color, then the muted default. > > **blogCardTextWeight** `BlogCardTextWeight | null` > > Excerpt weight. One of `normal`, `medium`, `semibold`, `bold`. > > **blogCardMetaColor** `string | null` > > Date / meta line color. Leave empty for the faint default. > > **blogCardMetaColorLight** `string | null` > > Optional light-theme override. Falls back to the dark-theme color, then the faint default. > > **blogBg** `BlogBg | null` > > The section’s full-width background band in dark mode. Transparent lets the page background show through. The palette options track the site colors; choose “Custom color…” for a specific color. One of `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`. > > **blogBgCustom** `string | null` > > Used when “Section background (dark theme)” is set to Custom color. > > **blogBgLight** `BlogBgLight | null` > > “Match dark theme” reuses the dark-theme choice; otherwise set the light-mode band independently. One of `inherit`, `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`. > > **blogBgLightCustom** `string | null` > > Used when “Section background (light theme)” is set to Custom color. > > **blogFontOverrides** `readonly BlogListWidgetBlogFontOverridesItem[]` > > A list of `BlogListWidgetBlogFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. > > **BlogListWidgetBlogFontOverridesItem** > > **id** `string` > > The row’s id, unique in its array. > > **target** `Target | null` > > Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`. > > **source** `Source | null` > > Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`. > > **slot** `Slot | null` > > Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`. > > **curated** `Curated | null` > > Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`. > > **cdnProvider** `CdnProvider | null` > > Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`. > > **cdnFamily** `string` > > Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. > > **cdnWeights** `string` > > Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. > > **uploads** `readonly BlogListWidgetBlogFontOverridesItemUploadsItem[]` > > A list of `BlogListWidgetBlogFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. > > **BlogListWidgetBlogFontOverridesItemUploadsItem** > > **file** `Readonly\\>` *required* > > **Required.** File attachment reference. > > **id** `string` > > The row’s id, unique in its array. > > **weight** `Weight | null` > > Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`. > > **style** `Style | null` > > Style. One of `normal`, `italic`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **fallback** `Fallback | null` > > Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **sectionCss** `CustomCSS | null` > > A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **belowSections** `SectionsArea | null | undefined` > > **Optional.** Leave it out (or pass `null`) and it isn’t sent: the site’s default applies. Widgets, top to bottom: send `{ "items": [ … ] }`, one object per widget with its `type`. Writing it replaces the whole area. > > **backButtonLabel** `string | null | undefined` > > **Optional.** Leave it out and the site uses `"Back to all posts"`. The visible button text. Leave empty to hide the button. > > **backButtonVariant** `BackButtonVariant | null | undefined` > > **Optional.** Leave it out and the site uses `"outline"`. Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`. > > **backButtonSize** `BackButtonSize | null | undefined` > > **Optional.** Leave it out and the site uses `"normal"`. Button size. One of `small`, `normal`, `large`. > > **backButtonRadius** `BackButtonRadius | null | undefined` > > **Optional.** Leave it out and the site uses `"slight"`. Corner radius. One of `pill`, `rounded`, `slight`, `square`. > > **backButtonColor** `string | null | undefined` > > **Optional.** Leave it out and the site uses `"--fetchski-accent"`. Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. > > **backButtonColorLight** `string | null | undefined` > > **Optional.** Leave it out (or pass `null`) and it isn’t sent: the site’s default applies. Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) > > **backButtonTextColor** `string | null | undefined` > > **Optional.** Leave it out and the site uses `"--fetchski-ink"`. The text/icon color. Clear it to derive from the button color (readable on solid fills). > > **backButtonTextColorLight** `string | null | undefined` > > **Optional.** Leave it out (or pass `null`) and it isn’t sent: the site’s default applies. Optional light-theme override. Falls back to the dark-theme label color. > > **backButtonHoverColor** `string | null | undefined` > > **Optional.** Leave it out (or pass `null`) and it isn’t sent: the site’s default applies. Optional. Drives the hover treatment. Leave empty to derive it from the button color. > > **backButtonHoverColorLight** `string | null | undefined` > > **Optional.** Leave it out (or pass `null`) and it isn’t sent: the site’s default applies. Optional light-theme override. Falls back to the dark-theme hover color. > > **backButtonStyle** `BackButtonStyle | null | undefined` > > **Optional.** Leave it out and the site uses `"sweep"`. The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`. > > **backButtonShadowColor** `string | null | undefined` > > **Optional.** Leave it out (or pass `null`) and it isn’t sent: the site’s default applies. Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. > > **backButtonShadowColorLight** `string | null | undefined` > > **Optional.** Leave it out (or pass `null`) and it isn’t sent: the site’s default applies. Optional light-theme override. Falls back to the dark-theme shadow color. > > **backButtonAnimation** `BackButtonAnimation | null | undefined` > > **Optional.** Leave it out and the site uses `"lift-scale"`. Hover motion. One of `lift`, `scale`, `lift-scale`, `none`. > > **backButtonIcon** `string | null | undefined` > > **Optional.** Leave it out and the site uses `"arrow-left"`. Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. > > **backButtonIconFamily** `BackButtonIconFamily | null | undefined` > > **Optional.** Leave it out and the site uses `"classic-regular"`. Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`. > > **backButtonIconPosition** `BackButtonIconPosition | null | undefined` > > **Optional.** Leave it out and the site uses `"before"`. Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`. > > **backButtonIconNudge** `boolean | null | undefined` > > **Optional.** Leave it out and the site uses `false`. The icon slides toward its side on hover (e.g. an arrow edges outward). > > **postFontOverrides** `readonly PagePostFontOverridesItem[] | null | undefined` > > **Optional.** Leave it out (or pass `null`) and it isn’t sent: the site’s default applies. Optional. Set part of every post in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). An individual post can replace this on its own Fonts tab. At most 4 items. > > **PagePostFontOverridesItem** > > **id** `string` > > The row’s id, unique in its array. > > **target** `Target | null` > > Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`. > > **source** `Source | null` > > Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`. > > **slot** `Slot | null` > > Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`. > > **curated** `Curated | null` > > Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`. > > **cdnProvider** `CdnProvider | null` > > Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`. > > **cdnFamily** `string` > > Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. > > **cdnWeights** `string` > > Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. > > **uploads** `readonly PagePostFontOverridesItemUploadsItem[]` > > A list of `PagePostFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. > > **PagePostFontOverridesItemUploadsItem** > > **file** `Readonly\\>` *required* > > **Required.** File attachment reference. > > **id** `string` > > The row’s id, unique in its array. > > **weight** `Weight | null` > > Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`. > > **style** `Style | null` > > Style. One of `normal`, `italic`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **fallback** `Fallback | null` > > Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`. > > **fields** `Readonly\\>` > > Optional: any keys not listed above, by their wire names; they are sent with the rest. > > **postTextSize** `PostTextSize | null | undefined` > > **Optional.** Leave it out and the site uses `"normal"`. Body text size. One of `small`, `normal`, `large`, `xlarge`. > > **postTextWeight** `PostTextWeight | null | undefined` > > **Optional.** Leave it out and the site uses `"normal"`. Body text weight. One of `normal`, `medium`, `semibold`. > > **postContentWidth** `PostContentWidth | null | undefined` > > **Optional.** Leave it out and the site uses `"normal"`. Reading measure — how wide the article column gets. Posts that contain section widgets open to Full width automatically so the widgets have room. One of `narrow`, `normal`, `wide`, `xwide`, `full`. > > **postLineHeight** `PostLineHeight | null | undefined` > > **Optional.** Leave it out and the site uses `"normal"`. Line height. One of `tight`, `normal`, `relaxed`. > > **postAccentColor** `string | null | undefined` > > **Optional.** Leave it out (or pass `null`) and it isn’t sent: the site’s default applies. Links, the blockquote rule, and heading accents. Leave empty to use the site link color. > > **postAccentColorLight** `string | null | undefined` > > **Optional.** Leave it out (or pass `null`) and it isn’t sent: the site’s default applies. Optional light-theme override. Falls back to the dark-theme color, then the link color. > > **postHeadingWeight** `PostHeadingWeight | null | undefined` > > **Optional.** Leave it out and the site uses `"bold"`. Heading weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`. > > **postHeadingColor** `string | null | undefined` > > **Optional.** Leave it out (or pass `null`) and it isn’t sent: the site’s default applies. Optional. Overrides in-article heading color. Leave empty to track the theme’s text color. > > **postHeadingColorLight** `string | null | undefined` > > **Optional.** Leave it out (or pass `null`) and it isn’t sent: the site’s default applies. Optional light-theme override. Falls back to the dark-theme color, then the theme default. > > **blogPostCss** `PostCustomCSS | null | undefined` > > **Optional.** Leave it out (or pass `null`) and it isn’t sent: the site’s default applies. CSS for every blog post’s page: the title band, the article and its parts. It wins over Site design → Custom CSS → Blog post. > > **PostCustomCSS** > > **slots** `Readonly\\>` > > The CSS typed into each part slot, by slot name. > > **css** `string` > > The compiled CSS (read only: rebuilt from `slots`). > > **mark** `string` > > The site’s check mark for `css` (read only). A `Page`. A page: the fields every page has, and each page type’s own (`type` says which page type it is; a field belongs only to the page types that define it). Read its properties (`page.id`): each says whether the site always sends it. The example answer is the site’s wire JSON: some keys differ from the property names (`_id` → `id`, `_ancestors` → `ancestors`, `_children` → `children` …). **id** `string` **Always sent.** Unique document identifier, may include mode and locale (e.g., "id:en:published") **aposDocId** `string` **Always sent.** Base document ID without mode/locale qualifiers. **aposLocale** `string` **Always sent.** Document locale code. **updatedAt** `Date` **Always sent.** Page last update timestamp. Format: an ISO 8601 date and time. **slug** `string` **Always sent.** URL slug for the page. **path** `string` **Always sent.** Full hierarchical path in the page tree. **level** `number` **Always sent.** Depth level in the page tree (0 = root level) **visibility** `FlatPageResponseResultsItemVisibility` **Always sent.** Page visibility setting. One of `public`, `loginRequired`, `private`; a newer site may send others, so keep a fallback. **type** `string` **Always sent.** Page type module name. **title** `string` **Always sent.** Page title. At most 100 characters. **aposMode** `AposMode | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Document mode (draft or published) One of `draft`, `published`; a newer site may send others, so keep a fallback. **archived** `boolean | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Whether the page is archived. **createdAt** `Date | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Page creation timestamp. Format: an ISO 8601 date and time. **titleSortified** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Sortable version of the page title. **rank** `number | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Sort order within parent page. **orphan** `boolean | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Whether page is orphaned (not in tree structure) **parked** `readonly string[] | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Array of parking lot configurations if page is parked. **main** `MainArea` **Sometimes sent:** `undefined` when the site leaves it out. A `MainArea`. Widgets, top to bottom: send `{ "items": [ … ] }`, one object per widget with its `type`. Writing it replaces the whole area. **MainArea** **metaType** `AfterContentAreaMetaType` **Sometimes sent:** `undefined` when the site leaves it out. Always `area`. One of `area`; a newer site may send others, so keep a fallback. **id** `string` **Sometimes sent:** `undefined` when the site leaves it out. The area’s id, set by the site: leave it out when you write one. **items** `readonly MainAreaItem[]` **Sometimes sent:** `undefined` when the site leaves it out. A list of `MainAreaItem`. The widgets, top to bottom. Each is an object with its `type` and that widget’s own fields; `_id` and `metaType` may be left out (the site sets them). **MainAreaItem** A widget in an area that takes `@apostrophecms/rich-text`, `@apostrophecms/image`, `@apostrophecms/video`: the one its `type` names. **RichTextWidget** A `@apostrophecms/rich-text` widget: its `type` and its own fields. A field left out takes its default. **type** `RichTextWidgetType` **Always sent.** The widget’s type: always `@apostrophecms/rich-text`. One of `@apostrophecms/rich-text`; a newer site may send others, so keep a fallback. **id** `string` **Sometimes sent:** `undefined` when the site leaves it out. The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. **metaType** `MetaType` **Sometimes sent:** `undefined` when the site leaves it out. Always `widget`. One of `widget`; a newer site may send others, so keep a fallback. **content** `string` **Sometimes sent:** `undefined` when the site leaves it out. The text as HTML, e.g. `

Our story

It began with one idea.

`. The site keeps the tags and styles this area’s editor offers (paragraphs, headings, bold, italic, links, lists…) and removes the rest. **sectionCss** `CustomCSS | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. **CustomCSS** **slots** `Readonly\\>` **Sometimes sent:** `undefined` when the site leaves it out. The CSS typed into each part slot, by slot name. **css** `string` **Sometimes sent:** `undefined` when the site leaves it out. The compiled CSS (read only: rebuilt from `slots`). **mark** `string` **Sometimes sent:** `undefined` when the site leaves it out. The site’s check mark for `css` (read only). **fields** `Readonly\\>` **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **ImageWidget** A `@apostrophecms/image` widget: its `type` and its own fields. A field left out takes its default. **type** `ImageWidgetType` **Always sent.** The widget’s type: always `@apostrophecms/image`. One of `@apostrophecms/image`; a newer site may send others, so keep a fallback. **id** `string` **Sometimes sent:** `undefined` when the site leaves it out. The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. **metaType** `MetaType` **Sometimes sent:** `undefined` when the site leaves it out. Always `widget`. One of `widget`; a newer site may send others, so keep a fallback. **image** `readonly Readonly\\>[]` **Sometimes sent:** `undefined` when the site leaves it out. The related `@apostrophecms/image` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document (one at most); a document the site can’t find is left out. At most 1 items. **caption** `string` **Sometimes sent:** `undefined` when the site leaves it out. Caption. **linkTo** `LinkTo | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Link To... One of `none`, `@apostrophecms/any-page-type`, `_url`; a newer site may send others, so keep a fallback. **apostrophecmsAnyPageType** `readonly Readonly\\>[]` **Sometimes sent:** `undefined` when the site leaves it out. The related `@apostrophecms/any-page-type` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document (one at most); a document the site can’t find is left out. At most 1 items. **linkHref** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. apostrophe:linkHrefHelp When set, a URL; empty or null when not. **linkHrefTitle** `string` **Sometimes sent:** `undefined` when the site leaves it out. Link Title. **linkTitle** `string` **Sometimes sent:** `undefined` when the site leaves it out. If empty, the title of the related document will be used. **linkTarget** `readonly LinkTarget[] | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Link Target. Each one of `_blank`. **sectionCss** `CustomCSS | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. **fields** `Readonly\\>` **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **VideoWidget** A `@apostrophecms/video` widget: its `type` and its own fields. A field left out takes its default. **type** `VideoWidgetType` **Always sent.** The widget’s type: always `@apostrophecms/video`. One of `@apostrophecms/video`; a newer site may send others, so keep a fallback. **video** `Readonly\\>` **Always sent.** Enter the URL for a media source you wish to embed (e.g., YouTube, Vimeo, or other hosted video URL). **id** `string` **Sometimes sent:** `undefined` when the site leaves it out. The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. **metaType** `MetaType` **Sometimes sent:** `undefined` when the site leaves it out. Always `widget`. One of `widget`; a newer site may send others, so keep a fallback. **sectionCss** `CustomCSS | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. **fields** `Readonly\\>` **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **fields** `Readonly\\>` **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A list of `Page`. The page’s ancestors, from the home page down (each without its own `_ancestors` and `_children`). **Page** A page: the fields every page has, and each page type’s own (`type` says which page type it is; a field belongs only to the page types that define it). **id** `string` **Always sent.** Unique document identifier, may include mode and locale (e.g., "id:en:published") **aposDocId** `string` **Always sent.** Base document ID without mode/locale qualifiers. **aposLocale** `string` **Always sent.** Document locale code. **updatedAt** `Date` **Always sent.** Page last update timestamp. Format: an ISO 8601 date and time. **slug** `string` **Always sent.** URL slug for the page. **path** `string` **Always sent.** Full hierarchical path in the page tree. **level** `number` **Always sent.** Depth level in the page tree (0 = root level) **visibility** `FlatPageResponseResultsItemVisibility` **Always sent.** Page visibility setting. One of `public`, `loginRequired`, `private`; a newer site may send others, so keep a fallback. **type** `string` **Always sent.** Page type module name. **title** `string` **Always sent.** Page title. At most 100 characters. **aposMode** `AposMode | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Document mode (draft or published) One of `draft`, `published`; a newer site may send others, so keep a fallback. **archived** `boolean | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Whether the page is archived. **createdAt** `Date | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Page creation timestamp. Format: an ISO 8601 date and time. **titleSortified** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Sortable version of the page title. **rank** `number | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Sort order within parent page. **orphan** `boolean | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Whether page is orphaned (not in tree structure) **parked** `readonly string[] | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Array of parking lot configurations if page is parked. **main** `MainArea` **Sometimes sent:** `undefined` when the site leaves it out. A `MainArea`. Widgets, top to bottom: send `{ "items": [ … ] }`, one object per widget with its `type`. Writing it replaces the whole area. Its fields are listed under the first `MainArea` above. **ancestors** `readonly Page[] | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A list of `Page`. The page’s ancestors, from the home page down (each without its own `_ancestors` and `_children`). Its fields are listed under the first `Page` above. **children** `readonly Page[] | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A list of `Page`. Its child pages, each with its own `_children` where the request asked for more levels. Its fields are listed under the first `Page` above. **url** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Full URL to the page. Format: an absolute URL. **edit** `boolean | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Whether current user can edit this page. **publish** `boolean | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Whether current user can publish this page. **copyOfId** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The `_id` of the piece/page that was copied to create this document (only present if created via `_copyingId`) **publishedDoc** `Page` **Sometimes sent:** `undefined` when the site leaves it out. A `Page`. A page: the fields every page has, and each page type’s own (`type` says which page type it is; a field belongs only to the page types that define it). Its fields are listed under the first `Page` above. **draftDoc** `Page` **Sometimes sent:** `undefined` when the site leaves it out. A `Page`. A page: the fields every page has, and each page type’s own (`type` says which page type it is; a field belongs only to the page types that define it). Its fields are listed under the first `Page` above. **aposShareKey** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The draft’s preview share key, while its share link is on: the link is the draft’s `_url` with `aposShareKey` and `aposShareId` (the draft’s `_id`) in its query. Absent otherwise, and on published documents. **scheduledPublish** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. An ISO 8601 date and time, e.g. `2026-10-21T14:30:00.000Z`. **scheduledUnpublish** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. An ISO 8601 date and time, e.g. `2026-10-21T14:30:00.000Z`. **seoTitle** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Overrides the document title in the browser tab and search results. Leave blank to use the regular title. **seoDescription** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Shown in search results and link previews. Aim for 150–160 characters. **seoImage** `ImageArea` **Sometimes sent:** `undefined` when the site leaves it out. An `ImageArea`. Used for Open Graph / social link previews. Recommended 1200×630. Widgets, top to bottom: send `{ "items": [ … ] }`, one object per widget with its `type`. Writing it replaces the whole area. **ImageArea** Widgets, top to bottom: send `{ "items": [ … ] }`, one object per widget with its `type`. Writing it replaces the whole area. **metaType** `AfterContentAreaMetaType` **Sometimes sent:** `undefined` when the site leaves it out. Always `area`. One of `area`; a newer site may send others, so keep a fallback. **id** `string` **Sometimes sent:** `undefined` when the site leaves it out. The area’s id, set by the site: leave it out when you write one. **items** `readonly ImageWidget[]` **Sometimes sent:** `undefined` when the site leaves it out. A list of `ImageWidget`. The widgets, top to bottom. Each is an object with its `type` and that widget’s own fields; `_id` and `metaType` may be left out (the site sets them). At most 1 items. Its fields are listed under the first `ImageWidget` above. **fields** `Readonly\\>` **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **pageFontOverrides** `readonly PagePageFontOverridesItem[] | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A list of `PagePageFontOverridesItem`. Optional. Set part of this page in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). Individual sections can still override this for themselves. At most 4 items. **PagePageFontOverridesItem** **id** `string` **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **target** `Target | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`; a newer site may send others, so keep a fallback. **source** `Source | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`; a newer site may send others, so keep a fallback. **slot** `Slot | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`; a newer site may send others, so keep a fallback. **curated** `Curated | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`; a newer site may send others, so keep a fallback. **cdnProvider** `CdnProvider | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`; a newer site may send others, so keep a fallback. **cdnFamily** `string` **Sometimes sent:** `undefined` when the site leaves it out. Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. **cdnWeights** `string` **Sometimes sent:** `undefined` when the site leaves it out. Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. **uploads** `readonly PagePageFontOverridesItemUploadsItem[]` **Sometimes sent:** `undefined` when the site leaves it out. A list of `PagePageFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. **PagePageFontOverridesItemUploadsItem** **file** `Readonly\\>` **Always sent.** File attachment reference. **id** `string` **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **weight** `Weight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`; a newer site may send others, so keep a fallback. **style** `Style | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Style. One of `normal`, `italic`; a newer site may send others, so keep a fallback. **fields** `Readonly\\>` **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **fallback** `Fallback | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`; a newer site may send others, so keep a fallback. **fields** `Readonly\\>` **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **footerMarqueeMode** `FooterMarqueeMode | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The ribbon of phrases scrolling across the top of the footer. Its phrases and the site-wide default are set in Site design → Footer: Marquee. One of `inherit`, `on`, `off`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. A `SectionsArea`. Widgets, top to bottom: send `{ "items": [ … ] }`, one object per widget with its `type`. Writing it replaces the whole area. A new document starts with `page-header`. **SectionsArea** **metaType** `AfterContentAreaMetaType` **Sometimes sent:** `undefined` when the site leaves it out. Always `area`. One of `area`; a newer site may send others, so keep a fallback. **id** `string` **Sometimes sent:** `undefined` when the site leaves it out. The area’s id, set by the site: leave it out when you write one. **Sometimes sent:** `undefined` when the site leaves it out. A list of `SectionsAreaItem`. The widgets, top to bottom. Each is an object with its `type` and that widget’s own fields; `_id` and `metaType` may be left out (the site sets them). **SectionsAreaItem** A widget in an area that takes `page-header`, `hero`, `@apostrophecms/layout`, `intro`, `feature`, `stats`, `logos`, `steps`, `media-text`, `device-mock`, `team`, `faq`, `service-map`, `blog-preview`, `cookie-declaration`, `@apostrophecms/rich-text`, `google-reviews`, `testimonials`, `instagram-feed`, `gallery-preview`, `gallery-full`, `pricing`, `newsletter`, `sms-signup`, `form-render`, `final-cta`: the one its `type` names. **PageHeaderWidget** A `page-header` widget: its `type` and its own fields. A field left out takes its default. **type** `PageHeaderWidgetType` **Always sent.** The widget’s type: always `page-header`. One of `page-header`; a newer site may send others, so keep a fallback. **id** `string` **Sometimes sent:** `undefined` when the site leaves it out. The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. **metaType** `MetaType` **Sometimes sent:** `undefined` when the site leaves it out. Always `widget`. One of `widget`; a newer site may send others, so keep a fallback. **headline** `string` **Sometimes sent:** `undefined` when the site leaves it out. Optional. Leave empty to show the page title (the usual case). Set it only when the visible heading should read differently from the page’s title in navigation, search results and breadcrumbs. **eyebrowMode** `EyebrowMode | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The small label above the title. One of `business`, `custom`, `none`; a newer site may send others, so keep a fallback. **eyebrow** `string` **Sometimes sent:** `undefined` when the site leaves it out. Eyebrow text. **eyebrowColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Overrides the eyebrow + its dash. Leave empty to use the secondary (mint) color. **eyebrowColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color, then the mint default. **eyebrowWeight** `EyebrowWeight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Eyebrow weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **eyebrowSize** `EyebrowSize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Eyebrow size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **titleColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to track the theme text color. **titleColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **titleWeight** `TitleWeight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Title weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **titleSize** `TitleSize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Title size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **leadText** `string` **Sometimes sent:** `undefined` when the site leaves it out. Optional intro shown under the page title. **leadColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to use the muted text color. **leadColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **leadWeight** `LeadWeight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Lead weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **leadSize** `LeadSize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Lead size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **pageHeaderBg** `PageHeaderBg | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The section’s full-width background band in dark mode. Transparent lets the page background show through. The palette options track the site colors; choose “Custom color…” for a specific color. One of `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`; a newer site may send others, so keep a fallback. **pageHeaderBgCustom** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Used when “Section background (dark theme)” is set to Custom color. **pageHeaderBgLight** `PageHeaderBgLight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. “Match dark theme” reuses the dark-theme choice; otherwise set the light-mode band independently. One of `inherit`, `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`; a newer site may send others, so keep a fallback. **pageHeaderBgLightCustom** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Used when “Section background (light theme)” is set to Custom color. **pageHeaderImage** `ImageArea` **Sometimes sent:** `undefined` when the site leaves it out. An `ImageArea`. Widgets, top to bottom: send `{ "items": [ … ] }`, one object per widget with its `type`. Writing it replaces the whole area. Its fields are listed under the first `ImageArea` above. **pageHeaderOverlayColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Scrim behind the text over a background image (only applies when one is set). Leave empty to use the dark surface color. **pageHeaderOverlayColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme overlay, then the light surface color. **pageHeaderOverlayOpacity** `number | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Overlay opacity (%). 0 to 100. **pageHeaderFontOverrides** `readonly PageHeaderWidgetPageHeaderFontOverridesItem[]` **Sometimes sent:** `undefined` when the site leaves it out. A list of `PageHeaderWidgetPageHeaderFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. **PageHeaderWidgetPageHeaderFontOverridesItem** **id** `string` **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **target** `Target | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`; a newer site may send others, so keep a fallback. **source** `Source | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`; a newer site may send others, so keep a fallback. **slot** `Slot | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`; a newer site may send others, so keep a fallback. **curated** `Curated | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`; a newer site may send others, so keep a fallback. **cdnProvider** `CdnProvider | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`; a newer site may send others, so keep a fallback. **cdnFamily** `string` **Sometimes sent:** `undefined` when the site leaves it out. Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. **cdnWeights** `string` **Sometimes sent:** `undefined` when the site leaves it out. Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. **uploads** `readonly PageHeaderWidgetPageHeaderFontOverridesItemUploadsItem[]` **Sometimes sent:** `undefined` when the site leaves it out. A list of `PageHeaderWidgetPageHeaderFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. **PageHeaderWidgetPageHeaderFontOverridesItemUploadsItem** **file** `Readonly\\>` **Always sent.** File attachment reference. **id** `string` **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **weight** `Weight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`; a newer site may send others, so keep a fallback. **style** `Style | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Style. One of `normal`, `italic`; a newer site may send others, so keep a fallback. **fields** `Readonly\\>` **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **fallback** `Fallback | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`; a newer site may send others, so keep a fallback. **fields** `Readonly\\>` **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **pageHeaderPrimaryCtaLabel** `string` **Sometimes sent:** `undefined` when the site leaves it out. The visible button text. Leave empty to hide the button. **pageHeaderPrimaryCtaUrl** `string` **Sometimes sent:** `undefined` when the site leaves it out. Where the button goes — a path (/blog) or full URL. **pageHeaderPrimaryCtaNewTab** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. Opens the link in a new browser tab (adds rel="noopener noreferrer"). **pageHeaderPrimaryCtaVariant** `PageHeaderPrimaryCtaVariant | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`; a newer site may send others, so keep a fallback. **pageHeaderPrimaryCtaSize** `PageHeaderPrimaryCtaSize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Button size. One of `small`, `normal`, `large`; a newer site may send others, so keep a fallback. **pageHeaderPrimaryCtaRadius** `PageHeaderPrimaryCtaRadius | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Corner radius. One of `pill`, `rounded`, `slight`, `square`; a newer site may send others, so keep a fallback. **pageHeaderPrimaryCtaColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. **pageHeaderPrimaryCtaColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) **pageHeaderPrimaryCtaTextColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The text/icon color. Clear it to derive from the button color (readable on solid fills). **pageHeaderPrimaryCtaTextColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme label color. **pageHeaderPrimaryCtaHoverColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Drives the hover treatment. Leave empty to derive it from the button color. **pageHeaderPrimaryCtaHoverColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme hover color. **pageHeaderPrimaryCtaStyle** `PageHeaderPrimaryCtaStyle | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`; a newer site may send others, so keep a fallback. **pageHeaderPrimaryCtaShadowColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. **pageHeaderPrimaryCtaShadowColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme shadow color. **pageHeaderPrimaryCtaAnimation** `PageHeaderPrimaryCtaAnimation | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Hover motion. One of `lift`, `scale`, `lift-scale`, `none`; a newer site may send others, so keep a fallback. **pageHeaderPrimaryCtaIcon** `string` **Sometimes sent:** `undefined` when the site leaves it out. Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. **pageHeaderPrimaryCtaIconFamily** `PageHeaderPrimaryCtaIconFamily | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`; a newer site may send others, so keep a fallback. **pageHeaderPrimaryCtaIconPosition** `PageHeaderPrimaryCtaIconPosition | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`; a newer site may send others, so keep a fallback. **pageHeaderPrimaryCtaIconNudge** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. The icon slides toward its side on hover (e.g. an arrow edges outward). **pageHeaderSecondaryCtaLabel** `string` **Sometimes sent:** `undefined` when the site leaves it out. The visible button text. Leave empty to hide the button. **pageHeaderSecondaryCtaUrl** `string` **Sometimes sent:** `undefined` when the site leaves it out. Where the button goes — a path (/blog) or full URL. **pageHeaderSecondaryCtaNewTab** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. Opens the link in a new browser tab (adds rel="noopener noreferrer"). **pageHeaderSecondaryCtaVariant** `PageHeaderSecondaryCtaVariant | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`; a newer site may send others, so keep a fallback. **pageHeaderSecondaryCtaSize** `PageHeaderSecondaryCtaSize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Button size. One of `small`, `normal`, `large`; a newer site may send others, so keep a fallback. **pageHeaderSecondaryCtaRadius** `PageHeaderSecondaryCtaRadius | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Corner radius. One of `pill`, `rounded`, `slight`, `square`; a newer site may send others, so keep a fallback. **pageHeaderSecondaryCtaColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. **pageHeaderSecondaryCtaColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) **pageHeaderSecondaryCtaTextColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The text/icon color. Clear it to derive from the button color (readable on solid fills). **pageHeaderSecondaryCtaTextColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme label color. **pageHeaderSecondaryCtaHoverColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Drives the hover treatment. Leave empty to derive it from the button color. **pageHeaderSecondaryCtaHoverColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme hover color. **pageHeaderSecondaryCtaStyle** `PageHeaderSecondaryCtaStyle | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`; a newer site may send others, so keep a fallback. **pageHeaderSecondaryCtaShadowColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. **pageHeaderSecondaryCtaShadowColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme shadow color. **pageHeaderSecondaryCtaAnimation** `PageHeaderSecondaryCtaAnimation | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Hover motion. One of `lift`, `scale`, `lift-scale`, `none`; a newer site may send others, so keep a fallback. **pageHeaderSecondaryCtaIcon** `string` **Sometimes sent:** `undefined` when the site leaves it out. Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. **pageHeaderSecondaryCtaIconFamily** `PageHeaderSecondaryCtaIconFamily | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`; a newer site may send others, so keep a fallback. **pageHeaderSecondaryCtaIconPosition** `PageHeaderSecondaryCtaIconPosition | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`; a newer site may send others, so keep a fallback. **pageHeaderSecondaryCtaIconNudge** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. The icon slides toward its side on hover (e.g. an arrow edges outward). **sectionCss** `CustomCSS | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. **fields** `Readonly\\>` **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **HeroWidget** A `hero` widget: its `type` and its own fields. A field left out takes its default. **type** `HeroWidgetType` **Always sent.** The widget’s type: always `hero`. One of `hero`; a newer site may send others, so keep a fallback. **heroHeadline** `string` **Always sent.** Headline. **id** `string` **Sometimes sent:** `undefined` when the site leaves it out. The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. **metaType** `MetaType` **Sometimes sent:** `undefined` when the site leaves it out. Always `widget`. One of `widget`; a newer site may send others, so keep a fallback. **heroAlign** `HeroAlign | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Content alignment. One of `left`, `center`; a newer site may send others, so keep a fallback. **heroHeight** `HeroHeight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Full fills the screen (home pages); Compact is a short banner for interior pages. One of `full`, `tall`, `compact`; a newer site may send others, so keep a fallback. **heroGhostEnabled** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. Giant outlined word above the headline (same treatment as the footer wordmark). Reveals on hover. **heroGhostText** `string` **Sometimes sent:** `undefined` when the site leaves it out. Keep it short — one word reads best at display size. Leave empty to use the business name. **heroGhostSize** `HeroGhostSize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Ghost wordmark size. One of `display`, `large`, `medium`; a newer site may send others, so keep a fallback. **heroGhostFill** `HeroGhostFill | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Outlined letters that fill on hover one at a time, all at once, or always-solid (no ghost effect). One of `letter`, `word`, `solid`; a newer site may send others, so keep a fallback. **heroGhostFillColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Overrides the wordmark fill + outline tint in the dark theme. Leave empty to track the theme’s text color. **heroGhostFillColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override — handy over a fixed video/photo background that doesn’t switch with the theme. Falls back to the dark-theme color, then the theme default. **heroLockupEnabled** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. A small line (optional icon + business name) above the headline. Off by default when the ghost wordmark carries the brand. **heroEyebrowEnabled** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. Show eyebrow / kicker. **heroEyebrow** `string` **Sometimes sent:** `undefined` when the site leaves it out. Small label shown above the title. **heroEyebrowColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Overrides the eyebrow + its dash. Leave empty to use the secondary (mint) color. **heroEyebrowColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color, then the mint default. **heroEyebrowWeight** `HeroEyebrowWeight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Eyebrow weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **heroEyebrowSize** `HeroEyebrowSize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Eyebrow size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **heroEyebrowPlacement** `HeroEyebrowPlacement | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Eyebrow placement. One of `top`, `belowHeadline`, `aboveCta`; a newer site may send others, so keep a fallback. **heroHeadlineFill** `HeroHeadlineFill | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid is the standard headline. The outline options give the headline the same ghost treatment as the wordmark, filling on hover. (The accent sticker word stays solid.) One of `solid`, `letter`, `word`; a newer site may send others, so keep a fallback. **heroHeadlineFillColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Overrides the headline color in the dark theme. Leave empty to track the theme’s text color. **heroHeadlineFillColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override — handy over a fixed video/photo background. Falls back to the dark-theme color, then the theme default. **heroStickerEnabled** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. Wraps the final headline word in the solid accent “sticker”. Turn off for a plain headline. **heroStickerStyle** `HeroStickerStyle | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Dual layers a colored offset shadow behind the patch; single is one flat color. One of `dual`, `single`; a newer site may send others, so keep a fallback. **heroStickerColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Patch background. Leave empty to use the site primary/accent color. **heroStickerColorSecondary** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Offset-shadow layer. Leave empty to use the site secondary color. **heroLinkHoverFill** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. Hovering either the wordmark or the headline fills both at once. Only available when both are set to fill the whole word/headline on hover. **heroHashtagEnabled** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. A bold social hashtag (e.g. #behindthescenes) with its own placement, fill, and optional pill background. **heroHashtagText** `string` **Sometimes sent:** `undefined` when the site leaves it out. Include the # — e.g. #behindthescenes. **heroHashtagPlacement** `HeroHashtagPlacement | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Hashtag placement. One of `aboveGhost`, `aboveHeadline`, `belowHeadline`, `aboveCta`; a newer site may send others, so keep a fallback. **heroHashtagSize** `HeroHashtagSize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Smaller than the headline, but still a prominent element. One of `large`, `medium`, `small`; a newer site may send others, so keep a fallback. **heroHashtagFill** `HeroHashtagFill | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid color, or the same outlined “ghost” treatment as the headline that fills on hover. (Ignored when the Solid pill background is used.) One of `solid`, `letter`, `word`; a newer site may send others, so keep a fallback. **heroHashtagFillColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional text color (or outline tint). Leave empty to use the site accent color. **heroHashtagFillColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override — handy over a fixed video/photo background. Falls back to the dark-theme color, then the accent. **heroHashtagBackground** `HeroHashtagBackground | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. An optional patch behind the hashtag — a softer take on the headline sticker. One of `none`, `solid`, `outline`; a newer site may send others, so keep a fallback. **heroHashtagBgShape** `HeroHashtagBgShape | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Rounded pill or a squared patch like the headline sticker. One of `pill`, `square`; a newer site may send others, so keep a fallback. **heroHashtagBgColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Patch fill (solid) or border + text (outline). Leave empty to use the site accent color. **heroHashtagTilt** `HeroHashtagTilt | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A slight rotation, like the headline sticker. Works with or without a background. One of `none`, `left`, `right`; a newer site may send others, so keep a fallback. **heroIntro** `string` **Sometimes sent:** `undefined` when the site leaves it out. Intro copy. **heroIntroColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Overrides the intro text color. Leave empty for the muted default. **heroIntroColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override — handy over a fixed video/photo background. Falls back to the dark-theme color, then the muted default. **heroIntroWeight** `HeroIntroWeight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Intro weight. One of `normal`, `medium`, `semibold`, `bold`; a newer site may send others, so keep a fallback. **heroIconPlacement** `HeroIconPlacement | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where to place an optional Font Awesome icon. One of `none`, `lockup`, `aboveHeadline`, `aboveGhost`; a newer site may send others, so keep a fallback. **heroIcon** `string` **Sometimes sent:** `undefined` when the site leaves it out. Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. **heroIconFamily** `HeroIconFamily | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`; a newer site may send others, so keep a fallback. **heroIconColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to use the design’s own color rhythm. **heroIconAnimation** `HeroIconAnimation | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Icon animation. One of `none`, `fa-beat`, `fa-bounce`, `fa-fade`, `fa-beat-fade`, `fa-flip`, `fa-shake`, `fa-spin`; a newer site may send others, so keep a fallback. **heroBackgroundType** `HeroBackgroundType | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Background type. One of `gradient`, `image`, `video`; a newer site may send others, so keep a fallback. **heroImage** `ImageArea` **Sometimes sent:** `undefined` when the site leaves it out. An `ImageArea`. Used when background type is Image, and as the poster/fallback for Video. Widgets, top to bottom: send `{ "items": [ … ] }`, one object per widget with its `type`. Writing it replaces the whole area. Its fields are listed under the first `ImageArea` above. **heroVideo** `readonly Readonly\\>[]` **Sometimes sent:** `undefined` when the site leaves it out. Pick from the Videos library (⌘K → Videos). Short, muted loop; reduced-motion visitors get the fallback image instead. The related `video` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document (one at most); a document the site can’t find is left out. At most 1 items. **heroMotionPause** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. Adds a small, unobtrusive pause/play control so visitors can stop the auto-playing background motion (WCAG 2.2.2). Only appears when a moving background is set. **heroFontOverrides** `readonly HeroWidgetHeroFontOverridesItem[]` **Sometimes sent:** `undefined` when the site leaves it out. A list of `HeroWidgetHeroFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. **HeroWidgetHeroFontOverridesItem** **id** `string` **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **target** `Target | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`; a newer site may send others, so keep a fallback. **source** `Source | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`; a newer site may send others, so keep a fallback. **slot** `Slot | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`; a newer site may send others, so keep a fallback. **curated** `Curated | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`; a newer site may send others, so keep a fallback. **cdnProvider** `CdnProvider | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`; a newer site may send others, so keep a fallback. **cdnFamily** `string` **Sometimes sent:** `undefined` when the site leaves it out. Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. **cdnWeights** `string` **Sometimes sent:** `undefined` when the site leaves it out. Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. **uploads** `readonly HeroWidgetHeroFontOverridesItemUploadsItem[]` **Sometimes sent:** `undefined` when the site leaves it out. A list of `HeroWidgetHeroFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. **HeroWidgetHeroFontOverridesItemUploadsItem** **file** `Readonly\\>` **Always sent.** File attachment reference. **id** `string` **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **weight** `Weight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`; a newer site may send others, so keep a fallback. **style** `Style | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Style. One of `normal`, `italic`; a newer site may send others, so keep a fallback. **fields** `Readonly\\>` **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **fallback** `Fallback | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`; a newer site may send others, so keep a fallback. **fields** `Readonly\\>` **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **heroPrimaryCtaLabel** `string` **Sometimes sent:** `undefined` when the site leaves it out. The visible button text. Leave empty to hide the button. **heroPrimaryCtaUrl** `string` **Sometimes sent:** `undefined` when the site leaves it out. Where the button goes — a path (/blog) or full URL. **heroPrimaryCtaNewTab** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. Opens the link in a new browser tab (adds rel="noopener noreferrer"). **heroPrimaryCtaVariant** `HeroPrimaryCtaVariant | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`; a newer site may send others, so keep a fallback. **heroPrimaryCtaSize** `HeroPrimaryCtaSize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Button size. One of `small`, `normal`, `large`; a newer site may send others, so keep a fallback. **heroPrimaryCtaRadius** `HeroPrimaryCtaRadius | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Corner radius. One of `pill`, `rounded`, `slight`, `square`; a newer site may send others, so keep a fallback. **heroPrimaryCtaColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. **heroPrimaryCtaColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) **heroPrimaryCtaTextColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The text/icon color. Clear it to derive from the button color (readable on solid fills). **heroPrimaryCtaTextColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme label color. **heroPrimaryCtaHoverColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Drives the hover treatment. Leave empty to derive it from the button color. **heroPrimaryCtaHoverColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme hover color. **heroPrimaryCtaStyle** `HeroPrimaryCtaStyle | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`; a newer site may send others, so keep a fallback. **heroPrimaryCtaShadowColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. **heroPrimaryCtaShadowColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme shadow color. **heroPrimaryCtaAnimation** `HeroPrimaryCtaAnimation | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Hover motion. One of `lift`, `scale`, `lift-scale`, `none`; a newer site may send others, so keep a fallback. **heroPrimaryCtaIcon** `string` **Sometimes sent:** `undefined` when the site leaves it out. Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. **heroPrimaryCtaIconFamily** `HeroPrimaryCtaIconFamily | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`; a newer site may send others, so keep a fallback. **heroPrimaryCtaIconPosition** `HeroPrimaryCtaIconPosition | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`; a newer site may send others, so keep a fallback. **heroPrimaryCtaIconNudge** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. The icon slides toward its side on hover (e.g. an arrow edges outward). **heroSecondaryCtaLabel** `string` **Sometimes sent:** `undefined` when the site leaves it out. The visible button text. Leave empty to hide the button. **heroSecondaryCtaUrl** `string` **Sometimes sent:** `undefined` when the site leaves it out. Where the button goes — a path (/blog) or full URL. **heroSecondaryCtaNewTab** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. Opens the link in a new browser tab (adds rel="noopener noreferrer"). **heroSecondaryCtaVariant** `HeroSecondaryCtaVariant | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`; a newer site may send others, so keep a fallback. **heroSecondaryCtaSize** `HeroSecondaryCtaSize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Button size. One of `small`, `normal`, `large`; a newer site may send others, so keep a fallback. **heroSecondaryCtaRadius** `HeroSecondaryCtaRadius | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Corner radius. One of `pill`, `rounded`, `slight`, `square`; a newer site may send others, so keep a fallback. **heroSecondaryCtaColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. **heroSecondaryCtaColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) **heroSecondaryCtaTextColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The text/icon color. Clear it to derive from the button color (readable on solid fills). **heroSecondaryCtaTextColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme label color. **heroSecondaryCtaHoverColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Drives the hover treatment. Leave empty to derive it from the button color. **heroSecondaryCtaHoverColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme hover color. **heroSecondaryCtaStyle** `HeroSecondaryCtaStyle | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`; a newer site may send others, so keep a fallback. **heroSecondaryCtaShadowColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. **heroSecondaryCtaShadowColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme shadow color. **heroSecondaryCtaAnimation** `HeroSecondaryCtaAnimation | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Hover motion. One of `lift`, `scale`, `lift-scale`, `none`; a newer site may send others, so keep a fallback. **heroSecondaryCtaIcon** `string` **Sometimes sent:** `undefined` when the site leaves it out. Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. **heroSecondaryCtaIconFamily** `HeroSecondaryCtaIconFamily | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`; a newer site may send others, so keep a fallback. **heroSecondaryCtaIconPosition** `HeroSecondaryCtaIconPosition | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`; a newer site may send others, so keep a fallback. **heroSecondaryCtaIconNudge** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. The icon slides toward its side on hover (e.g. an arrow edges outward). **sectionCss** `CustomCSS | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. **fields** `Readonly\\>` **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **LayoutWidget** A `@apostrophecms/layout` widget: its `type` and its own fields. A field left out takes its default. **type** `LayoutWidgetType` **Always sent.** The widget’s type: always `@apostrophecms/layout`. One of `@apostrophecms/layout`; a newer site may send others, so keep a fallback. **id** `string` **Sometimes sent:** `undefined` when the site leaves it out. The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. **metaType** `MetaType` **Sometimes sent:** `undefined` when the site leaves it out. Always `widget`. One of `widget`; a newer site may send others, so keep a fallback. **columns** `LayoutColumnArea` **Sometimes sent:** `undefined` when the site leaves it out. A `LayoutColumnArea`. Widgets, top to bottom: send `{ "items": [ … ] }`, one object per widget with its `type`. Writing it replaces the whole area. **LayoutColumnArea** **metaType** `AfterContentAreaMetaType` **Sometimes sent:** `undefined` when the site leaves it out. Always `area`. One of `area`; a newer site may send others, so keep a fallback. **id** `string` **Sometimes sent:** `undefined` when the site leaves it out. The area’s id, set by the site: leave it out when you write one. **items** `readonly LayoutColumnWidget[]` **Sometimes sent:** `undefined` when the site leaves it out. A list of `LayoutColumnWidget`. The widgets, top to bottom. Each is an object with its `type` and that widget’s own fields; `_id` and `metaType` may be left out (the site sets them). **LayoutColumnWidget** A `@apostrophecms/layout-column` widget: its `type` and its own fields. A field left out takes its default. **type** `LayoutColumnWidgetType` **Always sent.** The widget’s type: always `@apostrophecms/layout-column`. One of `@apostrophecms/layout-column`; a newer site may send others, so keep a fallback. **id** `string` **Sometimes sent:** `undefined` when the site leaves it out. The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. **metaType** `MetaType` **Sometimes sent:** `undefined` when the site leaves it out. Always `widget`. One of `widget`; a newer site may send others, so keep a fallback. **colstart** `number | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Colstart. **colspan** `number | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Colspan. **rowstart** `number | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Rowstart. **rowspan** `number | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Rowspan. **order** `number | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Order. **content** `LayoutColumnContentArea` **Sometimes sent:** `undefined` when the site leaves it out. A `LayoutColumnContentArea`. Widgets, top to bottom: send `{ "items": [ … ] }`, one object per widget with its `type`. Writing it replaces the whole area. Its fields are listed under the first `LayoutColumnContentArea` above. **showTablet** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. Visible on tablet. **showMobile** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. Visible on mobile. **justify** `Justify | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Horizontal alignment. One of `stretch`, `start`, `end`, `center`; a newer site may send others, so keep a fallback. **align** `Align | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Vertical alignment. One of `stretch`, `start`, `end`, `center`; a newer site may send others, so keep a fallback. **fields** `Readonly\\>` **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **fields** `Readonly\\>` **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **sectionCss** `CustomCSS | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. **fields** `Readonly\\>` **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **IntroWidget** A `intro` widget: its `type` and its own fields. A field left out takes its default. **type** `IntroWidgetType` **Always sent.** The widget’s type: always `intro`. One of `intro`; a newer site may send others, so keep a fallback. **id** `string` **Sometimes sent:** `undefined` when the site leaves it out. The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. **metaType** `MetaType` **Sometimes sent:** `undefined` when the site leaves it out. Always `widget`. One of `widget`; a newer site may send others, so keep a fallback. **introEyebrow** `string` **Sometimes sent:** `undefined` when the site leaves it out. Small label shown above the title. **introEyebrowColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Overrides the eyebrow + its dash. Leave empty to use the secondary (mint) color. **introEyebrowColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color, then the mint default. **introEyebrowWeight** `IntroEyebrowWeight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Eyebrow weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **introEyebrowSize** `IntroEyebrowSize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Eyebrow size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **introHeadline** `string` **Sometimes sent:** `undefined` when the site leaves it out. Headline. **introHeadlineColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Overrides the headline color. Leave empty to track the theme’s text color. **introHeadlineColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color, then the theme default. **introHeadlineWeight** `IntroHeadlineWeight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Headline weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **introBody** `string` **Sometimes sent:** `undefined` when the site leaves it out. Body copy. **introBodyColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Overrides the body text color. Leave empty for the muted default. **introBodyColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color, then the muted default. **introBodyWeight** `IntroBodyWeight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Body weight. One of `normal`, `medium`, `semibold`, `bold`; a newer site may send others, so keep a fallback. **introPhotoPlacement** `IntroPhotoPlacement | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where the optional photo sits. Left/right place it beside the text; Full background fills the whole section behind the text (with a readability overlay). One of `none`, `left`, `right`, `background`; a newer site may send others, so keep a fallback. **introImage** `ImageArea` **Sometimes sent:** `undefined` when the site leaves it out. An `ImageArea`. Widgets, top to bottom: send `{ "items": [ … ] }`, one object per widget with its `type`. Writing it replaces the whole area. Its fields are listed under the first `ImageArea` above. **introPhotoCorners** `IntroPhotoCorners | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Photo corners. One of `rounded`, `squared`; a newer site may send others, so keep a fallback. **introPhotoFrame** `IntroPhotoFrame | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Border draws a frame around the photo; Offset adds a refined offset accent frame behind it. One of `none`, `border`, `offset`; a newer site may send others, so keep a fallback. **introPhotoFrameColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Border / offset-frame color. Leave empty to use the site accent color. **introPhotoTilt** `IntroPhotoTilt | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A slight rotation for a more playful look. One of `none`, `left`, `right`; a newer site may send others, so keep a fallback. **introPhotoHover** `IntroPhotoHover | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Photo hover effect. One of `none`, `lift`, `zoom`, `tilt`, `glow`, `lift-glow`, `zoom-glow`; a newer site may send others, so keep a fallback. **introOverlayColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Scrim behind the text over a full-background photo. Leave empty to use the dark surface color. **introOverlayColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme overlay, then the light surface color. **introOverlayOpacity** `number | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Overlay opacity (%). 0 to 100. **introBg** `IntroBg | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The section’s full-width background band in dark mode. Transparent lets the page background show through. The palette options track the site colors; choose “Custom color…” for a specific color. One of `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`; a newer site may send others, so keep a fallback. **introBgCustom** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Used when “Section background (dark theme)” is set to Custom color. **introBgLight** `IntroBgLight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. “Match dark theme” reuses the dark-theme choice; otherwise set the light-mode band independently. One of `inherit`, `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`; a newer site may send others, so keep a fallback. **introBgLightCustom** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Used when “Section background (light theme)” is set to Custom color. **introFontOverrides** `readonly IntroWidgetIntroFontOverridesItem[]` **Sometimes sent:** `undefined` when the site leaves it out. A list of `IntroWidgetIntroFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. **IntroWidgetIntroFontOverridesItem** **id** `string` **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **target** `Target | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`; a newer site may send others, so keep a fallback. **source** `Source | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`; a newer site may send others, so keep a fallback. **slot** `Slot | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`; a newer site may send others, so keep a fallback. **curated** `Curated | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`; a newer site may send others, so keep a fallback. **cdnProvider** `CdnProvider | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`; a newer site may send others, so keep a fallback. **cdnFamily** `string` **Sometimes sent:** `undefined` when the site leaves it out. Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. **cdnWeights** `string` **Sometimes sent:** `undefined` when the site leaves it out. Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. **uploads** `readonly IntroWidgetIntroFontOverridesItemUploadsItem[]` **Sometimes sent:** `undefined` when the site leaves it out. A list of `IntroWidgetIntroFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. **IntroWidgetIntroFontOverridesItemUploadsItem** **file** `Readonly\\>` **Always sent.** File attachment reference. **id** `string` **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **weight** `Weight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`; a newer site may send others, so keep a fallback. **style** `Style | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Style. One of `normal`, `italic`; a newer site may send others, so keep a fallback. **fields** `Readonly\\>` **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **fallback** `Fallback | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`; a newer site may send others, so keep a fallback. **fields** `Readonly\\>` **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **sectionCss** `CustomCSS | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. **fields** `Readonly\\>` **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **FeatureWidget** A `feature` widget: its `type` and its own fields. A field left out takes its default. **type** `FeatureWidgetType` **Always sent.** The widget’s type: always `feature`. One of `feature`; a newer site may send others, so keep a fallback. **id** `string` **Sometimes sent:** `undefined` when the site leaves it out. The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. **metaType** `MetaType` **Sometimes sent:** `undefined` when the site leaves it out. Always `widget`. One of `widget`; a newer site may send others, so keep a fallback. **featureColumns** `FeatureColumns | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Auto fits as many as comfortably fit and works for any number of cards. Or lock a maximum per row. One of `auto`, `2`, `3`, `4`; a newer site may send others, so keep a fallback. **featureGap** `FeatureGap | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Gap between cards. One of `tight`, `normal`, `roomy`; a newer site may send others, so keep a fallback. **featureCardSize** `FeatureCardSize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Scales padding, icon, title, and the index numeral together. One of `small`, `medium`, `large`; a newer site may send others, so keep a fallback. **featureCardStyle** `FeatureCardStyle | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The card treatment. Poster (the default) frames the card with an accent keyline; Raised is a quiet lit card; Luxe a frosted glass panel; Spine adds a color rail; Tint an accent wash; Ticket/Bracket/Forge/Press/Inlay are the graphic showstoppers. One of `raised`, `luxe`, `outline`, `plain`, `poster`, `edge`, `tint`, `ticket`, `bracket`, `forge`, `press`, `inlay`; a newer site may send others, so keep a fallback. **featureCardStyleRadius** `FeatureCardStyleRadius | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Corner rounding for each card. Default keeps the widget’s own tuned corners — except Forge, which defaults to tight machined corners matching its engraved frame. One of `default`, `square`, `slight`, `rounded`, `large`; a newer site may send others, so keep a fallback. **featureCardStyleAccentColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Colors the Spine rail, Bracket marks, Forge corner/frame and Press margin rule. Leave empty to use the brand accent. **featureCardStyleAccentColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **featureCardStyleForgeScope** `FeatureCardStyleForgeScope | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where the Forge plate wears its color: a single corner mark (the machinist’s datum, default) or the whole engraved frame. One of `corner`, `frame`; a newer site may send others, so keep a fallback. **featureCardStyleForgeWeight** `FeatureCardStyleForgeWeight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Thickness of the Forge corner mark / colored frame. One of `fine`, `medium`, `bold`; a newer site may send others, so keep a fallback. **featureCardHover** `FeatureCardHover | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How a card reacts on hover. Pop is the lift + hard offset shadow; Glow is a soft accent halo. One of `none`, `lift`, `pop`, `glow`, `border`; a newer site may send others, so keep a fallback. **featureCardHoverColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Border / shadow / glow color on hover. Leave empty to use the site accent color. **featureCardHoverColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color, then the accent. **featureNumbering** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. A big outlined numeral on each card (01, 02, …). Great for step-by-step sequences; turn off when the cards aren’t ordered. **featureNumberFill** `FeatureNumberFill | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Same treatment as the hero ghost text: all numbers solid, outlined and filling on hover, or always outlined. One of `solid`, `hover`, `outline`; a newer site may send others, so keep a fallback. **featureNumberColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Tints the numeral fill + outline. Leave empty to track the theme’s text color. **featureNumberColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color, then the theme default. **featureTitleColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Overrides the card title color. Leave empty to track the theme’s text color. **featureTitleColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color, then the theme default. **featureTitleWeight** `FeatureTitleWeight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Title weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **featureTextColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Overrides the card text color. Leave empty for the muted default. **featureTextColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color, then the muted default. **featureTextWeight** `FeatureTextWeight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Text weight. One of `normal`, `medium`, `semibold`, `bold`; a newer site may send others, so keep a fallback. **featureCards** `readonly FeatureWidgetFeatureCardsItem[]` **Sometimes sent:** `undefined` when the site leaves it out. A list of `FeatureWidgetFeatureCardsItem`. Feature cards. **FeatureWidgetFeatureCardsItem** **cardTitle** `string` **Always sent.** Title. **id** `string` **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **icon** `string` **Sometimes sent:** `undefined` when the site leaves it out. Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. **iconFamily** `IconFamily | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`; a newer site may send others, so keep a fallback. **iconColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to use the design’s own color rhythm. **iconAnimation** `IconAnimation | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Icon animation. One of `none`, `fa-beat`, `fa-bounce`, `fa-fade`, `fa-beat-fade`, `fa-flip`, `fa-shake`, `fa-spin`; a newer site may send others, so keep a fallback. **iconSize** `IconSize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Relative to the component’s base icon size. One of `default`, `sm`, `lg`, `xl`, `2xl`, `2x`, `3x`, `4x`, `5x`; a newer site may send others, so keep a fallback. **cardText** `string` **Sometimes sent:** `undefined` when the site leaves it out. Text. **fields** `Readonly\\>` **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **featureBg** `FeatureBg | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The section’s full-width background band in dark mode. Transparent lets the page background show through. The palette options track the site colors; choose “Custom color…” for a specific color. One of `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`; a newer site may send others, so keep a fallback. **featureBgCustom** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Used when “Section background (dark theme)” is set to Custom color. **featureBgLight** `FeatureBgLight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. “Match dark theme” reuses the dark-theme choice; otherwise set the light-mode band independently. One of `inherit`, `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`; a newer site may send others, so keep a fallback. **featureBgLightCustom** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Used when “Section background (light theme)” is set to Custom color. **featureFontOverrides** `readonly FeatureWidgetFeatureFontOverridesItem[]` **Sometimes sent:** `undefined` when the site leaves it out. A list of `FeatureWidgetFeatureFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. **FeatureWidgetFeatureFontOverridesItem** **id** `string` **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **target** `Target | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`; a newer site may send others, so keep a fallback. **source** `Source | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`; a newer site may send others, so keep a fallback. **slot** `Slot | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`; a newer site may send others, so keep a fallback. **curated** `Curated | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`; a newer site may send others, so keep a fallback. **cdnProvider** `CdnProvider | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`; a newer site may send others, so keep a fallback. **cdnFamily** `string` **Sometimes sent:** `undefined` when the site leaves it out. Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. **cdnWeights** `string` **Sometimes sent:** `undefined` when the site leaves it out. Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. **uploads** `readonly FeatureWidgetFeatureFontOverridesItemUploadsItem[]` **Sometimes sent:** `undefined` when the site leaves it out. A list of `FeatureWidgetFeatureFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. **FeatureWidgetFeatureFontOverridesItemUploadsItem** **file** `Readonly\\>` **Always sent.** File attachment reference. **id** `string` **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **weight** `Weight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`; a newer site may send others, so keep a fallback. **style** `Style | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Style. One of `normal`, `italic`; a newer site may send others, so keep a fallback. **fields** `Readonly\\>` **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **fallback** `Fallback | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`; a newer site may send others, so keep a fallback. **fields** `Readonly\\>` **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **sectionCss** `CustomCSS | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. **fields** `Readonly\\>` **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **StatsWidget** A `stats` widget: its `type` and its own fields. A field left out takes its default. **type** `StatsWidgetType` **Always sent.** The widget’s type: always `stats`. One of `stats`; a newer site may send others, so keep a fallback. **id** `string` **Sometimes sent:** `undefined` when the site leaves it out. The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. **metaType** `MetaType` **Sometimes sent:** `undefined` when the site leaves it out. Always `widget`. One of `widget`; a newer site may send others, so keep a fallback. **statsEyebrowEnabled** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. A small label above the heading (e.g. "By the numbers"). **statsEyebrow** `string` **Sometimes sent:** `undefined` when the site leaves it out. Eyebrow. **statsEyebrowColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to use the secondary (mint) color. **statsEyebrowColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **statsEyebrowWeight** `StatsEyebrowWeight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Eyebrow weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **statsEyebrowSize** `StatsEyebrowSize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Eyebrow size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **statsHeading** `string` **Sometimes sent:** `undefined` when the site leaves it out. Optional. Leave empty to show just the numbers. **statsHeadingColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to track the theme text color. **statsHeadingColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **statsHeadingWeight** `StatsHeadingWeight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Heading weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **statsColumns** `StatsColumns | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Auto fits as many as comfortably fit and works for any number of stats. Or lock a maximum per row. One of `auto`, `2`, `3`, `4`; a newer site may send others, so keep a fallback. **statsGap** `StatsGap | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Gap between stats. One of `tight`, `normal`, `roomy`; a newer site may send others, so keep a fallback. **statsSize** `StatsSize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The baseline scale for the whole stat (value / icon / label / description stay proportional). Fine-tune any single element with its own size control below. One of `small`, `medium`, `large`; a newer site may send others, so keep a fallback. **statsAlign** `StatsAlign | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Alignment. One of `center`, `left`; a newer site may send others, so keep a fallback. **statsDividers** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. A hairline rule between each stat — the classic "by the numbers" rail. **statsCountUp** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. Numbers tick up from zero when the band scrolls into view. Non-numeric values and reduced-motion visitors simply show the final value. **statsIconSize** `StatsIconSize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Size of the icon above each number, independent of the overall stat size. One of `auto`, `sm`, `md`, `lg`, `xl`, `xxl`; a newer site may send others, so keep a fallback. **statsIconGap** `StatsIconGap | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Space between the icon and the number below it. One of `tight`, `normal`, `roomy`; a newer site may send others, so keep a fallback. **statsValueSize** `StatsValueSize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Value size. One of `auto`, `xs`, `sm`, `md`, `lg`, `xl`; a newer site may send others, so keep a fallback. **statsValueWeight** `StatsValueWeight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Value weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **statsValueColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The big numeral. Optional — leave empty to use the site accent color. **statsValueColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color, then the accent. **statsLabelSize** `StatsLabelSize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Label size. One of `auto`, `xs`, `sm`, `md`, `lg`, `xl`; a newer site may send others, so keep a fallback. **statsLabelWeight** `StatsLabelWeight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Label weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **statsLabelColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to track the theme text color. **statsLabelColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **statsDescriptionSize** `StatsDescriptionSize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Description size. One of `auto`, `xs`, `sm`, `md`, `lg`, `xl`; a newer site may send others, so keep a fallback. **statsDescriptionWeight** `StatsDescriptionWeight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Description weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **statsDescriptionColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to use the muted text color. **statsDescriptionColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **stats** `readonly StatsWidgetStatsItem[]` **Sometimes sent:** `undefined` when the site leaves it out. A list of `StatsWidgetStatsItem`. Stats. **StatsWidgetStatsItem** **value** `string` **Always sent.** The number, e.g. 500, 4.9, 12 — symbols go in the prefix/suffix so the count-up animates the number alone. **label** `string` **Always sent.** Label. **id** `string` **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **icon** `string` **Sometimes sent:** `undefined` when the site leaves it out. Optional Font Awesome icon shown above the number (e.g. star, bolt, chart-line). Leave empty for no icon. **iconFamily** `IconFamily | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`; a newer site may send others, so keep a fallback. **iconColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to use the design’s own color rhythm. **valuePrefix** `string` **Sometimes sent:** `undefined` when the site leaves it out. Optional, shown before the number (e.g. \$, \~, >). Kept out of the count-up. **valueSuffix** `string` **Sometimes sent:** `undefined` when the site leaves it out. Optional, shown after the number (e.g. +, %, k, yrs, ★). **description** `string` **Sometimes sent:** `undefined` when the site leaves it out. Optional small text under the label. **fields** `Readonly\\>` **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **statsBg** `StatsBg | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The section’s full-width background band in dark mode. Transparent lets the page background show through. The palette options track the site colors; choose “Custom color…” for a specific color. One of `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`; a newer site may send others, so keep a fallback. **statsBgCustom** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Used when “Section background (dark theme)” is set to Custom color. **statsBgLight** `StatsBgLight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. “Match dark theme” reuses the dark-theme choice; otherwise set the light-mode band independently. One of `inherit`, `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`; a newer site may send others, so keep a fallback. **statsBgLightCustom** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Used when “Section background (light theme)” is set to Custom color. **statsFontOverrides** `readonly StatsWidgetStatsFontOverridesItem[]` **Sometimes sent:** `undefined` when the site leaves it out. A list of `StatsWidgetStatsFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. **StatsWidgetStatsFontOverridesItem** **id** `string` **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **target** `Target | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`; a newer site may send others, so keep a fallback. **source** `Source | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`; a newer site may send others, so keep a fallback. **slot** `Slot | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`; a newer site may send others, so keep a fallback. **curated** `Curated | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`; a newer site may send others, so keep a fallback. **cdnProvider** `CdnProvider | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`; a newer site may send others, so keep a fallback. **cdnFamily** `string` **Sometimes sent:** `undefined` when the site leaves it out. Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. **cdnWeights** `string` **Sometimes sent:** `undefined` when the site leaves it out. Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. **uploads** `readonly StatsWidgetStatsFontOverridesItemUploadsItem[]` **Sometimes sent:** `undefined` when the site leaves it out. A list of `StatsWidgetStatsFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. **StatsWidgetStatsFontOverridesItemUploadsItem** **file** `Readonly\\>` **Always sent.** File attachment reference. **id** `string` **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **weight** `Weight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`; a newer site may send others, so keep a fallback. **style** `Style | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Style. One of `normal`, `italic`; a newer site may send others, so keep a fallback. **fields** `Readonly\\>` **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **fallback** `Fallback | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`; a newer site may send others, so keep a fallback. **fields** `Readonly\\>` **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **statsCtaLabel** `string` **Sometimes sent:** `undefined` when the site leaves it out. The visible button text. Leave empty to hide the button. **statsCtaUrl** `string` **Sometimes sent:** `undefined` when the site leaves it out. Where the button goes — a path (/blog) or full URL. **statsCtaNewTab** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. Opens the link in a new browser tab (adds rel="noopener noreferrer"). **statsCtaVariant** `StatsCtaVariant | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`; a newer site may send others, so keep a fallback. **statsCtaSize** `StatsCtaSize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Button size. One of `small`, `normal`, `large`; a newer site may send others, so keep a fallback. **statsCtaRadius** `StatsCtaRadius | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Corner radius. One of `pill`, `rounded`, `slight`, `square`; a newer site may send others, so keep a fallback. **statsCtaColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. **statsCtaColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) **statsCtaTextColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The text/icon color. Clear it to derive from the button color (readable on solid fills). **statsCtaTextColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme label color. **statsCtaHoverColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Drives the hover treatment. Leave empty to derive it from the button color. **statsCtaHoverColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme hover color. **statsCtaStyle** `StatsCtaStyle | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`; a newer site may send others, so keep a fallback. **statsCtaShadowColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. **statsCtaShadowColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme shadow color. **statsCtaAnimation** `StatsCtaAnimation | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Hover motion. One of `lift`, `scale`, `lift-scale`, `none`; a newer site may send others, so keep a fallback. **statsCtaIcon** `string` **Sometimes sent:** `undefined` when the site leaves it out. Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. **statsCtaIconFamily** `StatsCtaIconFamily | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`; a newer site may send others, so keep a fallback. **statsCtaIconPosition** `StatsCtaIconPosition | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`; a newer site may send others, so keep a fallback. **statsCtaIconNudge** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. The icon slides toward its side on hover (e.g. an arrow edges outward). **sectionCss** `CustomCSS | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. **fields** `Readonly\\>` **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **LogosWidget** A `logos` widget: its `type` and its own fields. A field left out takes its default. **type** `LogosWidgetType` **Always sent.** The widget’s type: always `logos`. One of `logos`; a newer site may send others, so keep a fallback. **id** `string` **Sometimes sent:** `undefined` when the site leaves it out. The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. **metaType** `MetaType` **Sometimes sent:** `undefined` when the site leaves it out. Always `widget`. One of `widget`; a newer site may send others, so keep a fallback. **logosEyebrowEnabled** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. A small label above the heading (e.g. "Trusted by"). **logosEyebrow** `string` **Sometimes sent:** `undefined` when the site leaves it out. Eyebrow. **logosEyebrowColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to use the secondary (mint) color. **logosEyebrowColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **logosEyebrowWeight** `LogosEyebrowWeight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Eyebrow weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **logosEyebrowSize** `LogosEyebrowSize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Eyebrow size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **logosHeading** `string` **Sometimes sent:** `undefined` when the site leaves it out. Optional. Leave empty to show just the logos. **logosHeadingColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to track the theme text color. **logosHeadingColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **logosHeadingWeight** `LogosHeadingWeight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Heading weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **logosIntro** `string` **Sometimes sent:** `undefined` when the site leaves it out. Optional short sentence under the heading. **logosIntroColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to use the muted text color. **logosIntroColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **logosIntroWeight** `LogosIntroWeight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Intro weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **logosDisplay** `LogosDisplay | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A slow scrolling ribbon (marquee) or a calm static grid. One of `marquee`, `grid`; a newer site may send others, so keep a fallback. **logosSpeed** `LogosSpeed | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Marquee speed. One of `slow`, `normal`, `fast`; a newer site may send others, so keep a fallback. **logosDirection** `LogosDirection | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Marquee direction. One of `left`, `right`; a newer site may send others, so keep a fallback. **logosMotionPause** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. Adds a small, unobtrusive pause/play control so visitors can stop the auto-playing background motion (WCAG 2.2.2). Only appears when a moving background is set. **logosColumns** `LogosColumns | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Auto fits as many as comfortably fit and works for any number of logos. Or lock a maximum per row. One of `auto`, `3`, `4`, `5`, `6`; a newer site may send others, so keep a fallback. **logosGap** `LogosGap | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Gap between logos. One of `tight`, `normal`, `roomy`; a newer site may send others, so keep a fallback. **logosSize** `LogosSize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The height each logo is scaled to (width follows the logo’s aspect ratio). One of `small`, `medium`, `large`; a newer site may send others, so keep a fallback. **logosAlign** `LogosAlign | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Aligns the eyebrow / heading / intro (and the grid when there are few logos). One of `center`, `left`; a newer site may send others, so keep a fallback. **logosTile** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. Sets every logo on a raised, bordered card. Off = logos sit straight on the background. **logosGrayscale** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. Mutes the logos to grayscale and dims them, returning to full color on hover — the classic logo-wall look. **logos** `readonly LogosWidgetLogosItem[]` **Sometimes sent:** `undefined` when the site leaves it out. A list of `LogosWidgetLogosItem`. Logos. **LogosWidgetLogosItem** **image** `readonly Readonly\\>[]` **Always sent.** Pick a logo from the Images library. A transparent PNG or an SVG works best. The related `@apostrophecms/image` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document (one at most); a document the site can’t find is left out. At most 1 items. **name** `string` **Always sent.** Company / partner / certification name — used as the image alt text and the link title. **id** `string` **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **linkUrl** `string` **Sometimes sent:** `undefined` when the site leaves it out. Make this logo a link, e.g. to the partner’s site. Opens in a new tab for external URLs. **invertDark** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. For dark / black logos that would vanish on the dark theme — flips them to light. Leave off for full-color or white logos. **fields** `Readonly\\>` **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **logosBg** `LogosBg | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The section’s full-width background band in dark mode. Transparent lets the page background show through. The palette options track the site colors; choose “Custom color…” for a specific color. One of `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`; a newer site may send others, so keep a fallback. **logosBgCustom** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Used when “Section background (dark theme)” is set to Custom color. **logosBgLight** `LogosBgLight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. “Match dark theme” reuses the dark-theme choice; otherwise set the light-mode band independently. One of `inherit`, `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`; a newer site may send others, so keep a fallback. **logosBgLightCustom** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Used when “Section background (light theme)” is set to Custom color. **logosFontOverrides** `readonly LogosWidgetLogosFontOverridesItem[]` **Sometimes sent:** `undefined` when the site leaves it out. A list of `LogosWidgetLogosFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. **LogosWidgetLogosFontOverridesItem** **id** `string` **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **target** `Target | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`; a newer site may send others, so keep a fallback. **source** `Source | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`; a newer site may send others, so keep a fallback. **slot** `Slot | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`; a newer site may send others, so keep a fallback. **curated** `Curated | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`; a newer site may send others, so keep a fallback. **cdnProvider** `CdnProvider | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`; a newer site may send others, so keep a fallback. **cdnFamily** `string` **Sometimes sent:** `undefined` when the site leaves it out. Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. **cdnWeights** `string` **Sometimes sent:** `undefined` when the site leaves it out. Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. **uploads** `readonly LogosWidgetLogosFontOverridesItemUploadsItem[]` **Sometimes sent:** `undefined` when the site leaves it out. A list of `LogosWidgetLogosFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. **LogosWidgetLogosFontOverridesItemUploadsItem** **file** `Readonly\\>` **Always sent.** File attachment reference. **id** `string` **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **weight** `Weight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`; a newer site may send others, so keep a fallback. **style** `Style | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Style. One of `normal`, `italic`; a newer site may send others, so keep a fallback. **fields** `Readonly\\>` **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **fallback** `Fallback | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`; a newer site may send others, so keep a fallback. **fields** `Readonly\\>` **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **logosCtaLabel** `string` **Sometimes sent:** `undefined` when the site leaves it out. The visible button text. Leave empty to hide the button. **logosCtaUrl** `string` **Sometimes sent:** `undefined` when the site leaves it out. Where the button goes — a path (/blog) or full URL. **logosCtaNewTab** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. Opens the link in a new browser tab (adds rel="noopener noreferrer"). **logosCtaVariant** `LogosCtaVariant | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`; a newer site may send others, so keep a fallback. **logosCtaSize** `LogosCtaSize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Button size. One of `small`, `normal`, `large`; a newer site may send others, so keep a fallback. **logosCtaRadius** `LogosCtaRadius | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Corner radius. One of `pill`, `rounded`, `slight`, `square`; a newer site may send others, so keep a fallback. **logosCtaColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. **logosCtaColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) **logosCtaTextColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The text/icon color. Clear it to derive from the button color (readable on solid fills). **logosCtaTextColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme label color. **logosCtaHoverColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Drives the hover treatment. Leave empty to derive it from the button color. **logosCtaHoverColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme hover color. **logosCtaStyle** `LogosCtaStyle | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`; a newer site may send others, so keep a fallback. **logosCtaShadowColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. **logosCtaShadowColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme shadow color. **logosCtaAnimation** `LogosCtaAnimation | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Hover motion. One of `lift`, `scale`, `lift-scale`, `none`; a newer site may send others, so keep a fallback. **logosCtaIcon** `string` **Sometimes sent:** `undefined` when the site leaves it out. Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. **logosCtaIconFamily** `LogosCtaIconFamily | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`; a newer site may send others, so keep a fallback. **logosCtaIconPosition** `LogosCtaIconPosition | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`; a newer site may send others, so keep a fallback. **logosCtaIconNudge** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. The icon slides toward its side on hover (e.g. an arrow edges outward). **sectionCss** `CustomCSS | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. **fields** `Readonly\\>` **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **StepsWidget** A `steps` widget: its `type` and its own fields. A field left out takes its default. **type** `StepsWidgetType` **Always sent.** The widget’s type: always `steps`. One of `steps`; a newer site may send others, so keep a fallback. **id** `string` **Sometimes sent:** `undefined` when the site leaves it out. The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. **metaType** `MetaType` **Sometimes sent:** `undefined` when the site leaves it out. Always `widget`. One of `widget`; a newer site may send others, so keep a fallback. **stepsEyebrowEnabled** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. A small label above the heading (e.g. "How it works"). **stepsEyebrow** `string` **Sometimes sent:** `undefined` when the site leaves it out. Eyebrow. **stepsEyebrowColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to use the secondary (mint) color. **stepsEyebrowColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **stepsEyebrowWeight** `StepsEyebrowWeight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Eyebrow weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **stepsEyebrowSize** `StepsEyebrowSize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Eyebrow size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **stepsHeading** `string` **Sometimes sent:** `undefined` when the site leaves it out. Optional. Leave empty to show just the steps. **stepsHeadingColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to track the theme text color. **stepsHeadingColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **stepsHeadingWeight** `StepsHeadingWeight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Heading weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **stepsHeadingSize** `StepsHeadingSize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Heading size. One of `small`, `normal`, `large`, `xlarge`, `xxlarge`; a newer site may send others, so keep a fallback. **stepsIntro** `string` **Sometimes sent:** `undefined` when the site leaves it out. Optional short sentence under the heading. **stepsIntroColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to use the muted text color. **stepsIntroColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **stepsIntroWeight** `StepsIntroWeight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Intro weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **stepsIntroSize** `StepsIntroSize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Intro size. One of `small`, `normal`, `large`, `xlarge`, `xxlarge`; a newer site may send others, so keep a fallback. **stepsLayout** `StepsLayout | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Horizontal lays the steps across a row (marker on top); Vertical stacks them as a classic timeline (marker on the left). One of `horizontal`, `vertical`; a newer site may send others, so keep a fallback. **stepsColumns** `StepsColumns | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Horizontal only. Auto fits as many as comfortably fit and works for any number of steps. Or lock a maximum per row. One of `auto`, `2`, `3`, `4`; a newer site may send others, so keep a fallback. **stepsGap** `StepsGap | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Gap between steps. One of `tight`, `normal`, `roomy`; a newer site may send others, so keep a fallback. **stepsAlign** `StepsAlign | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Horizontal only — aligns the section header and each step’s text. (Vertical is always left-aligned beside its marker.) One of `center`, `left`; a newer site may send others, so keep a fallback. **stepsConnector** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. A line linking the step markers into a timeline (down the markers when vertical, across them when horizontal). **stepsCardStyle** `StepsCardStyle | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Plain keeps the connector-linked timeline (just marker + text, no card). Every other style boxes each step — Raised is a quiet lit card, Luxe a frosted glass panel, Outline a plaque frame, Spine adds a color rail, Tint an accent wash; Ticket/Bracket/Forge/Press/Inlay are the graphic showstoppers. One of `raised`, `luxe`, `outline`, `plain`, `poster`, `edge`, `tint`, `ticket`, `bracket`, `forge`, `press`, `inlay`; a newer site may send others, so keep a fallback. **stepsCardStyleRadius** `StepsCardStyleRadius | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Corner rounding for each card. Default keeps the widget’s own tuned corners — except Forge, which defaults to tight machined corners matching its engraved frame. One of `default`, `square`, `slight`, `rounded`, `large`; a newer site may send others, so keep a fallback. **stepsCardStyleAccentColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Colors the Spine rail, Bracket marks, Forge corner/frame and Press margin rule. Leave empty to use the brand accent. **stepsCardStyleAccentColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **stepsCardStyleForgeScope** `StepsCardStyleForgeScope | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where the Forge plate wears its color: a single corner mark (the machinist’s datum, default) or the whole engraved frame. One of `corner`, `frame`; a newer site may send others, so keep a fallback. **stepsCardStyleForgeWeight** `StepsCardStyleForgeWeight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Thickness of the Forge corner mark / colored frame. One of `fine`, `medium`, `bold`; a newer site may send others, so keep a fallback. **stepsCardHover** `StepsCardHover | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. What a boxed step does on hover (applies when Step style is not Plain). Lift/Pop/Press/Glow/Outline are instant; Sheen sweeps a light across; Tilt, Magnetic and Spotlight follow the cursor (need site animations on). One of `none`, `lift`, `pop`, `press`, `glow`, `border`, `sheen`, `tilt`, `magnetic`, `spotlight`; a newer site may send others, so keep a fallback. **stepsMarker** `StepsMarker | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Number auto-counts 1, 2, 3…; Icon shows each step’s icon (falling back to the number when a step has none); None hides the marker badge. One of `number`, `icon`, `none`; a newer site may send others, so keep a fallback. **stepsMarkerStyle** `StepsMarkerStyle | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Soft is a tinted accent badge; Filled is a solid accent badge; Outline is a bordered badge. One of `soft`, `filled`, `outline`; a newer site may send others, so keep a fallback. **stepsMarkerShape** `StepsMarkerShape | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Marker shape. One of `circle`, `rounded`, `square`; a newer site may send others, so keep a fallback. **stepsMarkerSize** `StepsMarkerSize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Marker size. One of `small`, `medium`, `large`; a newer site may send others, so keep a fallback. **stepsAccentColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Color for the marker badge and the connector line. Leave empty to use the site accent color. **stepsAccentColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme accent. **stepsTitleSize** `StepsTitleSize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Title size. One of `small`, `normal`, `large`, `xlarge`, `xxlarge`; a newer site may send others, so keep a fallback. **stepsTitleWeight** `StepsTitleWeight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Title weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **stepsTitleColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to track the theme text color. **stepsTitleColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **stepsBodySize** `StepsBodySize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Body size. One of `small`, `normal`, `large`, `xlarge`, `xxlarge`; a newer site may send others, so keep a fallback. **stepsBodyWeight** `StepsBodyWeight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Body weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **stepsBodyColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to use the muted text color. **stepsBodyColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **stepsItems** `readonly StepsWidgetStepsItemsItem[]` **Sometimes sent:** `undefined` when the site leaves it out. A list of `StepsWidgetStepsItemsItem`. Each item is one step in the process. They render in this order; the number marker counts automatically. **StepsWidgetStepsItemsItem** **title** `string` **Always sent.** Title. **id** `string` **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **icon** `string` **Sometimes sent:** `undefined` when the site leaves it out. Optional Font Awesome icon for this step (e.g. calendar-check, circle-check, gear). Shown in the marker when the section marker is set to "Icon"; otherwise the step is numbered. **iconFamily** `IconFamily | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`; a newer site may send others, so keep a fallback. **iconColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to use the design’s own color rhythm. **number** `string` **Sometimes sent:** `undefined` when the site leaves it out. Overrides the auto number for this step’s marker, e.g. "01" or "A". Leave empty to auto-count. **body** `string` **Sometimes sent:** `undefined` when the site leaves it out. Optional description under the title. **fields** `Readonly\\>` **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **stepsBg** `StepsBg | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The section’s full-width background band in dark mode. Transparent lets the page background show through. The palette options track the site colors; choose “Custom color…” for a specific color. One of `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`; a newer site may send others, so keep a fallback. **stepsBgCustom** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Used when “Section background (dark theme)” is set to Custom color. **stepsBgLight** `StepsBgLight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. “Match dark theme” reuses the dark-theme choice; otherwise set the light-mode band independently. One of `inherit`, `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`; a newer site may send others, so keep a fallback. **stepsBgLightCustom** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Used when “Section background (light theme)” is set to Custom color. **stepsFontOverrides** `readonly StepsWidgetStepsFontOverridesItem[]` **Sometimes sent:** `undefined` when the site leaves it out. A list of `StepsWidgetStepsFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. **StepsWidgetStepsFontOverridesItem** **id** `string` **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **target** `Target | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`; a newer site may send others, so keep a fallback. **source** `Source | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`; a newer site may send others, so keep a fallback. **slot** `Slot | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`; a newer site may send others, so keep a fallback. **curated** `Curated | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`; a newer site may send others, so keep a fallback. **cdnProvider** `CdnProvider | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`; a newer site may send others, so keep a fallback. **cdnFamily** `string` **Sometimes sent:** `undefined` when the site leaves it out. Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. **cdnWeights** `string` **Sometimes sent:** `undefined` when the site leaves it out. Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. **uploads** `readonly StepsWidgetStepsFontOverridesItemUploadsItem[]` **Sometimes sent:** `undefined` when the site leaves it out. A list of `StepsWidgetStepsFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. **StepsWidgetStepsFontOverridesItemUploadsItem** **file** `Readonly\\>` **Always sent.** File attachment reference. **id** `string` **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **weight** `Weight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`; a newer site may send others, so keep a fallback. **style** `Style | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Style. One of `normal`, `italic`; a newer site may send others, so keep a fallback. **fields** `Readonly\\>` **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **fallback** `Fallback | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`; a newer site may send others, so keep a fallback. **fields** `Readonly\\>` **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **stepsCtaLabel** `string` **Sometimes sent:** `undefined` when the site leaves it out. The visible button text. Leave empty to hide the button. **stepsCtaUrl** `string` **Sometimes sent:** `undefined` when the site leaves it out. Where the button goes — a path (/blog) or full URL. **stepsCtaNewTab** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. Opens the link in a new browser tab (adds rel="noopener noreferrer"). **stepsCtaVariant** `StepsCtaVariant | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`; a newer site may send others, so keep a fallback. **stepsCtaSize** `StepsCtaSize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Button size. One of `small`, `normal`, `large`; a newer site may send others, so keep a fallback. **stepsCtaRadius** `StepsCtaRadius | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Corner radius. One of `pill`, `rounded`, `slight`, `square`; a newer site may send others, so keep a fallback. **stepsCtaColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. **stepsCtaColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) **stepsCtaTextColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The text/icon color. Clear it to derive from the button color (readable on solid fills). **stepsCtaTextColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme label color. **stepsCtaHoverColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Drives the hover treatment. Leave empty to derive it from the button color. **stepsCtaHoverColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme hover color. **stepsCtaStyle** `StepsCtaStyle | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`; a newer site may send others, so keep a fallback. **stepsCtaShadowColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. **stepsCtaShadowColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme shadow color. **stepsCtaAnimation** `StepsCtaAnimation | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Hover motion. One of `lift`, `scale`, `lift-scale`, `none`; a newer site may send others, so keep a fallback. **stepsCtaIcon** `string` **Sometimes sent:** `undefined` when the site leaves it out. Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. **stepsCtaIconFamily** `StepsCtaIconFamily | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`; a newer site may send others, so keep a fallback. **stepsCtaIconPosition** `StepsCtaIconPosition | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`; a newer site may send others, so keep a fallback. **stepsCtaIconNudge** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. The icon slides toward its side on hover (e.g. an arrow edges outward). **sectionCss** `CustomCSS | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. **fields** `Readonly\\>` **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **MediaTextWidget** A `media-text` widget: its `type` and its own fields. A field left out takes its default. **type** `MediaTextWidgetType` **Always sent.** The widget’s type: always `media-text`. One of `media-text`; a newer site may send others, so keep a fallback. **id** `string` **Sometimes sent:** `undefined` when the site leaves it out. The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. **metaType** `MetaType` **Sometimes sent:** `undefined` when the site leaves it out. Always `widget`. One of `widget`; a newer site may send others, so keep a fallback. **mediaTextEyebrowEnabled** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. A small label above the section heading (e.g. "Why us"). **mediaTextEyebrow** `string` **Sometimes sent:** `undefined` when the site leaves it out. Eyebrow. **mediaTextEyebrowColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to use the secondary (mint) color. **mediaTextEyebrowColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **mediaTextEyebrowWeight** `MediaTextEyebrowWeight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Eyebrow weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **mediaTextEyebrowSize** `MediaTextEyebrowSize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Eyebrow size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **mediaTextHeading** `string` **Sometimes sent:** `undefined` when the site leaves it out. Optional section heading above the blocks. Leave empty to show just the blocks. **mediaTextHeadingColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to track the theme text color. **mediaTextHeadingColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **mediaTextHeadingWeight** `MediaTextHeadingWeight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Heading weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **mediaTextHeadingSize** `MediaTextHeadingSize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Heading size. One of `small`, `normal`, `large`, `xlarge`, `xxlarge`; a newer site may send others, so keep a fallback. **mediaTextIntro** `string` **Sometimes sent:** `undefined` when the site leaves it out. Optional short sentence under the heading. **mediaTextIntroColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to use the muted text color. **mediaTextIntroColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **mediaTextIntroWeight** `MediaTextIntroWeight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Intro weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **mediaTextIntroSize** `MediaTextIntroSize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Intro size. One of `small`, `normal`, `large`, `xlarge`, `xxlarge`; a newer site may send others, so keep a fallback. **mediaTextAlign** `MediaTextAlign | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Aligns the section header and the text inside each block. (Side-by-side rows usually read best left-aligned.) One of `left`, `center`; a newer site may send others, so keep a fallback. **mediaTextRatio** `MediaTextRatio | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. For media-left / media-right rows: how the two columns share the width. One of `balanced`, `media`, `text`; a newer site may send others, so keep a fallback. **mediaTextVAlign** `MediaTextVAlign | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. For media-left / media-right rows: how the text lines up against the media. One of `center`, `top`; a newer site may send others, so keep a fallback. **mediaTextMediaRatio** `MediaTextMediaRatio | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Aspect ratio of the media frame. Auto keeps an image at its natural shape (videos and embeds always use a ratio). One of `auto`, `landscape`, `standard`, `square`, `portrait`, `wide`; a newer site may send others, so keep a fallback. **mediaTextMediaRadius** `MediaTextMediaRadius | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Media corners. One of `large`, `rounded`, `slight`, `square`; a newer site may send others, so keep a fallback. **mediaTextGap** `MediaTextGap | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Gap between blocks. One of `tight`, `normal`, `roomy`; a newer site may send others, so keep a fallback. **mediaTextDividers** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. A hairline rule between blocks. **mediaTextBlockEyebrowColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Each block’s eyebrow color. Leave empty to use the secondary (mint) color. **mediaTextBlockEyebrowColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **mediaTextBlockEyebrowWeight** `MediaTextBlockEyebrowWeight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Block eyebrow weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **mediaTextBlockHeadingColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to track the theme text color. **mediaTextBlockHeadingColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **mediaTextBlockHeadingWeight** `MediaTextBlockHeadingWeight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Block heading weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **mediaTextBlockHeadingSize** `MediaTextBlockHeadingSize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Block heading size. One of `small`, `normal`, `large`, `xlarge`, `xxlarge`; a newer site may send others, so keep a fallback. **mediaTextBodyColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to use the muted text color. **mediaTextBodyColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **mediaTextBodyWeight** `MediaTextBodyWeight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Block body weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **mediaTextBodySize** `MediaTextBodySize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Block body size. One of `small`, `normal`, `large`, `xlarge`, `xxlarge`; a newer site may send others, so keep a fallback. **mediaTextBlocks** `readonly MediaTextWidgetMediaTextBlocksItem[]` **Sometimes sent:** `undefined` when the site leaves it out. A list of `MediaTextWidgetMediaTextBlocksItem`. Each block is one media + text row. They render top to bottom in this order; alternate “Media left” / “Media right” for a classic zig-zag. **MediaTextWidgetMediaTextBlocksItem** **id** `string` **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **layout** `Layout | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Media left / right place the media beside the text; Stacked puts media above the text; Full-bleed runs the media edge-to-edge with the text below. One of `media-left`, `media-right`, `stacked`, `full`; a newer site may send others, so keep a fallback. **mediaType** `MediaTextWidgetMediaTextBlocksItemMediaType | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Pick where the media comes from. “None” makes this a text-only block. One of `image`, `video`, `embed`, `none`; a newer site may send others, so keep a fallback. **image** `readonly Readonly\\>[]` **Sometimes sent:** `undefined` when the site leaves it out. Pick an image from the Images library. The related `@apostrophecms/image` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document (one at most); a document the site can’t find is left out. At most 1 items. **imageAlt** `string` **Sometimes sent:** `undefined` when the site leaves it out. Describe the image for screen readers and SEO. Leave empty to use the library image’s own alt text. Set to a single space for a purely decorative image. **video** `readonly Readonly\\>[]` **Sometimes sent:** `undefined` when the site leaves it out. Pick a clip from the Videos library (⌘K → Videos). The related `video` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document (one at most); a document the site can’t find is left out. At most 1 items. **videoAutoplay** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. Play automatically as a muted, looping background clip (a pause button is shown, and reduced-motion visitors get the poster image). Off = a normal video with play controls. **embedUrl** `string` **Sometimes sent:** `undefined` when the site leaves it out. Paste a YouTube or Vimeo link, e.g. [https://youtu.be/…](https://youtu.be/…) or [https://vimeo.com/…](https://vimeo.com/…). **eyebrow** `string` **Sometimes sent:** `undefined` when the site leaves it out. A small label above the block heading. **heading** `string` **Sometimes sent:** `undefined` when the site leaves it out. The block’s headline. **body** `string` **Sometimes sent:** `undefined` when the site leaves it out. A paragraph or two. Leave a blank line between paragraphs. **ctaLabel** `string` **Sometimes sent:** `undefined` when the site leaves it out. This block’s button text. Leave empty (with no link) to hide the button. **ctaUrl** `string` **Sometimes sent:** `undefined` when the site leaves it out. Where the button goes — a path (/about-us) or full URL. **ctaNewTab** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. Open button in new tab. **fields** `Readonly\\>` **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **mediaTextBg** `MediaTextBg | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The section’s full-width background band in dark mode. Transparent lets the page background show through. The palette options track the site colors; choose “Custom color…” for a specific color. One of `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`; a newer site may send others, so keep a fallback. **mediaTextBgCustom** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Used when “Section background (dark theme)” is set to Custom color. **mediaTextBgLight** `MediaTextBgLight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. “Match dark theme” reuses the dark-theme choice; otherwise set the light-mode band independently. One of `inherit`, `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`; a newer site may send others, so keep a fallback. **mediaTextBgLightCustom** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Used when “Section background (light theme)” is set to Custom color. **mediaTextFontOverrides** `readonly MediaTextWidgetMediaTextFontOverridesItem[]` **Sometimes sent:** `undefined` when the site leaves it out. A list of `MediaTextWidgetMediaTextFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. **MediaTextWidgetMediaTextFontOverridesItem** **id** `string` **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **target** `Target | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`; a newer site may send others, so keep a fallback. **source** `Source | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`; a newer site may send others, so keep a fallback. **slot** `Slot | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`; a newer site may send others, so keep a fallback. **curated** `Curated | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`; a newer site may send others, so keep a fallback. **cdnProvider** `CdnProvider | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`; a newer site may send others, so keep a fallback. **cdnFamily** `string` **Sometimes sent:** `undefined` when the site leaves it out. Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. **cdnWeights** `string` **Sometimes sent:** `undefined` when the site leaves it out. Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. **uploads** `readonly MediaTextWidgetMediaTextFontOverridesItemUploadsItem[]` **Sometimes sent:** `undefined` when the site leaves it out. A list of `MediaTextWidgetMediaTextFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. **MediaTextWidgetMediaTextFontOverridesItemUploadsItem** **file** `Readonly\\>` **Always sent.** File attachment reference. **id** `string` **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **weight** `Weight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`; a newer site may send others, so keep a fallback. **style** `Style | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Style. One of `normal`, `italic`; a newer site may send others, so keep a fallback. **fields** `Readonly\\>` **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **fallback** `Fallback | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`; a newer site may send others, so keep a fallback. **fields** `Readonly\\>` **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **mediaTextCtaVariant** `MediaTextCtaVariant | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`; a newer site may send others, so keep a fallback. **mediaTextCtaSize** `MediaTextCtaSize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Button size. One of `small`, `normal`, `large`; a newer site may send others, so keep a fallback. **mediaTextCtaRadius** `MediaTextCtaRadius | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Corner radius. One of `pill`, `rounded`, `slight`, `square`; a newer site may send others, so keep a fallback. **mediaTextCtaColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. **mediaTextCtaColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) **mediaTextCtaTextColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The text/icon color. Clear it to derive from the button color (readable on solid fills). **mediaTextCtaTextColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme label color. **mediaTextCtaHoverColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Drives the hover treatment. Leave empty to derive it from the button color. **mediaTextCtaHoverColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme hover color. **mediaTextCtaStyle** `MediaTextCtaStyle | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`; a newer site may send others, so keep a fallback. **mediaTextCtaShadowColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. **mediaTextCtaShadowColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme shadow color. **mediaTextCtaAnimation** `MediaTextCtaAnimation | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Hover motion. One of `lift`, `scale`, `lift-scale`, `none`; a newer site may send others, so keep a fallback. **mediaTextCtaIcon** `string` **Sometimes sent:** `undefined` when the site leaves it out. Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. **mediaTextCtaIconFamily** `MediaTextCtaIconFamily | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`; a newer site may send others, so keep a fallback. **mediaTextCtaIconPosition** `MediaTextCtaIconPosition | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`; a newer site may send others, so keep a fallback. **mediaTextCtaIconNudge** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. The icon slides toward its side on hover (e.g. an arrow edges outward). **sectionCss** `CustomCSS | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. **fields** `Readonly\\>` **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **DeviceMockWidget** A `device-mock` widget: its `type` and its own fields. A field left out takes its default. **type** `DeviceMockWidgetType` **Always sent.** The widget’s type: always `device-mock`. One of `device-mock`; a newer site may send others, so keep a fallback. **id** `string` **Sometimes sent:** `undefined` when the site leaves it out. The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. **metaType** `MetaType` **Sometimes sent:** `undefined` when the site leaves it out. Always `widget`. One of `widget`; a newer site may send others, so keep a fallback. **deviceMockArrangement** `DeviceMockArrangement | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which devices to show. Duo overlaps a phone on the corner of a desktop browser; Trio adds a TV behind them (on narrow screens Trio drops the TV and shows as a Duo). Each device used gets its own screen tab. One of `duo`, `trio`, `desktop`, `phone`, `tv`; a newer site may send others, so keep a fallback. **deviceMockTextPlacement** `DeviceMockTextPlacement | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where the eyebrow / heading / intro / button sit. Left or right puts the text in a column beside the devices (stacked above them on narrow screens); None shows the devices only. One of `above`, `left`, `right`, `none`; a newer site may send others, so keep a fallback. **deviceMockSize** `DeviceMockSize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How large the devices render within the section. One of `compact`, `normal`, `large`; a newer site may send others, so keep a fallback. **deviceMockBrowserRatio** `DeviceMockBrowserRatio | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The browser window’s content area. Match your desktop captures. One of `16:10`, `16:9`; a newer site may send others, so keep a fallback. **deviceMockBrowserUrl** `string` **Sometimes sent:** `undefined` when the site leaves it out. The address shown in the browser toolbar — decoration only, not a link. **deviceMockPhoneStatusBar** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. Adds a time / signal / battery bar across the top of the phone screen. Leave off for native phone screenshots — they already include the real status bar. **deviceMockPhoneTime** `string` **Sometimes sent:** `undefined` when the site leaves it out. Status bar time. **deviceMockMotionPause** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. Adds a small, unobtrusive pause/play control so visitors can stop the auto-playing background motion (WCAG 2.2.2). Only appears when a moving background is set. **deviceMockEyebrowEnabled** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. A small label above the heading (e.g. "Product tour"). **deviceMockEyebrow** `string` **Sometimes sent:** `undefined` when the site leaves it out. Small label shown above the title. **deviceMockEyebrowColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Overrides the eyebrow + its dash. Leave empty to use the secondary (mint) color. **deviceMockEyebrowColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color, then the mint default. **deviceMockEyebrowWeight** `DeviceMockEyebrowWeight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Eyebrow weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **deviceMockEyebrowSize** `DeviceMockEyebrowSize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Eyebrow size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **deviceMockHeading** `string` **Sometimes sent:** `undefined` when the site leaves it out. Optional. Leave empty to show just the devices. **deviceMockHeadingColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to track the theme text color. **deviceMockHeadingColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **deviceMockHeadingWeight** `DeviceMockHeadingWeight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Heading weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **deviceMockHeadingSize** `DeviceMockHeadingSize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Heading size. One of `small`, `normal`, `large`, `xlarge`, `xxlarge`; a newer site may send others, so keep a fallback. **deviceMockIntro** `string` **Sometimes sent:** `undefined` when the site leaves it out. Optional short paragraph under the heading. **deviceMockIntroColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to use the muted text color. **deviceMockIntroColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **deviceMockIntroWeight** `DeviceMockIntroWeight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Intro weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **deviceMockIntroSize** `DeviceMockIntroSize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Intro size. One of `small`, `normal`, `large`, `xlarge`, `xxlarge`; a newer site may send others, so keep a fallback. **deviceMockCaption** `string` **Sometimes sent:** `undefined` when the site leaves it out. A short line shown under the devices. **deviceMockTvMediaType** `DeviceMockTvMediaType | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A still screenshot, or a short looping screen recording. One of `image`, `video`; a newer site may send others, so keep a fallback. **deviceMockTvImage** `readonly Readonly\\>[]` **Sometimes sent:** `undefined` when the site leaves it out. Use a native-resolution 16:9 capture of the screen with NO device frame (the frame is drawn for you) — e.g. 1920 × 1080 or 3840 × 2160. The related `@apostrophecms/image` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document (one at most); a document the site can’t find is left out. At most 1 items. **deviceMockTvImageAlt** `string` **Sometimes sent:** `undefined` when the site leaves it out. Required once a screenshot is picked. Describe what the screen shows for visitors who can’t see it — e.g. “Dashboard with a weekly activity chart and a list of recent orders”. Skip the device itself (“a phone showing…”); the frame is decorative. **deviceMockTvVideo** `readonly Readonly\\>[]` **Sometimes sent:** `undefined` when the site leaves it out. Pick a clip from the Videos library (⌘K → Videos). It plays as a short, muted, looping screen recording — keep it SHORT (about 5–15 seconds) and SMALL (under about 10 MB; an H.264 MP4 without an audio track is ideal), and give the Videos item a poster image: visitors see the poster first, and reduced-motion visitors only ever see the poster. Use a native-resolution 16:9 capture of the screen with NO device frame (the frame is drawn for you) — e.g. 1920 × 1080 or 3840 × 2160. The related `video` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document (one at most); a document the site can’t find is left out. At most 1 items. **deviceMockTvVideoAlt** `string` **Sometimes sent:** `undefined` when the site leaves it out. Recommended. A short description of what the recording shows, read to screen-reader users — e.g. “Creating a new project in three clicks”. Leave empty only if the surrounding text already says it. **deviceMockTvFit** `DeviceMockTvFit | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Fill crops the media to fill the whole screen (best for native captures). Fit shows the whole image or video, leaving bars if its shape differs from the screen. One of `cover`, `contain`; a newer site may send others, so keep a fallback. **deviceMockTvAnchor** `DeviceMockTvAnchor | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which part stays visible when the media is cropped. Top keeps an app’s header in view — right for most screenshots. One of `top`, `center`, `bottom`; a newer site may send others, so keep a fallback. **deviceMockDesktopMediaType** `DeviceMockDesktopMediaType | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A still screenshot, or a short looping screen recording. One of `image`, `video`; a newer site may send others, so keep a fallback. **deviceMockDesktopImage** `readonly Readonly\\>[]` **Sometimes sent:** `undefined` when the site leaves it out. Use a native-resolution capture of the page content only — no browser toolbar and no device frame (both are drawn for you). 16:10 (e.g. 2880 × 1800) or 16:9 (e.g. 2560 × 1440), matching the “Desktop screen shape” setting. The related `@apostrophecms/image` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document (one at most); a document the site can’t find is left out. At most 1 items. **deviceMockDesktopImageAlt** `string` **Sometimes sent:** `undefined` when the site leaves it out. Required once a screenshot is picked. Describe what the screen shows for visitors who can’t see it — e.g. “Dashboard with a weekly activity chart and a list of recent orders”. Skip the device itself (“a phone showing…”); the frame is decorative. **deviceMockDesktopVideo** `readonly Readonly\\>[]` **Sometimes sent:** `undefined` when the site leaves it out. Pick a clip from the Videos library (⌘K → Videos). It plays as a short, muted, looping screen recording — keep it SHORT (about 5–15 seconds) and SMALL (under about 10 MB; an H.264 MP4 without an audio track is ideal), and give the Videos item a poster image: visitors see the poster first, and reduced-motion visitors only ever see the poster. Use a native-resolution capture of the page content only — no browser toolbar and no device frame (both are drawn for you). 16:10 (e.g. 2880 × 1800) or 16:9 (e.g. 2560 × 1440), matching the “Desktop screen shape” setting. The related `video` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document (one at most); a document the site can’t find is left out. At most 1 items. **deviceMockDesktopVideoAlt** `string` **Sometimes sent:** `undefined` when the site leaves it out. Recommended. A short description of what the recording shows, read to screen-reader users — e.g. “Creating a new project in three clicks”. Leave empty only if the surrounding text already says it. **deviceMockDesktopFit** `DeviceMockDesktopFit | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Fill crops the media to fill the whole screen (best for native captures). Fit shows the whole image or video, leaving bars if its shape differs from the screen. One of `cover`, `contain`; a newer site may send others, so keep a fallback. **deviceMockDesktopAnchor** `DeviceMockDesktopAnchor | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which part stays visible when the media is cropped. Top keeps an app’s header in view — right for most screenshots. One of `top`, `center`, `bottom`; a newer site may send others, so keep a fallback. **deviceMockPhoneMediaType** `DeviceMockPhoneMediaType | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A still screenshot, or a short looping screen recording. One of `image`, `video`; a newer site may send others, so keep a fallback. **deviceMockPhoneImage** `readonly Readonly\\>[]` **Sometimes sent:** `undefined` when the site leaves it out. Use a native-resolution portrait screenshot with NO device frame (the frame is drawn for you) — e.g. 1179 × 2556 or 1290 × 2796 (about 9:19.5). The related `@apostrophecms/image` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document (one at most); a document the site can’t find is left out. At most 1 items. **deviceMockPhoneImageAlt** `string` **Sometimes sent:** `undefined` when the site leaves it out. Required once a screenshot is picked. Describe what the screen shows for visitors who can’t see it — e.g. “Dashboard with a weekly activity chart and a list of recent orders”. Skip the device itself (“a phone showing…”); the frame is decorative. **deviceMockPhoneVideo** `readonly Readonly\\>[]` **Sometimes sent:** `undefined` when the site leaves it out. Pick a clip from the Videos library (⌘K → Videos). It plays as a short, muted, looping screen recording — keep it SHORT (about 5–15 seconds) and SMALL (under about 10 MB; an H.264 MP4 without an audio track is ideal), and give the Videos item a poster image: visitors see the poster first, and reduced-motion visitors only ever see the poster. Use a native-resolution portrait screenshot with NO device frame (the frame is drawn for you) — e.g. 1179 × 2556 or 1290 × 2796 (about 9:19.5). The related `video` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document (one at most); a document the site can’t find is left out. At most 1 items. **deviceMockPhoneVideoAlt** `string` **Sometimes sent:** `undefined` when the site leaves it out. Recommended. A short description of what the recording shows, read to screen-reader users — e.g. “Creating a new project in three clicks”. Leave empty only if the surrounding text already says it. **deviceMockPhoneFit** `DeviceMockPhoneFit | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Fill crops the media to fill the whole screen (best for native captures). Fit shows the whole image or video, leaving bars if its shape differs from the screen. One of `cover`, `contain`; a newer site may send others, so keep a fallback. **deviceMockPhoneAnchor** `DeviceMockPhoneAnchor | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which part stays visible when the media is cropped. Top keeps an app’s header in view — right for most screenshots. One of `top`, `center`, `bottom`; a newer site may send others, so keep a fallback. **deviceMockBg** `DeviceMockBg | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The section’s full-width background band in dark mode. Transparent lets the page background show through. The palette options track the site colors; choose “Custom color…” for a specific color. One of `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`; a newer site may send others, so keep a fallback. **deviceMockBgCustom** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Used when “Section background (dark theme)” is set to Custom color. **deviceMockBgLight** `DeviceMockBgLight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. “Match dark theme” reuses the dark-theme choice; otherwise set the light-mode band independently. One of `inherit`, `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`; a newer site may send others, so keep a fallback. **deviceMockBgLightCustom** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Used when “Section background (light theme)” is set to Custom color. **deviceMockFontOverrides** `readonly DeviceMockWidgetDeviceMockFontOverridesItem[]` **Sometimes sent:** `undefined` when the site leaves it out. A list of `DeviceMockWidgetDeviceMockFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. **DeviceMockWidgetDeviceMockFontOverridesItem** **id** `string` **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **target** `Target | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`; a newer site may send others, so keep a fallback. **source** `Source | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`; a newer site may send others, so keep a fallback. **slot** `Slot | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`; a newer site may send others, so keep a fallback. **curated** `Curated | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`; a newer site may send others, so keep a fallback. **cdnProvider** `CdnProvider | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`; a newer site may send others, so keep a fallback. **cdnFamily** `string` **Sometimes sent:** `undefined` when the site leaves it out. Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. **cdnWeights** `string` **Sometimes sent:** `undefined` when the site leaves it out. Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. **uploads** `readonly DeviceMockWidgetDeviceMockFontOverridesItemUploadsItem[]` **Sometimes sent:** `undefined` when the site leaves it out. A list of `DeviceMockWidgetDeviceMockFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. **DeviceMockWidgetDeviceMockFontOverridesItemUploadsItem** **file** `Readonly\\>` **Always sent.** File attachment reference. **id** `string` **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **weight** `Weight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`; a newer site may send others, so keep a fallback. **style** `Style | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Style. One of `normal`, `italic`; a newer site may send others, so keep a fallback. **fields** `Readonly\\>` **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **fallback** `Fallback | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`; a newer site may send others, so keep a fallback. **fields** `Readonly\\>` **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **deviceMockCtaLabel** `string` **Sometimes sent:** `undefined` when the site leaves it out. The visible button text. Leave empty to hide the button. **deviceMockCtaUrl** `string` **Sometimes sent:** `undefined` when the site leaves it out. Where the button goes — a path (/blog) or full URL. **deviceMockCtaNewTab** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. Opens the link in a new browser tab (adds rel="noopener noreferrer"). **deviceMockCtaVariant** `DeviceMockCtaVariant | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`; a newer site may send others, so keep a fallback. **deviceMockCtaSize** `DeviceMockCtaSize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Button size. One of `small`, `normal`, `large`; a newer site may send others, so keep a fallback. **deviceMockCtaRadius** `DeviceMockCtaRadius | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Corner radius. One of `pill`, `rounded`, `slight`, `square`; a newer site may send others, so keep a fallback. **deviceMockCtaColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. **deviceMockCtaColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) **deviceMockCtaTextColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The text/icon color. Clear it to derive from the button color (readable on solid fills). **deviceMockCtaTextColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme label color. **deviceMockCtaHoverColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Drives the hover treatment. Leave empty to derive it from the button color. **deviceMockCtaHoverColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme hover color. **deviceMockCtaStyle** `DeviceMockCtaStyle | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`; a newer site may send others, so keep a fallback. **deviceMockCtaShadowColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. **deviceMockCtaShadowColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme shadow color. **deviceMockCtaAnimation** `DeviceMockCtaAnimation | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Hover motion. One of `lift`, `scale`, `lift-scale`, `none`; a newer site may send others, so keep a fallback. **deviceMockCtaIcon** `string` **Sometimes sent:** `undefined` when the site leaves it out. Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. **deviceMockCtaIconFamily** `DeviceMockCtaIconFamily | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`; a newer site may send others, so keep a fallback. **deviceMockCtaIconPosition** `DeviceMockCtaIconPosition | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`; a newer site may send others, so keep a fallback. **deviceMockCtaIconNudge** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. The icon slides toward its side on hover (e.g. an arrow edges outward). **sectionCss** `CustomCSS | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. **fields** `Readonly\\>` **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **TeamWidget** A `team` widget: its `type` and its own fields. A field left out takes its default. **type** `TeamWidgetType` **Always sent.** The widget’s type: always `team`. One of `team`; a newer site may send others, so keep a fallback. **id** `string` **Sometimes sent:** `undefined` when the site leaves it out. The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. **metaType** `MetaType` **Sometimes sent:** `undefined` when the site leaves it out. Always `widget`. One of `widget`; a newer site may send others, so keep a fallback. **teamEyebrow** `string` **Sometimes sent:** `undefined` when the site leaves it out. Small label shown above the title. **teamEyebrowColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Overrides the eyebrow + its dash. Leave empty to use the secondary (mint) color. **teamEyebrowColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color, then the mint default. **teamEyebrowWeight** `TeamEyebrowWeight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Eyebrow weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **teamEyebrowSize** `TeamEyebrowSize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Eyebrow size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **teamHeading** `string` **Sometimes sent:** `undefined` when the site leaves it out. Optional. Leave empty to show just the team. **teamHeadingColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to track the theme text color. **teamHeadingColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **teamHeadingWeight** `TeamHeadingWeight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Heading weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **teamIntro** `string` **Sometimes sent:** `undefined` when the site leaves it out. Optional short sentence under the heading. **teamIntroColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to use the muted text color. **teamIntroColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **teamIntroWeight** `TeamIntroWeight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Intro weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **teamIntroSize** `TeamIntroSize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Intro size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **teamAlign** `TeamAlign | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Header alignment. One of `center`, `left`; a newer site may send others, so keep a fallback. **teamFeaturedOnly** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. Show only members you have flagged “Featured” in the Team Members manager — e.g. a short leadership row on the home page. **teamCount** `number | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The most members to show, in the manager’s sort order. 1 to 50. **teamLayout** `TeamLayout | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Grid: a tidy multi-row grid (the full team page). Carousel: a continuous auto-scrolling marquee (needs site animations enabled — falls back to the grid when they are off). Spotlight: featured members large on top, the rest in a smaller grid. List: wide rows with the full bio. Scatter: a playful arrangement with varied spacing so the cards float freely. One of `grid`, `carousel`, `spotlight`, `list`, `scatter`; a newer site may send others, so keep a fallback. **teamColumns** `TeamColumns | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How many cards per row. Auto fits as many as comfortably fit (the Scatter layout composes on three columns when set to Auto). One of `auto`, `2`, `3`, `4`; a newer site may send others, so keep a fallback. **teamSpotlightHeroes** `TeamSpotlightHeroes | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How many members lead the section at full size. Members flagged “Featured” fill the spots first, in the manager’s sort order; any extra featured members join the rows below. One of `1`, `2`; a newer site may send others, so keep a fallback. **teamSpotlightColumns** `TeamSpotlightColumns | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How many of the remaining members sit on each row under the featured spots. One of `2`, `3`, `4`, `5`; a newer site may send others, so keep a fallback. **teamSpeed** `TeamSpeed | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How fast the carousel auto-scrolls. One of `vslow`, `slow`, `normal`, `fast`; a newer site may send others, so keep a fallback. **teamDirection** `TeamDirection | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Scroll direction. One of `left`, `right`; a newer site may send others, so keep a fallback. **teamScatter** `TeamScatter | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How far the cards drift from a tidy grid. Subtle keeps a loose grid; Wild pushes the offsets to their playful maximum. One of `subtle`, `playful`, `wild`; a newer site may send others, so keep a fallback. **teamGap** `TeamGap | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Gap between cards. One of `tight`, `normal`, `roomy`; a newer site may send others, so keep a fallback. **teamCardLayout** `TeamCardLayout | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Portrait: the photo on top, name/role/bio below — the classic team card. Overlay: a full-bleed photo with a solid color panel over its lower edge holding the name and role. Profile: a horizontal bar — avatar left, name/role/tagline right. Roster: minimal — just the avatar, name and role. (The List section layout always uses its own wide row.) One of `portrait`, `overlay`, `profile`, `roster`; a newer site may send others, so keep a fallback. **teamPhotoAspect** `TeamPhotoAspect | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The photo’s aspect ratio on the photo-led card layouts. One of `square`, `portrait`, `tall`; a newer site may send others, so keep a fallback. **teamAvatarShape** `TeamAvatarShape | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The photo’s outline. Squircle is a soft superellipse-style corner (approximated with heavy rounding). One of `circle`, `rounded`, `squircle`, `square`; a newer site may send others, so keep a fallback. **teamAvatarSize** `TeamAvatarSize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Avatar size. One of `small`, `medium`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **teamAvatarBorder** `TeamAvatarBorder | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A ring around the photo in the avatar color. One of `none`, `hairline`, `thin`, `bold`; a newer site may send others, so keep a fallback. **teamAvatarTreatment** `TeamAvatarTreatment | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A flat color accent behind the photo. Panel offsets a solid block behind it; Halo draws a soft concentric disc. Both use the avatar color. One of `none`, `panel`, `halo`; a newer site may send others, so keep a fallback. **teamAvatarColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Colors the border and the backdrop treatment. Leave empty to use the brand accent. **teamAvatarColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **teamShowRole** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. Show role / title. **teamShowBio** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. Shown on the Portrait and Profile cards and the List rows. The Overlay and Roster layouts stay bio-free by design. **teamShowTagline** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. The member’s one-liner, shown on the Profile and Roster cards and the List rows. **teamHoverPhoto** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. Cross-fades to a member’s alternate photo on hover (set per member; does nothing for members without one, and stays off for visitors who prefer reduced motion). **teamCardStyle** `TeamCardStyle | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The card treatment. Outline (the default) is a plaque frame — a framed-portrait look; Raised is a quiet lit card; Luxe a frosted glass panel; Ticket/Bracket/Inlay are the graphic showstoppers. One of `raised`, `luxe`, `outline`, `plain`, `poster`, `edge`, `tint`, `ticket`, `bracket`, `inlay`; a newer site may send others, so keep a fallback. **teamCardStyleRadius** `TeamCardStyleRadius | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Corner rounding for each card. Default keeps the widget’s own tuned corners — except Forge, which defaults to tight machined corners matching its engraved frame. One of `default`, `square`, `slight`, `rounded`, `large`; a newer site may send others, so keep a fallback. **teamCardStyleAccentColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Colors the Spine rail, Bracket marks, Forge corner/frame and Press margin rule. Leave empty to use the brand accent. **teamCardStyleAccentColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **teamCardHover** `TeamCardHover | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. What a card does on hover. Lift/Pop/Press/Glow/Outline are instant; Sheen sweeps a light across; Tilt, Magnetic and Spotlight follow the cursor (need site animations on). Vary it per section so the page is not cookie-cutter. One of `none`, `lift`, `pop`, `press`, `glow`, `border`, `sheen`, `tilt`, `magnetic`, `spotlight`; a newer site may send others, so keep a fallback. **teamCardAlign** `TeamCardAlign | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How the name, role and bio align inside each card (the Profile card and List rows are always left-aligned beside the avatar). One of `center`, `left`; a newer site may send others, so keep a fallback. **teamAccentColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — the lettered-avatar fallback background and the role color default. Leave empty to use the brand accent. (The icon row has its own colors on the Social links tab.) **teamAccentColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **teamPanelColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The solid panel over the photo on the Overlay card. Leave empty to use the card color. **teamPanelColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **teamNameSize** `TeamNameSize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Name size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **teamNameWeight** `TeamNameWeight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Name weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **teamNameColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to track the theme text color. **teamNameColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **teamRoleSize** `TeamRoleSize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Role size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **teamRoleWeight** `TeamRoleWeight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Role weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **teamRoleColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to use the accent color. **teamRoleColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **teamBioSize** `TeamBioSize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Bio size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **teamBioWeight** `TeamBioWeight | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Bio weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **teamBioColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to use the muted text color. **teamBioColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **teamBioClamp** `TeamBioClamp | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Cap each bio at this many lines (the rest is truncated with an ellipsis) so one long bio can’t blow up the card height. The List layout always shows the full bio. One of `none`, `2`, `3`, `4`, `6`; a newer site may send others, so keep a fallback. **teamTaglineColor** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to use the faint text color. **teamTaglineColorLight** `string | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **teamShowSocials** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. The member’s social profile icons (set per member in the Team Members manager). **teamShowContact** `boolean` **Sometimes sent:** `undefined` when the site leaves it out. Off by default — turns each member’s email and phone (when set) into icon links. Only enable when you want those details public. **teamSocialVariant** `TeamSocialVariant | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Icon style. One of `bare`, `outline`, `solid`; a newer site may send others, so keep a fallback. **teamSocialSize** `TeamSocialSize | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Icon size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **teamSocialSpacing** `TeamSocialSpacing | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Gap between the icons. One of `tight`, `normal`, `loose`; a newer site may send others, so keep a fallback. **teamSocialHover** `TeamSocialHover | null` **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Hover to each platform’s own brand color, or to the site accent (or a chosen hover color). One of `brand`, `accent`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Resting icon color. Leave empty for the muted default. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color, then the muted default. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Used when “Hover color” is Accent / custom. Leave empty for the site accent. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color, then the accent. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The section’s full-width background band in dark mode. Transparent lets the page background show through. The palette options track the site colors; choose “Custom color…” for a specific color. One of `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Used when “Section background (dark theme)” is set to Custom color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. “Match dark theme” reuses the dark-theme choice; otherwise set the light-mode band independently. One of `inherit`, `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Used when “Section background (light theme)” is set to Custom color. **Sometimes sent:** `undefined` when the site leaves it out. A list of `TeamWidgetTeamFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. **TeamWidgetTeamFontOverridesItem** **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. **Sometimes sent:** `undefined` when the site leaves it out. Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. **Sometimes sent:** `undefined` when the site leaves it out. A list of `TeamWidgetTeamFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. **TeamWidgetTeamFontOverridesItemUploadsItem** **Always sent.** File attachment reference. **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Style. One of `normal`, `italic`; a newer site may send others, so keep a fallback. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`; a newer site may send others, so keep a fallback. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **Sometimes sent:** `undefined` when the site leaves it out. The visible button text. Leave empty to hide the button. **Sometimes sent:** `undefined` when the site leaves it out. Where the button goes — a path (/blog) or full URL. **Sometimes sent:** `undefined` when the site leaves it out. Opens the link in a new browser tab (adds rel="noopener noreferrer"). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Button size. One of `small`, `normal`, `large`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Corner radius. One of `pill`, `rounded`, `slight`, `square`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The text/icon color. Clear it to derive from the button color (readable on solid fills). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme label color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Drives the hover treatment. Leave empty to derive it from the button color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme hover color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme shadow color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Hover motion. One of `lift`, `scale`, `lift-scale`, `none`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. The icon slides toward its side on hover (e.g. an arrow edges outward). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **FaqWidget** A `faq` widget: its `type` and its own fields. A field left out takes its default. **Always sent.** The widget’s type: always `faq`. One of `faq`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. **Sometimes sent:** `undefined` when the site leaves it out. Always `widget`. One of `widget`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Small label shown above the title. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Overrides the eyebrow + its dash. Leave empty to use the secondary (mint) color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color, then the mint default. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Eyebrow weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Eyebrow size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Optional. Leave empty to show just the questions. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to track the theme text color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Heading weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Optional short sentence under the heading. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to use the muted text color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Intro weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Intro size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The Split layout always sets its header column left. One of `center`, `left`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Show only questions you have flagged “Featured” in the FAQs manager — e.g. a short top-questions block on the home page, linking out to the full FAQ page. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The most questions to show, in the manager’s sort order. Raise it for a full FAQ page. 1 to 50. **Sometimes sent:** `undefined` when the site leaves it out. Optional filter. Leave empty to show questions from every category. Manage the list under FAQ Categories. The related `faq-category` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document; a document the site can’t find is left out. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. By category renders a subheading per FAQ category, in the order picked in the category filter (or, with no filter, the FAQ Categories sort order); questions without a category are listed last. One of `none`, `category`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Accordion: a single centered column of collapsing questions — the classic FAQ. Split: the header (and button) sit in a left column with the accordion beside them. Two columns: the accordion flows across two columns. Open panels: every answer visible in a card grid — no collapsing. One of `accordion`, `split`, `columns`, `panels`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How many open panels sit per row (they stack on small screens). One of `1`, `2`, `3`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. One at a time closes the previous answer when a new one opens; Independent lets visitors hold several open. One of `single`, `multiple`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Starts the section with the first answer expanded so the block never reads as an empty list of rows. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The disclosure marker on each question. Plus rotates into a close mark; Chevron flips. One of `plus`, `chevron`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Space between questions. One of `tight`, `normal`, `roomy`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Adds this section’s questions to the page’s schema.org FAQPage markup so search engines can read them (all FAQ sections on a page share one FAQPage block). Costs nothing when on; turn off only to exclude these questions. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The question-row treatment. Plain (the default) is the classic divided list — hairlines between questions. Any other style turns each question into a card: Raised is a quiet lit card, Outline a framed row, Luxe frosted glass; Ticket/Bracket/Inlay are the graphic showstoppers. One of `raised`, `luxe`, `outline`, `plain`, `poster`, `edge`, `tint`, `ticket`, `bracket`, `forge`, `press`, `inlay`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Corner rounding for each card. Default keeps the widget’s own tuned corners — except Forge, which defaults to tight machined corners matching its engraved frame. One of `default`, `square`, `slight`, `rounded`, `large`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Colors the Spine rail, Bracket marks, Forge corner/frame and Press margin rule. Leave empty to use the brand accent. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where the Forge plate wears its color: a single corner mark (the machinist’s datum, default) or the whole engraved frame. One of `corner`, `frame`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Thickness of the Forge corner mark / colored frame. One of `fine`, `medium`, `bold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. What a question row does on hover. None (the default) keeps the accordion calm — the open/close motion is the interaction. The card effects (Lift/Glow/…) suit the card styles; the cursor-tracked ones need site animations on. One of `none`, `lift`, `pop`, `press`, `glow`, `border`, `sheen`, `tilt`, `magnetic`, `spotlight`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — colors the toggle icon and the open question’s highlight. Leave empty to use the brand accent. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Question size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Question weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to track the theme text color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Answer size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Answer weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to use the muted text color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Category heading weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to track the theme text color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The section’s full-width background band in dark mode. Transparent lets the page background show through. The palette options track the site colors; choose “Custom color…” for a specific color. One of `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Used when “Section background (dark theme)” is set to Custom color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. “Match dark theme” reuses the dark-theme choice; otherwise set the light-mode band independently. One of `inherit`, `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Used when “Section background (light theme)” is set to Custom color. **Sometimes sent:** `undefined` when the site leaves it out. A list of `FaqWidgetFaqFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. **FaqWidgetFaqFontOverridesItem** **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. **Sometimes sent:** `undefined` when the site leaves it out. Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. **Sometimes sent:** `undefined` when the site leaves it out. A list of `FaqWidgetFaqFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. **FaqWidgetFaqFontOverridesItemUploadsItem** **Always sent.** File attachment reference. **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Style. One of `normal`, `italic`; a newer site may send others, so keep a fallback. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`; a newer site may send others, so keep a fallback. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **Sometimes sent:** `undefined` when the site leaves it out. The visible button text. Leave empty to hide the button. **Sometimes sent:** `undefined` when the site leaves it out. Where the button goes — a path (/blog) or full URL. **Sometimes sent:** `undefined` when the site leaves it out. Opens the link in a new browser tab (adds rel="noopener noreferrer"). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Button size. One of `small`, `normal`, `large`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Corner radius. One of `pill`, `rounded`, `slight`, `square`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The text/icon color. Clear it to derive from the button color (readable on solid fills). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme label color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Drives the hover treatment. Leave empty to derive it from the button color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme hover color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme shadow color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Hover motion. One of `lift`, `scale`, `lift-scale`, `none`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. The icon slides toward its side on hover (e.g. an arrow edges outward). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **ServiceMapWidget** A `service-map` widget: its `type` and its own fields. A field left out takes its default. **Always sent.** The widget’s type: always `service-map`. One of `service-map`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. **Sometimes sent:** `undefined` when the site leaves it out. Always `widget`. One of `widget`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Small label shown above the title. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Overrides the eyebrow + its dash. Leave empty to use the secondary (mint) color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color, then the mint default. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Eyebrow weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Eyebrow size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Heading. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Leave empty for the standard ink color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Heading weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Optional short paragraph under the heading. The data source’s own description (service days etc.) shows in the result panel, not here. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Intro size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Map height. One of `compact`, `standard`, `tall`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Curated light/dark basemap pairs — each follows the visitor’s theme toggle. “Site palette” derives the basemap from this site’s own colors. One of `palette`, `classic`, `silver`, `retro`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Map corner radius. One of `square`, `slight`, `rounded`, `large`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Leave empty for the standard hairline — set it to match a colored border on the zone cards. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional soft glow around the map frame — pairs with a glowing zone-card style. Leave empty for none. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out. On pages with this section, upgrades the business structured data from the compact site-wide form to the full detail: every public place name, every zip code, and area boundaries. Costs visitors nothing; turn off to keep this page at the compact site-wide form. (Requires structured data on in Site settings → SEO; demo map data is never published.) **Sometimes sent:** `undefined` when the site leaves it out. The legend card overlaid on the map. The zone cards below the map always carry the same information for screen readers and when the map can’t load. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Key swatch size. One of `small`, `medium`, `large`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Key text justification. One of `left`, `center`, `right`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Key text size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Key text weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Leave empty for the standard ink color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Key corner radius. One of `square`, `slight`, `rounded`, `large`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Leave empty for the standard hairline — set it to match the map frame or the zone cards. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional soft glow around the key card. Leave empty for none. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out. The zone/pricing cards under the map. Turning this off hides them visually — they stay in the page for screen readers and no-JavaScript visitors (the map itself isn’t accessible). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The card surface. Raised is a quiet lit card; Luxe is a frosted glass panel; Outline is a double-rule plaque frame; Plain has no chrome; Poster frames the card with an accent keyline; Spine embeds a color rail along the top; Tint washes the card in the accent color. Showstoppers: Ticket punches notches into the sides, Bracket draws only corner marks, Forge is a machined plate with an engraved frame, Press is a punched index card with a margin rule, Inlay recesses the content into a well. One of `raised`, `luxe`, `outline`, `plain`, `poster`, `edge`, `tint`, `inlay`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Corner rounding for each card. Default keeps the widget’s own tuned corners — except Forge, which defaults to tight machined corners matching its engraved frame. One of `default`, `square`, `slight`, `rounded`, `large`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Colors the Spine rail, Bracket marks, Forge corner/frame and Press margin rule. Leave empty to use the brand accent. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. What a card does on hover. Lift/Pop/Press/Glow/Outline are instant CSS effects; Sheen sweeps a soft light across; Tilt, Magnetic and Spotlight follow the cursor (these need site animations on — visitors who prefer reduced motion see the resting card). Pick a different one per section so a page feels varied, not cookie-cutter. One of `none`, `lift`, `pop`, `press`, `glow`, `border`, `sheen`, `tilt`, `magnetic`, `spotlight`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Card swatch size. One of `small`, `medium`, `large`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Card text justification. One of `left`, `center`, `right`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Zone name weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Card text size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Colors the zone names; supporting copy stays muted. Leave empty for the standard ink color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The price and detail lines under each zone name — sized relative to the card text size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Supporting text weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Leave empty for the standard muted color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out. Optional label shown instead of “$0” wherever a zone has no fee (key, cards, results). Clear it to show the plain price — $0 doesn’t always mean included. **Sometimes sent:** `undefined` when the site leaves it out. A list of `ServiceMapWidgetServiceMapZoneOverridesItem`. Per-zone display overrides, matched by the zone name the data source provides. Rename a zone, replace its price text, or hide it entirely — the underlying data is never changed. **ServiceMapWidgetServiceMapZoneOverridesItem** **Always sent.** Case-insensitive match against the zone name in the map data. **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **Sometimes sent:** `undefined` when the site leaves it out. Optional replacement name shown everywhere this zone appears. **Sometimes sent:** `undefined` when the site leaves it out. Optional replacement for the price text (e.g. “Included”, “Call us”). Overrides the zero-price label too. **Sometimes sent:** `undefined` when the site leaves it out. The zone stays on the map and in search results — it just leaves the key and cards. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **Sometimes sent:** `undefined` when the site leaves it out. Show the “check your area” search. **Sometimes sent:** `undefined` when the site leaves it out. Search label. **Sometimes sent:** `undefined` when the site leaves it out. Search placeholder. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Positions the search box and button above the map. One of `left`, `center`, `right`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Same radius scale as the buttons, so the box and button can match. One of `pill`, `rounded`, `slight`, `square`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Google address autocomplete under the search box (needs the Places API enabled on the key — see the setup guide in Connections → Google Maps). ZIP-only typing never triggers suggestions when the data source is zip-based. **Sometimes sent:** `undefined` when the site leaves it out. Shown when a searched location doesn’t fall in any zone (or the premium radius). **Sometimes sent:** `undefined` when the site leaves it out. Leave empty for “Check”. The button’s look is configured in the Search button tab. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Button size. One of `small`, `normal`, `large`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Corner radius. One of `pill`, `rounded`, `slight`, `square`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The text/icon color. Clear it to derive from the button color (readable on solid fills). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme label color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Drives the hover treatment. Leave empty to derive it from the button color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme hover color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme shadow color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Hover motion. One of `lift`, `scale`, `lift-scale`, `none`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Popup placement. One of `center`, `corner`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Popup style. One of `overlay`, `solid`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Repeats the searched ZIP code or address at the top of the result popup. **Sometimes sent:** `undefined` when the site leaves it out. Looks up the locality for a searched ZIP code (one extra Geocoding API call per search) and shows it beside the searched value. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Popup text size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Popup title weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. When the data carries a premium (distance-priced) service, include it in search results and the zone cards. Sources without their own premium block use the pricing set in Service area map → Areas and pricing. **Sometimes sent:** `undefined` when the site leaves it out. Needs a premium range limit (miles) — with no limit there is no ring to draw. **Sometimes sent:** `undefined` when the site leaves it out. Premium estimate note. **Sometimes sent:** `undefined` when the site leaves it out. Shown when a distance estimate isn’t possible (e.g. the Distance Matrix API isn’t enabled on the key). **Sometimes sent:** `undefined` when the site leaves it out. Optional logo/pin image for the business marker. Leave empty for a simple accent-color pin. The related `@apostrophecms/image` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document (one at most); a document the site can’t find is left out. At most 1 items. **Sometimes sent:** `undefined` when the site leaves it out. Optional light-theme variant. Falls back to the dark-theme image. The related `@apostrophecms/image` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document (one at most); a document the site can’t find is left out. At most 1 items. **Sometimes sent:** `undefined` when the site leaves it out. Accessible name + hover title for the marker. Leave empty to use the business name from Site settings. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Marker size. One of `small`, `medium`, `large`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. The business marker gently bobs in place. Automatically disabled for visitors who prefer reduced motion. **Sometimes sent:** `undefined` when the site leaves it out. Adds the business location (named by its label in Service area map → Your location) as the FIRST entry of the map key and zone cards. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The section’s full-width background band in dark mode. Transparent lets the page background show through. The palette options track the site colors; choose “Custom color…” for a specific color. One of `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Used when “Section background (dark theme)” is set to Custom color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. “Match dark theme” reuses the dark-theme choice; otherwise set the light-mode band independently. One of `inherit`, `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Used when “Section background (light theme)” is set to Custom color. **Sometimes sent:** `undefined` when the site leaves it out. A list of `ServiceMapWidgetServiceMapFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. **ServiceMapWidgetServiceMapFontOverridesItem** **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. **Sometimes sent:** `undefined` when the site leaves it out. Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. **Sometimes sent:** `undefined` when the site leaves it out. A list of `ServiceMapWidgetServiceMapFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. **ServiceMapWidgetServiceMapFontOverridesItemUploadsItem** **Always sent.** File attachment reference. **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Style. One of `normal`, `italic`; a newer site may send others, so keep a fallback. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`; a newer site may send others, so keep a fallback. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **BlogPreviewWidget** A `blog-preview` widget: its `type` and its own fields. A field left out takes its default. **Always sent.** The widget’s type: always `blog-preview`. One of `blog-preview`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. **Sometimes sent:** `undefined` when the site leaves it out. Always `widget`. One of `widget`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Heading. **Sometimes sent:** `undefined` when the site leaves it out. Subheading. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Aspect ratio of the featured image. Choose “Hidden” for text-only cards. One of `16/10`, `4/3`, `3/2`, `1/1`, `none`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Image hover. One of `zoom`, `none`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Use the featured image as the full card background, with the title and meta overlaid on a dark scrim. Posts with no image fall back to a normal card. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The card surface. Raised is a quiet lit card; Luxe a frosted glass panel; Outline a plaque frame; Spine adds a color rail; Tint an accent wash; Ticket/Bracket/Forge/Press/Inlay are the graphic showstoppers. (On image-led cards the photo covers the top edge.) One of `raised`, `luxe`, `outline`, `plain`, `poster`, `edge`, `tint`, `ticket`, `bracket`, `forge`, `press`, `inlay`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Corner rounding for each card. Default keeps the widget’s own tuned corners — except Forge, which defaults to tight machined corners matching its engraved frame. One of `default`, `square`, `slight`, `rounded`, `large`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Colors the Spine rail, Bracket marks, Forge corner/frame and Press margin rule. Leave empty to use the brand accent. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where the Forge plate wears its color: a single corner mark (the machinist’s datum, default) or the whole engraved frame. One of `corner`, `frame`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Thickness of the Forge corner mark / colored frame. One of `fine`, `medium`, `bold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. What a card does on hover. Lift/Pop/Press/Glow/Outline are instant; Sheen sweeps a light across; Tilt (3-D + glare), Magnetic and Spotlight follow the cursor (need site animations on). The Hover color below tints these. One of `none`, `lift`, `pop`, `press`, `glow`, `border`, `sheen`, `tilt`, `magnetic`, `spotlight`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Border / shadow / glow color on hover. Leave empty to use the site accent color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color, then the accent. **Sometimes sent:** `undefined` when the site leaves it out. Show category. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How the category badge uses its color (set per category under Blog Categories). Filled = colored background; Outline = colored border + text; Minimal = colored text only. One of `filled`, `outline`, `minimal`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Show date. **Sometimes sent:** `undefined` when the site leaves it out. Show excerpt. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How many lines of the excerpt to show before truncating. One of `2`, `3`, `4`, `none`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Show author. **Sometimes sent:** `undefined` when the site leaves it out. Show “Read post” link. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Auto puts it on the right of horizontal cards (list / compact / featured) and below the text on grid cards. Or force one placement everywhere. One of `auto`, `below`, `right`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Overrides the “Read post” link color. Leave empty to use the site accent color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color, then the accent. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Color of the “Read post” link when the card is hovered. Leave empty to use the accent color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme hover color, then the accent. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Overrides the card title color. Leave empty to track the theme’s text color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color, then the theme default. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Title weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Title color when the card is hovered. Leave empty to use the site accent color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme hover color, then the accent. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Overrides the excerpt text color. Leave empty for the muted default. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color, then the muted default. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Excerpt weight. One of `normal`, `medium`, `semibold`, `bold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Date / meta line color. Leave empty for the faint default. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color, then the faint default. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The section’s full-width background band in dark mode. Transparent lets the page background show through. The palette options track the site colors; choose “Custom color…” for a specific color. One of `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Used when “Section background (dark theme)” is set to Custom color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. “Match dark theme” reuses the dark-theme choice; otherwise set the light-mode band independently. One of `inherit`, `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Used when “Section background (light theme)” is set to Custom color. **Sometimes sent:** `undefined` when the site leaves it out. A list of `BlogPreviewWidgetBlogFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. **BlogPreviewWidgetBlogFontOverridesItem** **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. **Sometimes sent:** `undefined` when the site leaves it out. Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. **Sometimes sent:** `undefined` when the site leaves it out. A list of `BlogPreviewWidgetBlogFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. **BlogPreviewWidgetBlogFontOverridesItemUploadsItem** **Always sent.** File attachment reference. **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Style. One of `normal`, `italic`; a newer site may send others, so keep a fallback. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`; a newer site may send others, so keep a fallback. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **Sometimes sent:** `undefined` when the site leaves it out. The visible button text. Leave empty to hide the button. **Sometimes sent:** `undefined` when the site leaves it out. Where the button goes — a path (/blog) or full URL. **Sometimes sent:** `undefined` when the site leaves it out. Opens the link in a new browser tab (adds rel="noopener noreferrer"). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Button size. One of `small`, `normal`, `large`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Corner radius. One of `pill`, `rounded`, `slight`, `square`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The text/icon color. Clear it to derive from the button color (readable on solid fills). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme label color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Drives the hover treatment. Leave empty to derive it from the button color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme hover color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme shadow color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Hover motion. One of `lift`, `scale`, `lift-scale`, `none`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. The icon slides toward its side on hover (e.g. an arrow edges outward). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **CookieDeclarationWidget** A `cookie-declaration` widget: its `type` and its own fields. A field left out takes its default. **Always sent.** The widget’s type: always `cookie-declaration`. One of `cookie-declaration`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. **Sometimes sent:** `undefined` when the site leaves it out. Always `widget`. One of `widget`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Eyebrow. **Sometimes sent:** `undefined` when the site leaves it out. Heading. **Sometimes sent:** `undefined` when the site leaves it out. Introduction. **Sometimes sent:** `undefined` when the site leaves it out. A short block naming what this visitor has allowed, with a button that reopens the preferences panel. Withdrawal has to be as easy as consent, so leave this on unless the page offers another way. **Sometimes sent:** `undefined` when the site leaves it out. Provider, type, duration and domain per entry. Off leaves the plain-language disclosures alone, which reads better but tells a technical reader less. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Layout. One of `stacked`, `compact`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The section’s full-width background band in dark mode. Transparent lets the page background show through. The palette options track the site colors; choose “Custom color…” for a specific color. One of `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Used when “Section background (dark theme)” is set to Custom color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. “Match dark theme” reuses the dark-theme choice; otherwise set the light-mode band independently. One of `inherit`, `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Used when “Section background (light theme)” is set to Custom color. **Sometimes sent:** `undefined` when the site leaves it out. A list of `CookieDeclarationWidgetCookieDeclFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. **CookieDeclarationWidgetCookieDeclFontOverridesItem** **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. **Sometimes sent:** `undefined` when the site leaves it out. Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. **Sometimes sent:** `undefined` when the site leaves it out. A list of `CookieDeclarationWidgetCookieDeclFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. **CookieDeclarationWidgetCookieDeclFontOverridesItemUploadsItem** **Always sent.** File attachment reference. **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Style. One of `normal`, `italic`; a newer site may send others, so keep a fallback. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`; a newer site may send others, so keep a fallback. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **RichTextWidget** A `@apostrophecms/rich-text` widget: its `type` and its own fields. A field left out takes its default. **Always sent.** The widget’s type: always `@apostrophecms/rich-text`. One of `@apostrophecms/rich-text`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. **Sometimes sent:** `undefined` when the site leaves it out. Always `widget`. One of `widget`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. The text as HTML, e.g. `

Our story

It began with one idea.

`. The site keeps the tags and styles this area’s editor offers (paragraphs, headings, bold, italic, links, lists…) and removes the rest. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **GoogleReviewsWidget** A `google-reviews` widget: its `type` and its own fields. A field left out takes its default. **Always sent.** The widget’s type: always `google-reviews`. One of `google-reviews`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. **Sometimes sent:** `undefined` when the site leaves it out. Always `widget`. One of `widget`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Small label shown above the title. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Overrides the eyebrow + its dash. Leave empty to use the secondary (mint) color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color, then the mint default. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Eyebrow weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Eyebrow size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Optional. Leave empty to show just the reviews. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to track the theme text color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Heading weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Optional short sentence under the heading. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to use the muted text color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Intro weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Intro size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Header alignment. One of `center`, `left`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Only show reviews at or above this star rating. One of `0`, `3`, `4`, `5`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Show only reviews you have flagged “Featured” in the Google Reviews manager — hand-curate exactly which appear. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The most reviews to show (newest first). 1 to 30. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Animated carousel: a continuous, auto-scrolling marquee of cards (great on a home page; needs site animations enabled — falls back to the grid when they are off). Grid: a tidy multi-row grid. Masonry: a staggered, Pinterest-style grid that hugs each review’s length. One of `carousel`, `grid`, `masonry`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How many cards per row (grid) or columns (masonry). Auto fits as many as comfortably fit. One of `auto`, `2`, `3`, `4`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How fast the carousel auto-scrolls. The review carousel runs on its own (gentler) speed scale than the logos/footer marquees so two never scroll in lockstep. One of `vslow`, `slow`, `normal`, `fast`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Scroll direction. One of `left`, `right`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Gap between cards. One of `tight`, `normal`, `roomy`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Show the reviewer’s Google avatar (falls back to a lettered initial when missing or anonymous). **Sometimes sent:** `undefined` when the site leaves it out. Show star rating. **Sometimes sent:** `undefined` when the site leaves it out. Show review date. **Sometimes sent:** `undefined` when the site leaves it out. Include the business’s public reply beneath a review when there is one. **Sometimes sent:** `undefined` when the site leaves it out. A small Google attribution lockup under the section — recommended when showing Google reviews. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The card surface. Raised is a quiet lit card; Luxe is a frosted glass panel; Outline is a double-rule plaque frame; Plain has no chrome; Poster frames the card with an accent keyline; Spine embeds a color rail along the top; Tint washes the card in the accent color. Showstoppers: Ticket punches notches into the sides, Bracket draws only corner marks, Forge is a machined plate with an engraved frame, Press is a punched index card with a margin rule, Inlay recesses the content into a well. One of `raised`, `luxe`, `outline`, `plain`, `poster`, `edge`, `tint`, `ticket`, `bracket`, `forge`, `press`, `inlay`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Corner rounding for each card. Default keeps the widget’s own tuned corners — except Forge, which defaults to tight machined corners matching its engraved frame. One of `default`, `square`, `slight`, `rounded`, `large`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Colors the Spine rail, Bracket marks, Forge corner/frame and Press margin rule. Leave empty to use the brand accent. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where the Forge plate wears its color: a single corner mark (the machinist’s datum, default) or the whole engraved frame. One of `corner`, `frame`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Thickness of the Forge corner mark / colored frame. One of `fine`, `medium`, `bold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. What a card does on hover. Lift/Pop/Press/Glow/Outline are instant; Sheen sweeps a light across; Tilt, Magnetic and Spotlight follow the cursor (need site animations on). Vary it per section so the page is not cookie-cutter. One of `none`, `lift`, `pop`, `press`, `glow`, `border`, `sheen`, `tilt`, `magnetic`, `spotlight`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Sets the carousel card width and the minimum card width in the grid/masonry layouts. One of `narrow`, `normal`, `wide`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Auto hugs the content; the taller presets give every card a consistent minimum height (grid + carousel). The masonry layout ignores this and staggers card heights itself. One of `auto`, `medium`, `tall`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How the avatar, name, stars and text align inside each card. One of `left`, `center`, `right`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to use a warm amber. Applies in both themes. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — background of the lettered fallback avatar. Leave empty to use the brand accent. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Name size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Name weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to track the theme text color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Date size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Date weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to use the faint text color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Review text size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Review text weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to use the muted text color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Cap each review at this many lines (the rest is truncated with an ellipsis) so one very long review can’t blow up the card height — important once real, lengthy reviews come in. Choose “Full text” to never truncate. Short reviews are unaffected. One of `none`, `4`, `6`, `8`, `12`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The section’s full-width background band in dark mode. Transparent lets the page background show through. The palette options track the site colors; choose “Custom color…” for a specific color. One of `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Used when “Section background (dark theme)” is set to Custom color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. “Match dark theme” reuses the dark-theme choice; otherwise set the light-mode band independently. One of `inherit`, `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Used when “Section background (light theme)” is set to Custom color. **Sometimes sent:** `undefined` when the site leaves it out. A list of `GoogleReviewsWidgetReviewsFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. **GoogleReviewsWidgetReviewsFontOverridesItem** **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. **Sometimes sent:** `undefined` when the site leaves it out. Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. **Sometimes sent:** `undefined` when the site leaves it out. A list of `GoogleReviewsWidgetReviewsFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. **GoogleReviewsWidgetReviewsFontOverridesItemUploadsItem** **Always sent.** File attachment reference. **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Style. One of `normal`, `italic`; a newer site may send others, so keep a fallback. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`; a newer site may send others, so keep a fallback. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **Sometimes sent:** `undefined` when the site leaves it out. The visible button text. Leave empty to hide the button. **Sometimes sent:** `undefined` when the site leaves it out. Where the button goes — a path (/blog) or full URL. **Sometimes sent:** `undefined` when the site leaves it out. Opens the link in a new browser tab (adds rel="noopener noreferrer"). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Button size. One of `small`, `normal`, `large`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Corner radius. One of `pill`, `rounded`, `slight`, `square`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The text/icon color. Clear it to derive from the button color (readable on solid fills). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme label color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Drives the hover treatment. Leave empty to derive it from the button color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme hover color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme shadow color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Hover motion. One of `lift`, `scale`, `lift-scale`, `none`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. The icon slides toward its side on hover (e.g. an arrow edges outward). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **TestimonialsWidget** A `testimonials` widget: its `type` and its own fields. A field left out takes its default. **Always sent.** The widget’s type: always `testimonials`. One of `testimonials`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. **Sometimes sent:** `undefined` when the site leaves it out. Always `widget`. One of `widget`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Small label shown above the title. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Overrides the eyebrow + its dash. Leave empty to use the secondary (mint) color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color, then the mint default. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Eyebrow weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Eyebrow size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Optional. Leave empty to show just the testimonials. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to track the theme text color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Heading weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Optional short sentence under the heading. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to use the muted text color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Intro weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Intro size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Header alignment. One of `center`, `left`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Show only testimonials you have flagged “Featured” in the Testimonials manager — hand-curate exactly which appear. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The most testimonials to show (featured first). 1 to 30. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Animated carousel: a continuous, auto-scrolling marquee of cards (great on a home page; needs site animations enabled — falls back to the grid when they are off). Grid: a tidy multi-row grid. Masonry: a staggered, Pinterest-style grid that hugs each quote’s length. One of `carousel`, `grid`, `masonry`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How many cards per row (grid) or columns (masonry). Auto fits as many as comfortably fit. One of `auto`, `2`, `3`, `4`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How fast the carousel auto-scrolls. One of `vslow`, `slow`, `normal`, `fast`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Scroll direction. One of `left`, `right`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Gap between cards. One of `tight`, `normal`, `roomy`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Quote-led: a large quotation mark over the quote, with the author in a footer (the classic testimonial look). Accent bar: the quote beside a bold accent bar. Classic: the author on top (photo + name), then the quote — like a review card. One of `quote`, `bar`, `classic`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. The oversized “ glyph on the quote-led and accent-bar layouts. **Sometimes sent:** `undefined` when the site leaves it out. Show the author’s photo (falls back to a lettered initial when none is set). **Sometimes sent:** `undefined` when the site leaves it out. Show author role / context. **Sometimes sent:** `undefined` when the site leaves it out. Off by default — a testimonial usually leads with the quote. Turn on to show each testimonial’s star rating. **Sometimes sent:** `undefined` when the site leaves it out. The text for a testimonial’s optional “Source link” (set per testimonial in the Testimonials manager). Shown only on testimonials that have a link. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The card treatment. Spine (the default) embeds a color rail along the top; Raised is a quiet lit card; Luxe a frosted glass panel; Ticket/Bracket/Forge/Press/Inlay are the graphic showstoppers. One of `raised`, `luxe`, `outline`, `plain`, `poster`, `edge`, `tint`, `ticket`, `bracket`, `forge`, `press`, `inlay`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Corner rounding for each card. Default keeps the widget’s own tuned corners — except Forge, which defaults to tight machined corners matching its engraved frame. One of `default`, `square`, `slight`, `rounded`, `large`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Colors the Spine rail, Bracket marks, Forge corner/frame and Press margin rule. Leave empty to use the brand accent. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where the Forge plate wears its color: a single corner mark (the machinist’s datum, default) or the whole engraved frame. One of `corner`, `frame`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Thickness of the Forge corner mark / colored frame. One of `fine`, `medium`, `bold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. What a card does on hover. Lift/Pop/Press/Glow/Outline are instant; Sheen sweeps a light across; Tilt, Magnetic and Spotlight follow the cursor (need site animations on). Vary it per section so the page is not cookie-cutter. One of `none`, `lift`, `pop`, `press`, `glow`, `border`, `sheen`, `tilt`, `magnetic`, `spotlight`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Sets the carousel card width and the minimum card width in the grid/masonry layouts. One of `narrow`, `normal`, `wide`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Auto hugs the content; the taller presets give every card a consistent minimum height (grid + carousel). The masonry layout ignores this and staggers card heights itself. One of `auto`, `medium`, `tall`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How the quote and author align inside each card. One of `left`, `center`, `right`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to use a warm amber. Applies in both themes (only when ratings are shown). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — the quotation mark, the accent bar, and the lettered-avatar background. Leave empty to use the brand accent. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Name size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Name weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to track the theme text color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Role size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Role weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to use the faint text color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Quote size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Quote weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to use the theme text color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Cap each quote at this many lines (the rest is truncated with an ellipsis) so one very long testimonial can’t blow up the card height. Choose “Full text” to never truncate. Short quotes are unaffected. One of `none`, `4`, `6`, `8`, `12`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The section’s full-width background band in dark mode. Transparent lets the page background show through. The palette options track the site colors; choose “Custom color…” for a specific color. One of `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Used when “Section background (dark theme)” is set to Custom color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. “Match dark theme” reuses the dark-theme choice; otherwise set the light-mode band independently. One of `inherit`, `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Used when “Section background (light theme)” is set to Custom color. **Sometimes sent:** `undefined` when the site leaves it out. A list of `TestimonialsWidgetTestimonialsFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. **TestimonialsWidgetTestimonialsFontOverridesItem** **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. **Sometimes sent:** `undefined` when the site leaves it out. Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. **Sometimes sent:** `undefined` when the site leaves it out. A list of `TestimonialsWidgetTestimonialsFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. **TestimonialsWidgetTestimonialsFontOverridesItemUploadsItem** **Always sent.** File attachment reference. **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Style. One of `normal`, `italic`; a newer site may send others, so keep a fallback. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`; a newer site may send others, so keep a fallback. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **Sometimes sent:** `undefined` when the site leaves it out. The visible button text. Leave empty to hide the button. **Sometimes sent:** `undefined` when the site leaves it out. Where the button goes — a path (/blog) or full URL. **Sometimes sent:** `undefined` when the site leaves it out. Opens the link in a new browser tab (adds rel="noopener noreferrer"). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Button size. One of `small`, `normal`, `large`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Corner radius. One of `pill`, `rounded`, `slight`, `square`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The text/icon color. Clear it to derive from the button color (readable on solid fills). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme label color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Drives the hover treatment. Leave empty to derive it from the button color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme hover color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme shadow color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Hover motion. One of `lift`, `scale`, `lift-scale`, `none`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. The icon slides toward its side on hover (e.g. an arrow edges outward). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **InstagramFeedWidget** A `instagram-feed` widget: its `type` and its own fields. A field left out takes its default. **Always sent.** The widget’s type: always `instagram-feed`. One of `instagram-feed`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. **Sometimes sent:** `undefined` when the site leaves it out. Always `widget`. One of `widget`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Small label shown above the title. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Overrides the eyebrow + its dash. Leave empty to use the secondary (mint) color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color, then the mint default. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Eyebrow weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Eyebrow size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Optional. Leave empty to show just the feed. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to track the theme text color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Heading weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Optional short sentence under the heading. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to use the muted text color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Intro weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Intro size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Header alignment. One of `center`, `left`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Show only posts you have flagged “Featured” in the Instagram Posts manager — hand-curate exactly which appear. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The most posts to show (newest first). 1 to 30. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Filter this feed by media type. “Photos” keeps image and album posts; “Videos & reels” keeps only video posts. This is per-feed display only — it doesn’t change what gets synced. One of `all`, `photos`, `videos`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Carousel: a continuous, auto-scrolling marquee strip (great on a home page; needs site animations enabled — falls back to the grid when they are off). Grid: a tidy multi-row grid. Masonry: a staggered grid that hugs each image’s shape. Mosaic Photo Wall: an edge-to-edge, gap-free photo wall where rows are scaled to a common height (like Flickr / Google Photos) — the richest option for photos. One of `carousel`, `grid`, `masonry`, `justified`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How many tiles per row (grid) or columns (masonry). Auto fits as many as comfortably fit. (The Mosaic Photo Wall sets its own row layout.) One of `auto`, `2`, `3`, `4`, `5`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The target height of each row in the Mosaic Photo Wall. Taller rows show fewer, bigger photos per row. One of `compact`, `normal`, `tall`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. For feeds where every photo is the same shape (e.g. all square): assign each tile a varied shape (cropped around its focal point, never cutting the subject) so the wall still reads as an organic mosaic. Leave off when your photos already vary. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How fast the carousel auto-scrolls. The feed runs on its own speed scale so two marquees on a page never scroll in lockstep. One of `vslow`, `slow`, `normal`, `fast`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Scroll direction. One of `left`, `right`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Gap between tiles. One of `tight`, `normal`, `roomy`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Crop each image to a consistent shape. “Original” keeps each image’s own ratio (best with the masonry layout). One of `square`, `portrait`, `landscape`, `original`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Sets the carousel tile width and the minimum tile width in the grid/masonry layouts. One of `narrow`, `normal`, `wide`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Corner radius. One of `none`, `slight`, `rounded`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. What a tile does on hover. Lift/Glow are best for image tiles; Tilt, Magnetic and Spotlight follow the cursor (need site animations on). This is on top of the image zoom. One of `none`, `lift`, `pop`, `press`, `glow`, `border`, `sheen`, `tilt`, `magnetic`, `spotlight`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. A small corner glyph marking a video, reel, or carousel album. **Sometimes sent:** `undefined` when the site leaves it out. A corner Instagram glyph on each tile — the one opt-in link out to the post (opens in a new tab). The tile itself opens the on-site lightbox. **Sometimes sent:** `undefined` when the site leaves it out. A small heart + like count in the bottom corner of each tile. Off by default. (A post whose account hides like counts on Instagram shows nothing.) **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Size of the corner glyph, the video/reel badge, and the play affordance on video tiles. All three options are larger than the old fixed size. One of `small`, `medium`, `large`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Off by default (the classic image-only grid). When on, choose where the caption appears below. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Caption placement. One of `below`, `hover`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — color of the corner glyph + the hover wash. Leave empty to use the brand accent. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — color of the like heart on the tiles and in the lightbox. Leave empty to use the brand coral. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Cap each caption at this many lines so a long caption can’t blow up the tile. One of `none`, `1`, `2`, `3`, `4`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Caption size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Caption weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to use the muted text color (below mode) / white (hover mode). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out. Show the post’s like count in the lightbox. (An account that hides like counts on Instagram reports none — then nothing shows.) **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How comments appear in the lightbox. “Count only” shows just the total. “Full list” shows the actual comments — requires “Fetch post comments” in Connections → Instagram to be on so the comment text is synced. One of `none`, `count`, `list`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Show each commenter’s Instagram handle next to their comment. Turn off for a cleaner, anonymous list of just the comment text. **Sometimes sent:** `undefined` when the site leaves it out. The opt-in outbound link in the lightbox. Turn it off to keep visitors fully on your site (the corner glyph on each tile is a separate setting). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The section’s full-width background band in dark mode. Transparent lets the page background show through. The palette options track the site colors; choose “Custom color…” for a specific color. One of `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Used when “Section background (dark theme)” is set to Custom color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. “Match dark theme” reuses the dark-theme choice; otherwise set the light-mode band independently. One of `inherit`, `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Used when “Section background (light theme)” is set to Custom color. **Sometimes sent:** `undefined` when the site leaves it out. A list of `InstagramFeedWidgetInstagramFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. **InstagramFeedWidgetInstagramFontOverridesItem** **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. **Sometimes sent:** `undefined` when the site leaves it out. Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. **Sometimes sent:** `undefined` when the site leaves it out. A list of `InstagramFeedWidgetInstagramFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. **InstagramFeedWidgetInstagramFontOverridesItemUploadsItem** **Always sent.** File attachment reference. **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Style. One of `normal`, `italic`; a newer site may send others, so keep a fallback. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`; a newer site may send others, so keep a fallback. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **Sometimes sent:** `undefined` when the site leaves it out. The visible button text. Leave empty to hide the button. **Sometimes sent:** `undefined` when the site leaves it out. Where the button goes — a path (/blog) or full URL. **Sometimes sent:** `undefined` when the site leaves it out. Opens the link in a new browser tab (adds rel="noopener noreferrer"). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Button size. One of `small`, `normal`, `large`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Corner radius. One of `pill`, `rounded`, `slight`, `square`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The text/icon color. Clear it to derive from the button color (readable on solid fills). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme label color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Drives the hover treatment. Leave empty to derive it from the button color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme hover color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme shadow color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Hover motion. One of `lift`, `scale`, `lift-scale`, `none`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. The icon slides toward its side on hover (e.g. an arrow edges outward). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **GalleryPreviewWidget** A `gallery-preview` widget: its `type` and its own fields. A field left out takes its default. **Always sent.** The widget’s type: always `gallery-preview`. One of `gallery-preview`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. **Sometimes sent:** `undefined` when the site leaves it out. Always `widget`. One of `widget`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Small label shown above the title. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Overrides the eyebrow + its dash. Leave empty to use the secondary (mint) color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color, then the mint default. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Eyebrow weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Eyebrow size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Optional. Leave empty to show just the photos. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to track the theme text color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Heading weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Optional short sentence under the heading. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to use the muted text color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Intro weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Intro size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Header alignment. One of `center`, `left`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Album: a curated set you pick and order by hand — best for a designed page. Folder: automatically shows every image filed in a media-library folder (newest first) — best for bulk collections you organize in the media manager. Feed: a set that refreshes itself on a schedule from an external photo store, so the gallery shows different photos over time. One of `album`, `folder`, `feed`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. The Photo Album to display. Create and fill albums in the Photo Albums manager. The related `photo-album` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document (one at most); a document the site can’t find is left out. At most 1 items. **Sometimes sent:** `undefined` when the site leaves it out. The media-library folder to display. Every image filed in it (and its subfolders, if enabled) is shown, newest first. The related `image-folder` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document (one at most); a document the site can’t find is left out. At most 1 items. **Sometimes sent:** `undefined` when the site leaves it out. Also show images filed in folders inside the selected folder. **Sometimes sent:** `undefined` when the site leaves it out. The Photo Feed to display. This gallery stays pointed at the feed while the feed replaces its photos on its own schedule. Create and configure feeds in the Photo Feeds manager. The related `photo-feed` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document (one at most); a document the site can’t find is left out. At most 1 items. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Cap the teaser to this many photos. 0 shows everything in the selected source (folder photos are newest-first). 0 to 200. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Mosaic Photo Wall: an edge-to-edge wall where rows are scaled to a common height (like Flickr / Google Photos), cropped around each photo’s focal point — the richest option. Masonry: a staggered grid that hugs each photo’s shape. Grid: a tidy, uniform grid. Spotlight: every group of eight opens on an oversized lead photo, sides alternating on wide screens. Shaped Tiles: a portrait grid whose tiles cycle through slab, arch and orb shapes. Scrolling Banner: one edge-to-edge row that drifts sideways forever, so a long album reads as a ribbon of photos rather than a block — the option for a band between two sections rather than a gallery page. Panorama Wall: several rows, far wider than the screen, traveling sideways at slightly different speeds — and the visitor can push it along or against with a drag or a trackpad swipe. Vertical Ribbon: a band of columns running down the page instead of across it, neighboring columns traveling opposite ways, so the section reads as a moving curtain of photographs. One of `justified`, `masonry`, `grid`, `spotlight`, `shaped`, `banner`, `panorama`, `ribbon`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How many tiles per row (grid, shaped tiles) or columns (masonry). Auto fits as many as comfortably fit. (The Mosaic Photo Wall sets its own row layout; Spotlight sets its own pattern.) One of `auto`, `2`, `3`, `4`, `5`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The target height of each row in the Mosaic Photo Wall. Taller rows show fewer, bigger photos per row. One of `compact`, `normal`, `tall`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How tall the moving row stands. Each photo keeps its own shape, so a taller banner shows wider photos and fewer of them at once. One of `short`, `normal`, `tall`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How fast the row drifts. It also surges briefly with the page’s own scrolling, then settles back — so the band reacts to the visitor instead of ignoring them. One of `slow`, `normal`, `fast`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Banner direction. One of `left`, `right`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Fades the row out at both ends so photos scroll in and out instead of being cut off by a hard edge. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How many rows of photos the wall is dealt across. Photos go into the rows in turn, so consecutive shots land in different rows rather than stacking up together. Deep walls want a big set — a row needs at least three photos of its own, so a small album quietly uses fewer, fuller rows than you pick here. One of `2`, `3`, `4`, `5`, `6`, `7`, `8`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How tall each row stands, so the wall’s total depth is this times the number of rows — an eight-row Tall panorama fills a screen and then some. Each photo keeps its own shape, so taller rows show wider photos and fewer of them. One of `short`, `normal`, `tall`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How fast the wall travels. Each row takes a slightly different share of this, so the rows shear gently against each other and the block reads as depth rather than as one sliding sheet. It also surges briefly with the page’s own scrolling, then settles back. One of `slow`, `normal`, `fast`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Travel direction. One of `left`, `right`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Dragging the wall (or swiping sideways on a trackpad or phone) pushes it along or against its travel, and it glides back into its own pace when let go. Vertical scrolling always still scrolls the page. Needs site animations on in Site design → Motion. **Sometimes sent:** `undefined` when the site leaves it out. Fades the rows out at both ends so photos travel in and out instead of being cut off by a hard edge. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How many columns of photos the band is dealt across. Photos go into the columns in turn, so consecutive shots land in different columns rather than stacking up together. Narrow screens show fewer columns than you pick here (two on a phone, three on a tablet) — because photos in a 50-pixel sliver are not photos. A column needs at least three photos of its own, so a small album quietly uses fewer, fuller columns. One of `2`, `3`, `4`, `5`, `6`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How tall the band stands — the window the columns travel through, not the columns themselves, which are always far taller than it. Each photo keeps its own shape and fills its column’s width, so the columns show more photos at once the taller the band is. One of `short`, `normal`, `tall`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How fast the columns travel. Each takes a slightly different share of this, so the band reads as a weave rather than as one sheet sliding. Slower than the sideways layouts at every setting on purpose: this moves along the same axis the visitor scrolls in, where the same speed feels far more urgent. It also surges briefly with the page’s own scrolling, then settles back. One of `slow`, `normal`, `fast`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which way the first column travels. With alternating columns on (below), its neighbors go the other way. One of `up`, `down`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Send neighboring columns opposite ways, which is what makes the band read as a weave. Turn it off and the whole band travels one way together — quieter, and closer to a conventional scrolling wall. **Sometimes sent:** `undefined` when the site leaves it out. Fades the columns out at the top and bottom so photos travel in and out instead of being cut off by a hard edge. **Sometimes sent:** `undefined` when the site leaves it out. For albums where every photo is the same shape (e.g. all square): assign each tile a varied shape (cropped around its focal point, never cutting the subject) so the wall still reads as an organic mosaic. Leave off when your photos already vary. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Gap between tiles. One of `tight`, `normal`, `roomy`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Corner radius. One of `none`, `slight`, `rounded`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The tile surface. Raised floats each photo on a soft shadow (default); Plain is a clean edge-to-edge wall; Luxe / Outline / Poster frame it; Ticket / Bracket / Forge / Press add graphic structure. The photo fills the tile, so fill-based looks (Tint, Inlay) read as their frame + elevation. On the Shaped Tiles layout the structural looks (Ticket / Bracket / Forge / Press) fall back to their plain surface — their rectangular marks can’t follow an arch or orb. One of `raised`, `luxe`, `outline`, `plain`, `poster`, `edge`, `tint`, `ticket`, `bracket`, `forge`, `press`, `inlay`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Colors the Spine rail, Bracket marks, Forge corner/frame and Press margin rule. Leave empty to use the brand accent. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where the Forge plate wears its color: a single corner mark (the machinist’s datum, default) or the whole engraved frame. One of `corner`, `frame`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Thickness of the Forge corner mark / colored frame. One of `fine`, `medium`, `bold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. What a tile does on hover, on top of the surface above. Glow (default) / Lift read best on photo tiles; Press collapses a Poster offset; Tilt, Magnetic and Spotlight follow the cursor (need site animations on). This is on top of the image zoom. One of `none`, `lift`, `pop`, `press`, `glow`, `border`, `sheen`, `tilt`, `magnetic`, `spotlight`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Overlay each photo’s alt text on hover. Off by default (a clean photo wall). The caption always shows in the lightbox. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Caption size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Caption weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Clicking a photo opens it full-size in an on-site lightbox (with previous / next). Turn off for a purely decorative wall that doesn’t enlarge. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — color of the hover wash / glow. Leave empty to use the brand accent. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A very slow pan-and-zoom on every photo, each tile on its own rhythm, so the wall stays quietly alive instead of holding perfectly still. Off by default: a still gallery costs nothing to keep on screen, and this runs continuously for as long as the page is open. Turn it on if you also switch on “Rotate photos automatically” below — a photo changing on a wall that is otherwise frozen reads as a glitch. Skipped for visitors who ask for reduced motion, and when site animations are off in Site design → Motion. One of `off`, `subtle`, `bold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Sets every photo at its own depth: as the page scrolls, some slide with it and some against it, so the wall has layers instead of being one flat plane. It only moves while the visitor scrolls — nothing happens when the page is still. Skipped for visitors who ask for reduced motion, and when site animations are off in Site design → Motion. One of `off`, `subtle`, `bold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Every so often two photos trade places on the wall, gliding past each other into their new squares. Nothing resizes and nothing else on the wall moves — the grid’s squares are identical, so the photos simply swap seats. It holds still while a visitor’s pointer or keyboard is anywhere in the gallery, so nothing ever moves out from under a click. Skipped for visitors who ask for reduced motion, and when site animations are off in Site design → Motion. One of `off`, `calm`, `steady`, `lively`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Two photos swap with each other; three or more pass their seats along in a ring, so more of the wall is moving at once. Higher numbers read as the wall dealing itself a new hand rather than as two photos changing places. 2 to 6. **Sometimes sent:** `undefined` when the site leaves it out. Photos fade out a few at a time and are replaced from the rest of the source, so the gallery keeps changing while a visitor watches. Needs more photos in the source than are on screen — set “Maximum photos” above to less than the source holds. Set “Ambient drift” above to Subtle as well: a photo changing on a wall that is otherwise perfectly still reads as a glitch rather than as movement. Skipped for visitors who ask for reduced motion, and when site animations are off in Site design → Motion. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Cross-fade: the next photo dissolves over the old one as it eases in — the quietest change. Fade through a color: the tile also dips towards a flat color while the photos dissolve, so it reads as “phasing out” without ever going blank. Slide in: the next photo travels in over the old one, which drifts the same way behind it. Zoom through: the next photo settles out of a slight enlargement. Soften through: the photo blurs out of focus and the next one comes back into it. Wipe across: a clean edge travels over the tile, leaving the next photo behind it. Turn over: the tile turns like a card and comes back showing the next photo — the boldest of the seven. One of `cross`, `veil`, `push`, `scale`, `blur`, `wipe`, `turn`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Scattered spreads the changes over the whole wall, never twice in the same corner and never the same tile twice in a row. The other three move through the wall in a set direction, so the changes read as one gesture crossing the gallery rather than as separate events. One of `scatter`, `wave`, `columns`, `rows`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to dip through the page background, which suits both themes. Set white for a brighter bloom, or the brand accent for a bolder pulse. The dip never reaches full strength, so the photo always shows through. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The gap between one group of changes and the next. The real timing is deliberately uneven around this figure so the wall never feels metronomic. One of `calm`, `steady`, `lively`, `rapid`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How many tiles change per group. They never start on the same frame — each one follows the one before it by a beat, so a group reads as a ripple rather than a blink. 1 is the calmest; higher numbers keep more of the wall in motion. 1 to 6. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The length of one change, from the old photo to the new. Longer reads as a gentle phase; shorter as a snap — and short changes are the ones that read as choppy, so lean long. One of `quick`, `normal`, `slow`, `lingering`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How many photos beyond the ones on screen to send to the browser for the rotation to draw from — the bigger this is, the longer the gallery goes before a visitor sees a repeat. Retired photos go back to the end of the queue, so it cycles the whole reserve and then starts over. Cheap to raise: a reserved photo is a few URLs, well under 100 bytes once the page is compressed, and its image file is only fetched when it is about to appear. 0 to 500. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The section’s full-width background band in dark mode. Transparent lets the page background show through. The palette options track the site colors; choose “Custom color…” for a specific color. One of `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Used when “Section background (dark theme)” is set to Custom color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. “Match dark theme” reuses the dark-theme choice; otherwise set the light-mode band independently. One of `inherit`, `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Used when “Section background (light theme)” is set to Custom color. **Sometimes sent:** `undefined` when the site leaves it out. A list of `GalleryPreviewWidgetGalleryFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. **GalleryPreviewWidgetGalleryFontOverridesItem** **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. **Sometimes sent:** `undefined` when the site leaves it out. Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. **Sometimes sent:** `undefined` when the site leaves it out. A list of `GalleryPreviewWidgetGalleryFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. **GalleryPreviewWidgetGalleryFontOverridesItemUploadsItem** **Always sent.** File attachment reference. **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Style. One of `normal`, `italic`; a newer site may send others, so keep a fallback. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`; a newer site may send others, so keep a fallback. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **Sometimes sent:** `undefined` when the site leaves it out. The visible button text. Leave empty to hide the button. **Sometimes sent:** `undefined` when the site leaves it out. Where the button goes — a path (/blog) or full URL. **Sometimes sent:** `undefined` when the site leaves it out. Opens the link in a new browser tab (adds rel="noopener noreferrer"). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Button size. One of `small`, `normal`, `large`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Corner radius. One of `pill`, `rounded`, `slight`, `square`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The text/icon color. Clear it to derive from the button color (readable on solid fills). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme label color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Drives the hover treatment. Leave empty to derive it from the button color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme hover color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme shadow color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Hover motion. One of `lift`, `scale`, `lift-scale`, `none`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. The icon slides toward its side on hover (e.g. an arrow edges outward). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **GalleryFullWidget** A `gallery-full` widget: its `type` and its own fields. A field left out takes its default. **Always sent.** The widget’s type: always `gallery-full`. One of `gallery-full`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. **Sometimes sent:** `undefined` when the site leaves it out. Always `widget`. One of `widget`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Small label shown above the title. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Overrides the eyebrow + its dash. Leave empty to use the secondary (mint) color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color, then the mint default. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Eyebrow weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Eyebrow size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Optional. Leave empty to show just the photos. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to track the theme text color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Heading weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Optional short sentence under the heading. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to use the muted text color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Intro weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Intro size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Header alignment. One of `center`, `left`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Album: a curated set you pick and order by hand — best for a designed page. Folder: automatically shows every image filed in a media-library folder (newest first) — best for bulk collections you organize in the media manager. Feed: a set that refreshes itself on a schedule from an external photo store, so the gallery shows different photos over time. One of `album`, `folder`, `feed`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. The Photo Album to display. Create and fill albums in the Photo Albums manager. The related `photo-album` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document (one at most); a document the site can’t find is left out. At most 1 items. **Sometimes sent:** `undefined` when the site leaves it out. The media-library folder to display. Every image filed in it (and its subfolders, if enabled) is shown, newest first. The related `image-folder` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document (one at most); a document the site can’t find is left out. At most 1 items. **Sometimes sent:** `undefined` when the site leaves it out. Also show images filed in folders inside the selected folder. **Sometimes sent:** `undefined` when the site leaves it out. The Photo Feed to display. This gallery stays pointed at the feed while the feed replaces its photos on its own schedule. Create and configure feeds in the Photo Feeds manager. The related `photo-feed` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document (one at most); a document the site can’t find is left out. At most 1 items. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The most photos to show. 0 (default) shows everything in the selected source (folder photos are newest-first). 0 to 200. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Mosaic Photo Wall: an edge-to-edge wall where rows are scaled to a common height (like Flickr / Google Photos), cropped around each photo’s focal point — the richest option. Masonry: a staggered grid that hugs each photo’s shape. Grid: a tidy, uniform grid. Spotlight: every group of eight opens on an oversized lead photo, sides alternating on wide screens. Shaped Tiles: a portrait grid whose tiles cycle through slab, arch and orb shapes. Scrolling Banner: one edge-to-edge row that drifts sideways forever, so a long album reads as a ribbon of photos rather than a block — the option for a band between two sections rather than a gallery page. Panorama Wall: several rows, far wider than the screen, traveling sideways at slightly different speeds — and the visitor can push it along or against with a drag or a trackpad swipe. Vertical Ribbon: a band of columns running down the page instead of across it, neighboring columns traveling opposite ways, so the section reads as a moving curtain of photographs. One of `justified`, `masonry`, `grid`, `spotlight`, `shaped`, `banner`, `panorama`, `ribbon`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How many tiles per row (grid, shaped tiles) or columns (masonry). Auto fits as many as comfortably fit. (The Mosaic Photo Wall sets its own row layout; Spotlight sets its own pattern.) One of `auto`, `2`, `3`, `4`, `5`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The target height of each row in the Mosaic Photo Wall. Taller rows show fewer, bigger photos per row. One of `compact`, `normal`, `tall`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How tall the moving row stands. Each photo keeps its own shape, so a taller banner shows wider photos and fewer of them at once. One of `short`, `normal`, `tall`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How fast the row drifts. It also surges briefly with the page’s own scrolling, then settles back — so the band reacts to the visitor instead of ignoring them. One of `slow`, `normal`, `fast`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Banner direction. One of `left`, `right`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Fades the row out at both ends so photos scroll in and out instead of being cut off by a hard edge. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How many rows of photos the wall is dealt across. Photos go into the rows in turn, so consecutive shots land in different rows rather than stacking up together. Deep walls want a big set — a row needs at least three photos of its own, so a small album quietly uses fewer, fuller rows than you pick here. One of `2`, `3`, `4`, `5`, `6`, `7`, `8`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How tall each row stands, so the wall’s total depth is this times the number of rows — an eight-row Tall panorama fills a screen and then some. Each photo keeps its own shape, so taller rows show wider photos and fewer of them. One of `short`, `normal`, `tall`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How fast the wall travels. Each row takes a slightly different share of this, so the rows shear gently against each other and the block reads as depth rather than as one sliding sheet. It also surges briefly with the page’s own scrolling, then settles back. One of `slow`, `normal`, `fast`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Travel direction. One of `left`, `right`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Dragging the wall (or swiping sideways on a trackpad or phone) pushes it along or against its travel, and it glides back into its own pace when let go. Vertical scrolling always still scrolls the page. Needs site animations on in Site design → Motion. **Sometimes sent:** `undefined` when the site leaves it out. Fades the rows out at both ends so photos travel in and out instead of being cut off by a hard edge. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How many columns of photos the band is dealt across. Photos go into the columns in turn, so consecutive shots land in different columns rather than stacking up together. Narrow screens show fewer columns than you pick here (two on a phone, three on a tablet) — because photos in a 50-pixel sliver are not photos. A column needs at least three photos of its own, so a small album quietly uses fewer, fuller columns. One of `2`, `3`, `4`, `5`, `6`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How tall the band stands — the window the columns travel through, not the columns themselves, which are always far taller than it. Each photo keeps its own shape and fills its column’s width, so the columns show more photos at once the taller the band is. One of `short`, `normal`, `tall`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How fast the columns travel. Each takes a slightly different share of this, so the band reads as a weave rather than as one sheet sliding. Slower than the sideways layouts at every setting on purpose: this moves along the same axis the visitor scrolls in, where the same speed feels far more urgent. It also surges briefly with the page’s own scrolling, then settles back. One of `slow`, `normal`, `fast`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which way the first column travels. With alternating columns on (below), its neighbors go the other way. One of `up`, `down`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Send neighboring columns opposite ways, which is what makes the band read as a weave. Turn it off and the whole band travels one way together — quieter, and closer to a conventional scrolling wall. **Sometimes sent:** `undefined` when the site leaves it out. Fades the columns out at the top and bottom so photos travel in and out instead of being cut off by a hard edge. **Sometimes sent:** `undefined` when the site leaves it out. For albums where every photo is the same shape (e.g. all square): assign each tile a varied shape (cropped around its focal point, never cutting the subject) so the wall still reads as an organic mosaic. Leave off when your photos already vary. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Gap between tiles. One of `tight`, `normal`, `roomy`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Corner radius. One of `none`, `slight`, `rounded`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The tile surface. Raised floats each photo on a soft shadow (default); Plain is a clean edge-to-edge wall; Luxe / Outline / Poster frame it; Ticket / Bracket / Forge / Press add graphic structure. The photo fills the tile, so fill-based looks (Tint, Inlay) read as their frame + elevation. On the Shaped Tiles layout the structural looks (Ticket / Bracket / Forge / Press) fall back to their plain surface — their rectangular marks can’t follow an arch or orb. One of `raised`, `luxe`, `outline`, `plain`, `poster`, `edge`, `tint`, `ticket`, `bracket`, `forge`, `press`, `inlay`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Colors the Spine rail, Bracket marks, Forge corner/frame and Press margin rule. Leave empty to use the brand accent. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where the Forge plate wears its color: a single corner mark (the machinist’s datum, default) or the whole engraved frame. One of `corner`, `frame`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Thickness of the Forge corner mark / colored frame. One of `fine`, `medium`, `bold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. What a tile does on hover, on top of the surface above. Glow (default) / Lift read best on photo tiles; Press collapses a Poster offset; Tilt, Magnetic and Spotlight follow the cursor (need site animations on). This is on top of the image zoom. One of `none`, `lift`, `pop`, `press`, `glow`, `border`, `sheen`, `tilt`, `magnetic`, `spotlight`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Overlay each photo’s alt text on hover. Off by default (a clean photo wall). The caption always shows in the lightbox. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Caption size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Caption weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Clicking a photo opens it full-size in an on-site lightbox (with previous / next). Turn off for a purely decorative wall that doesn’t enlarge. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — color of the hover wash / glow. Leave empty to use the brand accent. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A very slow pan-and-zoom on every photo, each tile on its own rhythm, so the wall stays quietly alive instead of holding perfectly still. Off by default: a still gallery costs nothing to keep on screen, and this runs continuously for as long as the page is open. Turn it on if you also switch on “Rotate photos automatically” below — a photo changing on a wall that is otherwise frozen reads as a glitch. Skipped for visitors who ask for reduced motion, and when site animations are off in Site design → Motion. One of `off`, `subtle`, `bold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Sets every photo at its own depth: as the page scrolls, some slide with it and some against it, so the wall has layers instead of being one flat plane. It only moves while the visitor scrolls — nothing happens when the page is still. Skipped for visitors who ask for reduced motion, and when site animations are off in Site design → Motion. One of `off`, `subtle`, `bold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Every so often two photos trade places on the wall, gliding past each other into their new squares. Nothing resizes and nothing else on the wall moves — the grid’s squares are identical, so the photos simply swap seats. It holds still while a visitor’s pointer or keyboard is anywhere in the gallery, so nothing ever moves out from under a click. Skipped for visitors who ask for reduced motion, and when site animations are off in Site design → Motion. One of `off`, `calm`, `steady`, `lively`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Two photos swap with each other; three or more pass their seats along in a ring, so more of the wall is moving at once. Higher numbers read as the wall dealing itself a new hand rather than as two photos changing places. 2 to 6. **Sometimes sent:** `undefined` when the site leaves it out. Photos fade out a few at a time and are replaced from the rest of the source, so the gallery keeps changing while a visitor watches. Needs more photos in the source than are on screen — set “Maximum photos” above to less than the source holds. Set “Ambient drift” above to Subtle as well: a photo changing on a wall that is otherwise perfectly still reads as a glitch rather than as movement. Skipped for visitors who ask for reduced motion, and when site animations are off in Site design → Motion. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Cross-fade: the next photo dissolves over the old one as it eases in — the quietest change. Fade through a color: the tile also dips towards a flat color while the photos dissolve, so it reads as “phasing out” without ever going blank. Slide in: the next photo travels in over the old one, which drifts the same way behind it. Zoom through: the next photo settles out of a slight enlargement. Soften through: the photo blurs out of focus and the next one comes back into it. Wipe across: a clean edge travels over the tile, leaving the next photo behind it. Turn over: the tile turns like a card and comes back showing the next photo — the boldest of the seven. One of `cross`, `veil`, `push`, `scale`, `blur`, `wipe`, `turn`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Scattered spreads the changes over the whole wall, never twice in the same corner and never the same tile twice in a row. The other three move through the wall in a set direction, so the changes read as one gesture crossing the gallery rather than as separate events. One of `scatter`, `wave`, `columns`, `rows`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to dip through the page background, which suits both themes. Set white for a brighter bloom, or the brand accent for a bolder pulse. The dip never reaches full strength, so the photo always shows through. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The gap between one group of changes and the next. The real timing is deliberately uneven around this figure so the wall never feels metronomic. One of `calm`, `steady`, `lively`, `rapid`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How many tiles change per group. They never start on the same frame — each one follows the one before it by a beat, so a group reads as a ripple rather than a blink. 1 is the calmest; higher numbers keep more of the wall in motion. 1 to 6. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The length of one change, from the old photo to the new. Longer reads as a gentle phase; shorter as a snap — and short changes are the ones that read as choppy, so lean long. One of `quick`, `normal`, `slow`, `lingering`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How many photos beyond the ones on screen to send to the browser for the rotation to draw from — the bigger this is, the longer the gallery goes before a visitor sees a repeat. Retired photos go back to the end of the queue, so it cycles the whole reserve and then starts over. Cheap to raise: a reserved photo is a few URLs, well under 100 bytes once the page is compressed, and its image file is only fetched when it is about to appear. 0 to 500. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The section’s full-width background band in dark mode. Transparent lets the page background show through. The palette options track the site colors; choose “Custom color…” for a specific color. One of `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Used when “Section background (dark theme)” is set to Custom color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. “Match dark theme” reuses the dark-theme choice; otherwise set the light-mode band independently. One of `inherit`, `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Used when “Section background (light theme)” is set to Custom color. **Sometimes sent:** `undefined` when the site leaves it out. A list of `GalleryFullWidgetGalleryFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. **GalleryFullWidgetGalleryFontOverridesItem** **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. **Sometimes sent:** `undefined` when the site leaves it out. Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. **Sometimes sent:** `undefined` when the site leaves it out. A list of `GalleryFullWidgetGalleryFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. **GalleryFullWidgetGalleryFontOverridesItemUploadsItem** **Always sent.** File attachment reference. **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Style. One of `normal`, `italic`; a newer site may send others, so keep a fallback. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`; a newer site may send others, so keep a fallback. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **Sometimes sent:** `undefined` when the site leaves it out. The visible button text. Leave empty to hide the button. **Sometimes sent:** `undefined` when the site leaves it out. Where the button goes — a path (/blog) or full URL. **Sometimes sent:** `undefined` when the site leaves it out. Opens the link in a new browser tab (adds rel="noopener noreferrer"). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Button size. One of `small`, `normal`, `large`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Corner radius. One of `pill`, `rounded`, `slight`, `square`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The text/icon color. Clear it to derive from the button color (readable on solid fills). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme label color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Drives the hover treatment. Leave empty to derive it from the button color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme hover color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme shadow color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Hover motion. One of `lift`, `scale`, `lift-scale`, `none`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. The icon slides toward its side on hover (e.g. an arrow edges outward). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **PricingWidget** A `pricing` widget: its `type` and its own fields. A field left out takes its default. **Always sent.** The widget’s type: always `pricing`. One of `pricing`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. **Sometimes sent:** `undefined` when the site leaves it out. Always `widget`. One of `widget`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. A small label above the heading (e.g. "Pricing"). **Sometimes sent:** `undefined` when the site leaves it out. Eyebrow. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to use the secondary (mint) color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Eyebrow weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Eyebrow size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Optional. Leave empty to show just the cards. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to track the theme text color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Heading weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Heading size. One of `small`, `normal`, `large`, `xlarge`, `xxlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Optional short sentence under the heading. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to use the muted text color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Intro weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Intro size. One of `small`, `normal`, `large`, `xlarge`, `xxlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Auto fits as many as comfortably fit and works for any number of cards. Or lock a maximum per row. One of `auto`, `2`, `3`, `4`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Gap between cards. One of `tight`, `normal`, `roomy`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The base treatment for every tier (a highlighted tier always gets its own bold framed look). Raised is a quiet lit card; Luxe a frosted glass panel; Outline a plaque frame; Spine adds a color rail; Tint an accent wash; Ticket/Bracket/Forge/Press/Inlay are the graphic showstoppers. One of `raised`, `luxe`, `outline`, `plain`, `poster`, `edge`, `tint`, `ticket`, `bracket`, `forge`, `press`, `inlay`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Corner rounding for each card. Default keeps the widget’s own tuned corners — except Forge, which defaults to tight machined corners matching its engraved frame. One of `default`, `square`, `slight`, `rounded`, `large`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Colors the Spine rail, Bracket marks, Forge corner/frame and Press margin rule. Leave empty to use the brand accent. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where the Forge plate wears its color: a single corner mark (the machinist’s datum, default) or the whole engraved frame. One of `corner`, `frame`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Thickness of the Forge corner mark / colored frame. One of `fine`, `medium`, `bold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Aligns the section header and the text inside each card. One of `center`, `left`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Stretch every card to the tallest one and pin each button to the bottom, so the cards line up even with uneven feature lists. **Sometimes sent:** `undefined` when the site leaves it out. A check (included) or cross (not included) before each feature. Off = a plain list. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How a card reacts to the pointer. Rise floats it up on an accent underglow; Selection ring previews the highlighted look + tints the price; Spotlight washes accent light over the price; Checklist lights up the ✓ marks one-by-one; Tilt is a 3-D parallax that only runs when site animations are on. One of `none`, `rise`, `ring`, `spotlight`, `checklist`, `tilt`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Border / glow / spotlight / checkmark color on hover. Leave empty to use the highlight accent (then the site accent). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme hover accent. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How the cards animate in as they scroll into view. Featured-led makes the highlighted tier settle last with a little emphasis (draws the eye to the recommended plan); Simple stagger fades them in evenly. Only plays when site animations are on (Site design → Motion) — otherwise the cards are simply shown. One of `featured`, `stagger`, `none`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Size of each card’s name / title. One of `small`, `normal`, `large`, `xlarge`, `xxlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Size of the price amount (the period and price note scale with it). One of `small`, `normal`, `large`, `xlarge`, `xxlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Size of each card’s description blurb. One of `small`, `normal`, `large`, `xlarge`, `xxlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Size of the feature list text (notes and check marks scale with it). One of `small`, `normal`, `large`, `xlarge`, `xxlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Ribbon text shown on a highlighted tier that doesn’t set its own badge. Each tier can override it (or badge a non-highlighted tier) below. Leave empty for no automatic badge. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Color for the highlighted tier’s border + ring and each tier’s badge. Leave empty to use the site accent color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme accent. **Sometimes sent:** `undefined` when the site leaves it out. A list of `PricingWidgetPricingTiersItem`. Each card is one tier / package / service. Toggle “Highlight” on the one you want to stand out. **PricingWidgetPricingTiersItem** **Always sent.** Tier / package / service name — e.g. "Starter", "Studio", "Agency". **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **Sometimes sent:** `undefined` when the site leaves it out. Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to use the design’s own color rhythm. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Icon animation. One of `none`, `fa-beat`, `fa-bounce`, `fa-fade`, `fa-beat-fade`, `fa-flip`, `fa-shake`, `fa-spin`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Relative to the component’s base icon size. One of `default`, `sm`, `lg`, `xl`, `2xl`, `2x`, `3x`, `4x`, `5x`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Breathing room below the icon, before the card name. One of `none`, `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. A small ribbon on the card, e.g. "Best value", "Limited spots". Overrides the default highlight badge for this tier; works on any tier, highlighted or not. Empty on a highlighted tier falls back to the section’s "Default highlight badge". **Sometimes sent:** `undefined` when the site leaves it out. Emphasize this tier — accent border + ring, a subtle lift, and the Featured button look. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How this card’s text lines up. Normal = the section default (a centered section keeps the feature list left-aligned, as now). Center also centers the feature list; Left / Right align everything that way. One of `normal`, `left`, `center`, `right`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Free text, so it fits any model — "$45", "From $200", "Custom", "Call for quote". **Sometimes sent:** `undefined` when the site leaves it out. Shown after the price, e.g. "/ month", "per night", "per session". Leave empty for a flat price. **Sometimes sent:** `undefined` when the site leaves it out. A small line under the price, e.g. "per seat", "billed annually", "+ tax". **Sometimes sent:** `undefined` when the site leaves it out. A short blurb under the name. **Sometimes sent:** `undefined` when the site leaves it out. A list of `PricingWidgetPricingTiersItemFeaturesItem`. The bullet list of what’s included. **PricingWidgetPricingTiersItemFeaturesItem** **Always sent.** Feature. **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **Sometimes sent:** `undefined` when the site leaves it out. On = a check mark; off = a crossed-out / muted line (e.g. a feature this tier lacks). **Sometimes sent:** `undefined` when the site leaves it out. A small qualifier shown after the feature, e.g. "up to 5", "add-on". **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **Sometimes sent:** `undefined` when the site leaves it out. This card’s button text. Leave empty to use the shared button label (set in the Pricing · Buttons tab); clear it everywhere to hide the button. **Sometimes sent:** `undefined` when the site leaves it out. Where the button goes — a path (/contact-us) or full URL. Leave empty to inherit the shared button link. **Sometimes sent:** `undefined` when the site leaves it out. Open button in new tab. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The section’s full-width background band in dark mode. Transparent lets the page background show through. The palette options track the site colors; choose “Custom color…” for a specific color. One of `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Used when “Section background (dark theme)” is set to Custom color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. “Match dark theme” reuses the dark-theme choice; otherwise set the light-mode band independently. One of `inherit`, `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Used when “Section background (light theme)” is set to Custom color. **Sometimes sent:** `undefined` when the site leaves it out. A list of `PricingWidgetPricingFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. **PricingWidgetPricingFontOverridesItem** **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. **Sometimes sent:** `undefined` when the site leaves it out. Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. **Sometimes sent:** `undefined` when the site leaves it out. A list of `PricingWidgetPricingFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. **PricingWidgetPricingFontOverridesItemUploadsItem** **Always sent.** File attachment reference. **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Style. One of `normal`, `italic`; a newer site may send others, so keep a fallback. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`; a newer site may send others, so keep a fallback. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **Sometimes sent:** `undefined` when the site leaves it out. The visible button text. Leave empty to hide the button. **Sometimes sent:** `undefined` when the site leaves it out. Where the button goes — a path (/blog) or full URL. **Sometimes sent:** `undefined` when the site leaves it out. Opens the link in a new browser tab (adds rel="noopener noreferrer"). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Button size. One of `small`, `normal`, `large`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Corner radius. One of `pill`, `rounded`, `slight`, `square`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The text/icon color. Clear it to derive from the button color (readable on solid fills). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme label color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Drives the hover treatment. Leave empty to derive it from the button color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme hover color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme shadow color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Hover motion. One of `lift`, `scale`, `lift-scale`, `none`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. The icon slides toward its side on hover (e.g. an arrow edges outward). **Sometimes sent:** `undefined` when the site leaves it out. The visible button text. Leave empty to hide the button. **Sometimes sent:** `undefined` when the site leaves it out. Where the button goes — a path (/blog) or full URL. **Sometimes sent:** `undefined` when the site leaves it out. Opens the link in a new browser tab (adds rel="noopener noreferrer"). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Button size. One of `small`, `normal`, `large`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Corner radius. One of `pill`, `rounded`, `slight`, `square`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The text/icon color. Clear it to derive from the button color (readable on solid fills). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme label color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Drives the hover treatment. Leave empty to derive it from the button color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme hover color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme shadow color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Hover motion. One of `lift`, `scale`, `lift-scale`, `none`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. The icon slides toward its side on hover (e.g. an arrow edges outward). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **NewsletterWidget** A `newsletter` widget: its `type` and its own fields. A field left out takes its default. **Always sent.** The widget’s type: always `newsletter`. One of `newsletter`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. **Sometimes sent:** `undefined` when the site leaves it out. Always `widget`. One of `widget`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. The Form (Forms manager) that receives these submissions and routes them — configure its destinations on the form’s Actions tab. Create one if you have not yet. The related `@apostrophecms/form` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document (one at most); a document the site can’t find is left out. At most 1 items. **Sometimes sent:** `undefined` when the site leaves it out. Show eyebrow. **Sometimes sent:** `undefined` when the site leaves it out. Small label shown above the title. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Overrides the eyebrow + its dash. Leave empty to use the secondary (mint) color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color, then the mint default. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Eyebrow weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Eyebrow size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Heading. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to track the theme text color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Size. One of `small`, `normal`, `large`, `xlarge`, `xxlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Optional short sentence under the heading. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to use the muted text color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Size. One of `small`, `normal`, `large`, `xlarge`, `xxlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Plain sits on the page; Raised is a contained card; Accent is a solid brand-color band. One of `plain`, `raised`, `accent`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The accent band color. Leave empty to use the site accent color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color, then the accent. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Alignment. One of `center`, `left`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Inline puts the field + button on one row (stacks on small screens); Stacked always stacks them. One of `inline`, `stacked`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Content width. One of `narrow`, `normal`, `wide`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Collect a name. **Sometimes sent:** `undefined` when the site leaves it out. Name label. **Sometimes sent:** `undefined` when the site leaves it out. Name placeholder. **Sometimes sent:** `undefined` when the site leaves it out. Email label. **Sometimes sent:** `undefined` when the site leaves it out. Email placeholder. **Sometimes sent:** `undefined` when the site leaves it out. Optional opt-in checkbox (e.g. for GDPR-style explicit consent). **Sometimes sent:** `undefined` when the site leaves it out. Consent statement. **Sometimes sent:** `undefined` when the site leaves it out. A small line under the form, e.g. an unsubscribe note. **Sometimes sent:** `undefined` when the site leaves it out. Success message. **Sometimes sent:** `undefined` when the site leaves it out. Error message. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The section’s full-width background band in dark mode. Transparent lets the page background show through. The palette options track the site colors; choose “Custom color…” for a specific color. One of `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Used when “Section background (dark theme)” is set to Custom color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. “Match dark theme” reuses the dark-theme choice; otherwise set the light-mode band independently. One of `inherit`, `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Used when “Section background (light theme)” is set to Custom color. **Sometimes sent:** `undefined` when the site leaves it out. A list of `NewsletterWidgetNewsletterFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. **NewsletterWidgetNewsletterFontOverridesItem** **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. **Sometimes sent:** `undefined` when the site leaves it out. Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. **Sometimes sent:** `undefined` when the site leaves it out. A list of `NewsletterWidgetNewsletterFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. **NewsletterWidgetNewsletterFontOverridesItemUploadsItem** **Always sent.** File attachment reference. **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Style. One of `normal`, `italic`; a newer site may send others, so keep a fallback. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`; a newer site may send others, so keep a fallback. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **Sometimes sent:** `undefined` when the site leaves it out. The visible button text. Leave empty to hide the button. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Button size. One of `small`, `normal`, `large`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Corner radius. One of `pill`, `rounded`, `slight`, `square`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The text/icon color. Clear it to derive from the button color (readable on solid fills). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme label color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Drives the hover treatment. Leave empty to derive it from the button color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme hover color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme shadow color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Hover motion. One of `lift`, `scale`, `lift-scale`, `none`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. The icon slides toward its side on hover (e.g. an arrow edges outward). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **SmsSignupWidget** A `sms-signup` widget: its `type` and its own fields. A field left out takes its default. **Always sent.** The widget’s type: always `sms-signup`. One of `sms-signup`; a newer site may send others, so keep a fallback. **Always sent.** Shown beside a required checkbox; the form shows only once this is filled in. Be specific about what they are agreeing to. The brand name is added automatically from Site settings. **Sometimes sent:** `undefined` when the site leaves it out. The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. **Sometimes sent:** `undefined` when the site leaves it out. Always `widget`. One of `widget`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. The Form (Forms manager) that receives these SMS opt-ins and routes them — configure its destinations on the form’s Actions tab. The related `@apostrophecms/form` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document (one at most); a document the site can’t find is left out. At most 1 items. **Sometimes sent:** `undefined` when the site leaves it out. Show eyebrow. **Sometimes sent:** `undefined` when the site leaves it out. Small label shown above the title. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Overrides the eyebrow + its dash. Leave empty to use the secondary (mint) color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color, then the mint default. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Eyebrow weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Eyebrow size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Heading. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to track the theme text color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Size. One of `small`, `normal`, `large`, `xlarge`, `xxlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Optional short sentence under the heading. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to use the muted text color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Size. One of `small`, `normal`, `large`, `xlarge`, `xxlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Plain sits on the page; Raised is a contained card; Accent is a solid brand-color band. One of `plain`, `raised`, `accent`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The accent band color. Leave empty to use the site accent color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color, then the accent. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Alignment. One of `center`, `left`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Inline puts the field + button on one row (stacks on small screens); Stacked always stacks them. One of `inline`, `stacked`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Content width. One of `narrow`, `normal`, `wide`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Collect a name. **Sometimes sent:** `undefined` when the site leaves it out. Name label. **Sometimes sent:** `undefined` when the site leaves it out. Name placeholder. **Sometimes sent:** `undefined` when the site leaves it out. Phone label. **Sometimes sent:** `undefined` when the site leaves it out. Phone placeholder. **Sometimes sent:** `undefined` when the site leaves it out. Carrier-compliance fine print shown under the form. **Sometimes sent:** `undefined` when the site leaves it out. Optional — linked from the fine print. **Sometimes sent:** `undefined` when the site leaves it out. Optional — linked from the fine print. **Sometimes sent:** `undefined` when the site leaves it out. Success message. **Sometimes sent:** `undefined` when the site leaves it out. Error message. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The section’s full-width background band in dark mode. Transparent lets the page background show through. The palette options track the site colors; choose “Custom color…” for a specific color. One of `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Used when “Section background (dark theme)” is set to Custom color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. “Match dark theme” reuses the dark-theme choice; otherwise set the light-mode band independently. One of `inherit`, `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Used when “Section background (light theme)” is set to Custom color. **Sometimes sent:** `undefined` when the site leaves it out. A list of `SmsSignupWidgetSmsSignupFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. **SmsSignupWidgetSmsSignupFontOverridesItem** **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. **Sometimes sent:** `undefined` when the site leaves it out. Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. **Sometimes sent:** `undefined` when the site leaves it out. A list of `SmsSignupWidgetSmsSignupFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. **SmsSignupWidgetSmsSignupFontOverridesItemUploadsItem** **Always sent.** File attachment reference. **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Style. One of `normal`, `italic`; a newer site may send others, so keep a fallback. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`; a newer site may send others, so keep a fallback. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **Sometimes sent:** `undefined` when the site leaves it out. The visible button text. Leave empty to hide the button. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Button size. One of `small`, `normal`, `large`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Corner radius. One of `pill`, `rounded`, `slight`, `square`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The text/icon color. Clear it to derive from the button color (readable on solid fills). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme label color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Drives the hover treatment. Leave empty to derive it from the button color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme hover color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme shadow color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Hover motion. One of `lift`, `scale`, `lift-scale`, `none`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. The icon slides toward its side on hover (e.g. an arrow edges outward). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **FormRenderWidget** A `form-render` widget: its `type` and its own fields. A field left out takes its default. **Always sent.** The widget’s type: always `form-render`. One of `form-render`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. **Sometimes sent:** `undefined` when the site leaves it out. Always `widget`. One of `widget`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. The form to show here. Build and edit the form itself in the Forms manager (create one there first if needed). The related `@apostrophecms/form` documents, in order (empty when none). To set it, send a list of `{ "_id": "…" }`, one per document (one at most); a document the site can’t find is left out. At most 1 items. **Sometimes sent:** `undefined` when the site leaves it out. Off: the form renders with the styling saved on the form itself. On: the styling below replaces it here only — the form’s fields and other placements are unaffected. **Sometimes sent:** `undefined` when the site leaves it out. A list of `FormRenderWidgetFormFontOverridesItem`. Optional. Set part of this form in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. **FormRenderWidgetFormFontOverridesItem** **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. **Sometimes sent:** `undefined` when the site leaves it out. Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. **Sometimes sent:** `undefined` when the site leaves it out. A list of `FormRenderWidgetFormFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. **FormRenderWidgetFormFontOverridesItemUploadsItem** **Always sent.** File attachment reference. **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Style. One of `normal`, `italic`; a newer site may send others, so keep a fallback. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`; a newer site may send others, so keep a fallback. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **Sometimes sent:** `undefined` when the site leaves it out. Show eyebrow. **Sometimes sent:** `undefined` when the site leaves it out. Small label shown above the title. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Overrides the eyebrow + its dash. Leave empty to use the secondary (mint) color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color, then the mint default. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Eyebrow weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Eyebrow size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Heading. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to track the theme text color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Size. One of `small`, `normal`, `large`, `xlarge`, `xxlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Optional short sentence under the heading. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to use the muted text color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Size. One of `small`, `normal`, `large`, `xlarge`, `xxlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Plain sits on the page; Raised is a contained card; Accent is a solid brand-color band. One of `plain`, `raised`, `accent`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The accent band color. Leave empty to use the site accent color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color, then the accent. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Alignment of the section header (the form fields stay left-aligned for legibility). One of `center`, `left`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Content width. One of `narrow`, `normal`, `wide`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Vertical space between each field’s label and its input. One of `compact`, `normal`, `roomy`, `spacious`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The section’s full-width background band in dark mode. Transparent lets the page background show through. The palette options track the site colors; choose “Custom color…” for a specific color. One of `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Used when “Section background (dark theme)” is set to Custom color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. “Match dark theme” reuses the dark-theme choice; otherwise set the light-mode band independently. One of `inherit`, `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Used when “Section background (light theme)” is set to Custom color. **Sometimes sent:** `undefined` when the site leaves it out. The visible button text. Leave empty to hide the button. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Button size. One of `small`, `normal`, `large`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Corner radius. One of `pill`, `rounded`, `slight`, `square`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The text/icon color. Clear it to derive from the button color (readable on solid fills). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme label color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Drives the hover treatment. Leave empty to derive it from the button color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme hover color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme shadow color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Hover motion. One of `lift`, `scale`, `lift-scale`, `none`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. The icon slides toward its side on hover (e.g. an arrow edges outward). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **FinalCtaWidget** A `final-cta` widget: its `type` and its own fields. A field left out takes its default. **Always sent.** The widget’s type: always `final-cta`. One of `final-cta`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. **Sometimes sent:** `undefined` when the site leaves it out. Always `widget`. One of `widget`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Content alignment. One of `center`, `left`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Show eyebrow / kicker. **Sometimes sent:** `undefined` when the site leaves it out. Small label shown above the title. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Overrides the eyebrow + its dash. Leave empty to use the secondary (mint) color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color, then the mint default. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Eyebrow weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Eyebrow size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. An optional Font Awesome icon above the headline. One of `none`, `top`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to use the design’s own color rhythm. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Icon animation. One of `none`, `fa-beat`, `fa-bounce`, `fa-fade`, `fa-beat-fade`, `fa-flip`, `fa-shake`, `fa-spin`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Relative to the component’s base icon size. One of `default`, `sm`, `lg`, `xl`, `2xl`, `2x`, `3x`, `4x`, `5x`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A slight rotation for a more playful look. One of `none`, `left`, `right`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Headline. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Overrides the headline color. Leave empty for the on-accent (legible-on-band) default. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color, then the on-accent default. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Headline weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Supporting copy. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Overrides the supporting-copy color. Leave empty for the softened on-accent default. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color, then the softened on-accent default. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Body weight. One of `normal`, `medium`, `semibold`, `bold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid keeps the loud color block; Image places a photo behind the text with a readability overlay. One of `solid`, `image`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The solid band color (and the fallback behind a background image). Leave empty to use the site accent color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color, then the accent. **Sometimes sent:** `undefined` when the site leaves it out. An `ImageArea`. Widgets, top to bottom: send `{ "items": [ … ] }`, one object per widget with its `type`. Writing it replaces the whole area. Its fields are listed under the first `ImageArea` above. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Scrim over the image to keep the text readable. Leave empty to use the accent color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme overlay, then the accent. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Overlay opacity (%). 0 to 100. **Sometimes sent:** `undefined` when the site leaves it out. The two large outlined circles on the band. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Drawn at a low opacity. Leave empty to use the on-accent (white-ish) default. **Sometimes sent:** `undefined` when the site leaves it out. A list of `FinalCtaWidgetCtaFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. **FinalCtaWidgetCtaFontOverridesItem** **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. **Sometimes sent:** `undefined` when the site leaves it out. Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. **Sometimes sent:** `undefined` when the site leaves it out. A list of `FinalCtaWidgetCtaFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. **FinalCtaWidgetCtaFontOverridesItemUploadsItem** **Always sent.** File attachment reference. **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Style. One of `normal`, `italic`; a newer site may send others, so keep a fallback. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`; a newer site may send others, so keep a fallback. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **Sometimes sent:** `undefined` when the site leaves it out. The visible button text. Leave empty to hide the button. **Sometimes sent:** `undefined` when the site leaves it out. Where the button goes — a path (/blog) or full URL. **Sometimes sent:** `undefined` when the site leaves it out. Opens the link in a new browser tab (adds rel="noopener noreferrer"). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Button size. One of `small`, `normal`, `large`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Corner radius. One of `pill`, `rounded`, `slight`, `square`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The text/icon color. Clear it to derive from the button color (readable on solid fills). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme label color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Drives the hover treatment. Leave empty to derive it from the button color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme hover color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme shadow color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Hover motion. One of `lift`, `scale`, `lift-scale`, `none`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. The icon slides toward its side on hover (e.g. an arrow edges outward). **Sometimes sent:** `undefined` when the site leaves it out. The visible button text. Leave empty to hide the button. **Sometimes sent:** `undefined` when the site leaves it out. Where the button goes — a path (/blog) or full URL. **Sometimes sent:** `undefined` when the site leaves it out. Opens the link in a new browser tab (adds rel="noopener noreferrer"). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Button size. One of `small`, `normal`, `large`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Corner radius. One of `pill`, `rounded`, `slight`, `square`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The text/icon color. Clear it to derive from the button color (readable on solid fills). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme label color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Drives the hover treatment. Leave empty to derive it from the button color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme hover color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme shadow color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Hover motion. One of `lift`, `scale`, `lift-scale`, `none`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. The icon slides toward its side on hover (e.g. an arrow edges outward). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to use the design’s own color rhythm. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Icon animation. One of `none`, `fa-beat`, `fa-bounce`, `fa-fade`, `fa-beat-fade`, `fa-flip`, `fa-shake`, `fa-spin`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Relative to the component’s base icon size. One of `default`, `sm`, `lg`, `xl`, `2xl`, `2x`, `3x`, `4x`, `5x`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Shown under the icon while this page has no content. Leave empty for a tasteful default line. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Color of the "← back" link at the top of every post. Leave empty to use the site accent color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color, then the accent. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Back link weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Back link size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. A `SectionsArea`. Widgets, top to bottom: send `{ "items": [ … ] }`, one object per widget with its `type`. Writing it replaces the whole area. A new document starts with `page-header`. Its fields are listed under the first `SectionsArea` above. **Sometimes sent:** `undefined` when the site leaves it out. A `BlogListArea`. Widgets, top to bottom: send `{ "items": [ … ] }`, one object per widget with its `type`. Writing it replaces the whole area. A new document starts with `blog-list`. **BlogListArea** **Sometimes sent:** `undefined` when the site leaves it out. Always `area`. One of `area`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. The area’s id, set by the site: leave it out when you write one. **Sometimes sent:** `undefined` when the site leaves it out. A list of `BlogListWidget`. The widgets, top to bottom. Each is an object with its `type` and that widget’s own fields; `_id` and `metaType` may be left out (the site sets them). At most 1 items. **BlogListWidget** A `blog-list` widget: its `type` and its own fields. A field left out takes its default. **Always sent.** The widget’s type: always `blog-list`. One of `blog-list`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. The widget’s id, unique on the page. Leave it out for a new widget (the site sets one); keep it to change a widget that is there. **Sometimes sent:** `undefined` when the site leaves it out. Always `widget`. One of `widget`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How posts are arranged. One of `card`, `list`, `compact`, `featured`, `masonry`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Applies to the Card grid and Masonry layouts. One of `auto`, `2`, `3`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How posts animate in as they scroll into view. Only plays when site animations are on (Site design → Motion) — otherwise the posts are simply shown. In the Featured + grid layout the banner rises first, then the grid staggers in. One of `stagger`, `none`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Aspect ratio of the featured image. Choose “Hidden” for text-only cards. One of `16/10`, `4/3`, `3/2`, `1/1`, `none`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Image hover. One of `zoom`, `none`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Use the featured image as the full card background, with the title and meta overlaid on a dark scrim. Posts with no image fall back to a normal card. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The card surface. Raised is a quiet lit card; Luxe a frosted glass panel; Outline a plaque frame; Spine adds a color rail; Tint an accent wash; Ticket/Bracket/Forge/Press/Inlay are the graphic showstoppers. (On image-led cards the photo covers the top edge.) One of `raised`, `luxe`, `outline`, `plain`, `poster`, `edge`, `tint`, `ticket`, `bracket`, `forge`, `press`, `inlay`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Corner rounding for each card. Default keeps the widget’s own tuned corners — except Forge, which defaults to tight machined corners matching its engraved frame. One of `default`, `square`, `slight`, `rounded`, `large`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Colors the Spine rail, Bracket marks, Forge corner/frame and Press margin rule. Leave empty to use the brand accent. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where the Forge plate wears its color: a single corner mark (the machinist’s datum, default) or the whole engraved frame. One of `corner`, `frame`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Thickness of the Forge corner mark / colored frame. One of `fine`, `medium`, `bold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. What a card does on hover. Lift/Pop/Press/Glow/Outline are instant; Sheen sweeps a light across; Tilt (3-D + glare), Magnetic and Spotlight follow the cursor (need site animations on). The Hover color below tints these. One of `none`, `lift`, `pop`, `press`, `glow`, `border`, `sheen`, `tilt`, `magnetic`, `spotlight`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Border / shadow / glow color on hover. Leave empty to use the site accent color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color, then the accent. **Sometimes sent:** `undefined` when the site leaves it out. Show category. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How the category badge uses its color (set per category under Blog Categories). Filled = colored background; Outline = colored border + text; Minimal = colored text only. One of `filled`, `outline`, `minimal`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Show date. **Sometimes sent:** `undefined` when the site leaves it out. Show excerpt. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. How many lines of the excerpt to show before truncating. One of `2`, `3`, `4`, `none`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Show author. **Sometimes sent:** `undefined` when the site leaves it out. Show “Read post” link. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Auto puts it on the right of horizontal cards (list / compact / featured) and below the text on grid cards. Or force one placement everywhere. One of `auto`, `below`, `right`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Overrides the “Read post” link color. Leave empty to use the site accent color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color, then the accent. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Color of the “Read post” link when the card is hovered. Leave empty to use the accent color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme hover color, then the accent. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Overrides the card title color. Leave empty to track the theme’s text color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color, then the theme default. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Title weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Title color when the card is hovered. Leave empty to use the site accent color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme hover color, then the accent. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Overrides the excerpt text color. Leave empty for the muted default. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color, then the muted default. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Excerpt weight. One of `normal`, `medium`, `semibold`, `bold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Date / meta line color. Leave empty for the faint default. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color, then the faint default. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The section’s full-width background band in dark mode. Transparent lets the page background show through. The palette options track the site colors; choose “Custom color…” for a specific color. One of `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Used when “Section background (dark theme)” is set to Custom color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. “Match dark theme” reuses the dark-theme choice; otherwise set the light-mode band independently. One of `inherit`, `transparent`, `surface`, `raised`, `sunken`, `hill`, `accent-soft`, `custom`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Used when “Section background (light theme)” is set to Custom color. **Sometimes sent:** `undefined` when the site leaves it out. A list of `BlogListWidgetBlogFontOverridesItem`. Optional. Set part of this section in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). At most 4 items. **BlogListWidgetBlogFontOverridesItem** **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. **Sometimes sent:** `undefined` when the site leaves it out. Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. **Sometimes sent:** `undefined` when the site leaves it out. A list of `BlogListWidgetBlogFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. **BlogListWidgetBlogFontOverridesItemUploadsItem** **Always sent.** File attachment reference. **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Style. One of `normal`, `italic`; a newer site may send others, so keep a fallback. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`; a newer site may send others, so keep a fallback. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A `CustomCSS`. CSS for this one section, typed into the slot of the part it styles. It wins over Site design → Custom CSS. Nested rules like &:hover, @media (width >= 48rem) and \[data-theme="light"] & work inside a slot. Its fields are listed under the first `CustomCSS` above. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **Sometimes sent:** `undefined` when the site leaves it out. A `SectionsArea`. Widgets, top to bottom: send `{ "items": [ … ] }`, one object per widget with its `type`. Writing it replaces the whole area. Its fields are listed under the first `SectionsArea` above. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The visible button text. Leave empty to hide the button. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Button size. One of `small`, `normal`, `large`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Corner radius. One of `pill`, `rounded`, `slight`, `square`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The text/icon color. Clear it to derive from the button color (readable on solid fills). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme label color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Drives the hover treatment. Leave empty to derive it from the button color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme hover color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme shadow color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Hover motion. One of `lift`, `scale`, `lift-scale`, `none`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The icon slides toward its side on hover (e.g. an arrow edges outward). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A list of `PagePostFontOverridesItem`. Optional. Set part of every post in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). An individual post can replace this on its own Fonts tab. At most 4 items. **PagePostFontOverridesItem** **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which text this typeface replaces. Rows apply in order, so a broad row (Everything) followed by a narrow one (Headings) gives the section a base face plus an exception. One of `all`, `heading`, `body`, `eyebrow`, `button`, `code`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where the typeface comes from. The first option costs nothing extra — those faces are already loaded. The others load an additional font on pages that use this section. One of `slot`, `curated`, `cdn`, `upload`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Set in Site design → Typography. Following the site’s own faces keeps a section on-brand and adds no download. One of `display`, `body`, `accent`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Vetted families from Bunny Fonts and Fontshare, with their available weights already verified. One of `archivo`, `bricolage-grotesque`, `clash-display`, `courier-prime`, `dm-mono`, `dm-sans`, `fira-code`, `fraunces`, `general-sans`, `ibm-plex-mono`, `ibm-plex-sans`, `inconsolata`, `inter`, `jetbrains-mono`, `karla`, `lora`, `manrope`, `nunito-sans`, `outfit`, `playfair-display`, `public-sans`, `red-hat-mono`, `satoshi`, `sentient`, `sora`, `source-code-pro`, `source-sans-3`, `source-serif-4`, `space-grotesk`, `space-mono`, `spline-sans-mono`, `supreme`, `switzer`, `syne`, `ubuntu-mono`, `unbounded`, `victor-mono`, `work-sans`, `zodiak`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Where to browse for the family. Pick one, then follow the link below to find the exact name. One of `bunny`, `fontshare`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. Exactly as the provider’s catalog spells it, e.g. "Space Grotesk" or "Clash Display". A name the provider doesn’t have loads nothing and this row is ignored. **Sometimes sent:** `undefined` when the site leaves it out. Comma-separated weights to load, e.g. 400, 700. Empty loads 400, 500, 700. Weights the family doesn’t ship are skipped by the CDN and synthesized by the browser (faux bold) — but a family that ships only ONE weight (Acme, for instance) loads nothing at all unless that weight is among these, so set it explicitly if the typeface doesn’t appear. **Sometimes sent:** `undefined` when the site leaves it out. A list of `PagePostFontOverridesItemUploadsItem`. One file per weight/style of the SAME typeface. woff2 strongly recommended (smallest, universally supported); woff/ttf/otf also accepted. At most 4 items. **PagePostFontOverridesItemUploadsItem** **Always sent.** File attachment reference. **Sometimes sent:** `undefined` when the site leaves it out. The row’s id, unique in its array. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Weight. One of `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Style. One of `normal`, `italic`; a newer site may send others, so keep a fallback. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Generic system font shown while this typeface loads (and if it fails). Curated picks set this automatically. One of `sans`, `serif`, `mono`; a newer site may send others, so keep a fallback. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Body text size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Body text weight. One of `normal`, `medium`, `semibold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Reading measure — how wide the article column gets. Posts that contain section widgets open to Full width automatically so the widgets have room. One of `narrow`, `normal`, `wide`, `xwide`, `full`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Line height. One of `tight`, `normal`, `relaxed`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Links, the blockquote rule, and heading accents. Leave empty to use the site link color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color, then the link color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Heading weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Overrides in-article heading color. Leave empty to track the theme’s text color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color, then the theme default. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A `PostCustomCSS`. CSS for every blog post’s page: the title band, the article and its parts. It wins over Site design → Custom CSS → Blog post. **PostCustomCSS** **Sometimes sent:** `undefined` when the site leaves it out. The CSS typed into each part slot, by slot name. **Sometimes sent:** `undefined` when the site leaves it out. The compiled CSS (read only: rebuilt from `slots`). **Sometimes sent:** `undefined` when the site leaves it out. The site’s check mark for `css` (read only). **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A list of `Page`. Its child pages, each with its own `_children` where the request asked for more levels. Its fields are listed under the first `Page` above. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Full URL to the page. Format: an absolute URL. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Whether current user can edit this page. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Whether current user can publish this page. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The `_id` of the piece/page that was copied to create this document (only present if created via `_copyingId`) **Sometimes sent:** `undefined` when the site leaves it out. A `Page`. A page: the fields every page has, and each page type’s own (`type` says which page type it is; a field belongs only to the page types that define it). Its fields are listed under the first `Page` above. **Sometimes sent:** `undefined` when the site leaves it out. A `Page`. A page: the fields every page has, and each page type’s own (`type` says which page type it is; a field belongs only to the page types that define it). Its fields are listed under the first `Page` above. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The draft’s preview share key, while its share link is on: the link is the draft’s `_url` with `aposShareKey` and `aposShareId` (the draft’s `_id`) in its query. Absent otherwise, and on published documents. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. An ISO 8601 date and time, e.g. `2026-10-21T14:30:00.000Z`. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. An ISO 8601 date and time, e.g. `2026-10-21T14:30:00.000Z`. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Overrides the document title in the browser tab and search results. Leave blank to use the regular title. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Shown in search results and link previews. Aim for 150–160 characters. **Sometimes sent:** `undefined` when the site leaves it out. An `ImageArea`. Used for Open Graph / social link previews. Recommended 1200×630. Widgets, top to bottom: send `{ "items": [ … ] }`, one object per widget with its `type`. Writing it replaces the whole area. Its fields are listed under the first `ImageArea` above. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A list of `PagePageFontOverridesItem`. Optional. Set part of this page in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). Individual sections can still override this for themselves. At most 4 items. Its fields are listed under the first `PagePageFontOverridesItem` above. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The ribbon of phrases scrolling across the top of the footer. Its phrases and the site-wide default are set in Site design → Footer: Marquee. One of `inherit`, `on`, `off`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. A `SectionsArea`. Widgets, top to bottom: send `{ "items": [ … ] }`, one object per widget with its `type`. Writing it replaces the whole area. A new document starts with `page-header`. Its fields are listed under the first `SectionsArea` above. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional — leave empty to use the design’s own color rhythm. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Icon animation. One of `none`, `fa-beat`, `fa-bounce`, `fa-fade`, `fa-beat-fade`, `fa-flip`, `fa-shake`, `fa-spin`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Relative to the component’s base icon size. One of `default`, `sm`, `lg`, `xl`, `2xl`, `2x`, `3x`, `4x`, `5x`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Shown under the icon while this page has no content. Leave empty for a tasteful default line. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Color of the "← back" link at the top of every post. Leave empty to use the site accent color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color, then the accent. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Back link weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Back link size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out. A `SectionsArea`. Widgets, top to bottom: send `{ "items": [ … ] }`, one object per widget with its `type`. Writing it replaces the whole area. A new document starts with `page-header`. Its fields are listed under the first `SectionsArea` above. **Sometimes sent:** `undefined` when the site leaves it out. A `BlogListArea`. Widgets, top to bottom: send `{ "items": [ … ] }`, one object per widget with its `type`. Writing it replaces the whole area. A new document starts with `blog-list`. Its fields are listed under the first `BlogListArea` above. **Sometimes sent:** `undefined` when the site leaves it out. A `SectionsArea`. Widgets, top to bottom: send `{ "items": [ … ] }`, one object per widget with its `type`. Writing it replaces the whole area. Its fields are listed under the first `SectionsArea` above. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The visible button text. Leave empty to hide the button. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fills with the color; Outline / Soft / Text link use it for the border + text. One of `solid`, `outline`, `soft`, `link`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Button size. One of `small`, `normal`, `large`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Corner radius. One of `pill`, `rounded`, `slight`, `square`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Solid fill, or the border + text for the other styles. Defaults to the brand accent; CLEAR it for a transparent, outline-only button. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color. (Brand tokens already flip per theme.) **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The text/icon color. Clear it to derive from the button color (readable on solid fills). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme label color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Drives the hover treatment. Leave empty to derive it from the button color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme hover color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The hover treatment: a soft shadow, a colored offset shadow, a glow, a fill sweep, or a thicker border. One of `none`, `single`, `dual`, `glow`, `sweep`, `thicken`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. The offset-shadow or glow color on hover. Leave empty to use the site secondary color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme shadow color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Hover motion. One of `lift`, `scale`, `lift-scale`, `none`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Any Font Awesome icon name, e.g. star, bolt, arrow-left-to-bracket (no “fa-” prefix). Browse at fontawesome.com/icons. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Icon family. One of `classic-regular`, `duotone-regular`, `brands`, `jelly`, `jelly-duo`, `whiteboard`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Which side of the label the icon sits on (when an icon name is set). One of `before`, `after`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. The icon slides toward its side on hover (e.g. an arrow edges outward). **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A list of `PagePostFontOverridesItem`. Optional. Set part of every post in a different typeface. Leave empty to follow the site’s fonts (Site design → Typography). An individual post can replace this on its own Fonts tab. At most 4 items. Its fields are listed under the first `PagePostFontOverridesItem` above. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Body text size. One of `small`, `normal`, `large`, `xlarge`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Body text weight. One of `normal`, `medium`, `semibold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Reading measure — how wide the article column gets. Posts that contain section widgets open to Full width automatically so the widgets have room. One of `narrow`, `normal`, `wide`, `xwide`, `full`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Line height. One of `tight`, `normal`, `relaxed`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Links, the blockquote rule, and heading accents. Leave empty to use the site link color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color, then the link color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Heading weight. One of `normal`, `medium`, `semibold`, `bold`, `extrabold`; a newer site may send others, so keep a fallback. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional. Overrides in-article heading color. Leave empty to track the theme’s text color. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. Optional light-theme override. Falls back to the dark-theme color, then the theme default. **Sometimes sent:** `undefined` when the site leaves it out, and it can be `null`. A `PostCustomCSS`. CSS for every blog post’s page: the title band, the article and its parts. It wins over Site design → Custom CSS → Blog post. Its fields are listed under the first `PostCustomCSS` above. **Always there:** `{}` when there are none. Any keys the site sent that aren’t listed above (such as one added after this SDK was built), by their wire names, as sent. Pass this model to a write and they are sent too. Nothing to catch: the SDK retries what is safe, and throws the rest as the classes below; catch only what you want to react to (see [Errors and testing](https://docs.fetchski-attract.com/typescript/errors.md)). The site refused what was sent: `errors` lists each field’s problem, `siteMessage` the first. **Retried first:** No. **Read:** `errors` (field → messages), `siteMessage`. The API key is missing or refused (malformed, revoked, expired), or a signature its signing mode needs is missing or stale. **Retried first:** No. **Read:** `siteMessage`, `errorName`, `data`. The key may not do this: a scope it lacks, or an address outside its allowlist. `siteMessage` names it. **Retried first:** No. **Read:** `siteMessage`, `errorName`, `data`. Nothing matches, or the caller may not see it. **Retried first:** No. **Read:** `siteMessage`, `errorName`, `data`. The site failed. Its logs say why. **Retried first:** No: a write may have landed. **Read:** `siteMessage`, `errorName`, `data`. No answer: DNS, a refused connection, TLS, or the timeout (15 s per attempt by default). **Retried first:** Only when nothing reached the site (`neverConnected()`); never after a timeout, when it may have landed. **Read:** `reason`, `neverConnected`. The client refused to send it (e.g. a path segment of `..`); the site never saw it. **Retried first:** No. **Read:** `reason` (what to change). Any other status, or a success whose JSON doesn’t match this SDK version’s types (update the SDK). **Retried first:** No. **Read:** `reason`, `status`. `sites.forSite('acme')` named a slug your sites (`createSiteClients()`) don’t have. **Retried first:** No: nothing was sent. **Read:** `message`, `slug`. The client’s settings are wrong: no `FETCHSKI_ATTRACT_URL` (or `baseUrl`), or a malformed API key. **Retried first:** No: nothing was sent. **Read:** `message` (what to fix). ## Behavior * **Access:** an API key with `content:pages:write` (or a master above it: `content:pages:all`, `content:all`, `admin:all`). In published mode (the default) it goes live too, so the key also needs `content:pages:publish` (or a master above it); send `aposMode=draft` (or a draft `_id` and no `aposMode`) to change only the draft. A signed-in person may call it as far as their own permissions allow; anyone else gets 403. * **Rate limit:** the key’s own writes-per-minute limit, set when the key is created (default 120); over it, 429 with `Retry-After`. The client waits and retries for you; you see `RateLimited` only if that runs out. * **Retries:** a write is sent again only after a 429 (refused before it acted) or when it never reached the site. After a timeout or a 5xx it may have landed: check before you send it again. * **Timeout:** 15 s per attempt by default; raise `timeout` (milliseconds) on the client for longer. ## Test it It calls the function above with a fake client: the fake answers every call with a valid example, so nothing leaves your machine and no settings or key are needed. Run it with `node --test`. ```ts tests/pages-replacePage.test.ts theme={"dark"} import { test } from 'node:test'; import { fakeSite } from '@fetchski/attract-cms-sdk/testing'; import { replacePage } from '../src/attract/replace-page.ts'; test('pages.replacePage', async () => { const site = fakeSite(); await replacePage(site, 'ckitdo5oq004pu69kr6oxo6fr:en:published'); site.assertCalled('pages.replacePage', (args) => args.id === 'ckitdo5oq004pu69kr6oxo6fr:en:published'); }); ``` **Answer with your own values:** fake `pages.replacePage` with `factories.Page({...})`, the fields you give over a valid example. ```ts tests/pages-replacePage-answer.test.ts theme={"dark"} import assert from 'node:assert/strict'; import { test } from 'node:test'; import { factories, fakeSite } from '@fetchski/attract-cms-sdk/testing'; test('pages.replacePage answers your values', async () => { const site = fakeSite({ 'pages.replacePage': factories.Page({ id: 'Your value' }) }); const page = await site.pages().replacePage({ id: 'ckitdo5oq004pu69kr6oxo6fr:en:published', type: 'default-page', title: 'About Us' }); assert.equal(page.id, 'Your value'); }); ``` ## Related `site.pages().listPages()` `site.pages().createPage()` `site.pages().archivePages()` `site.pages().localizePages()` `site.pages().publishPages()` `site.pages().restorePages()` The endpoint this calls, in the API reference: the HTTP request and answer, and every rule the site checks. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.