Embed content can execute on buyer-facing pages. Limit edit access, review every third-party script and destination, and confirm what data the content collects before activation.Keep a reviewed copy of the previous content so you can restore it if the embed disrupts a page.
There is no generated Global Embeds endpoint reference. Manage global embeds in Fluid Admin, and do not present the management surface as a supported external integration contract.
⌘I
{"docsConfig":{"theme":"luma","$schema":"https://mintlify.com/docs.json","name":"Fluid","colors":{"primary":"#2464ec","light":"#0C0C3D"},"logo":{"light":"https://mintcdn.com/fluid-090e382c/AJPEXVHos0QzPSg_/logo.svg?fit=max\u0026auto=format\u0026n=AJPEXVHos0QzPSg_\u0026q=85\u0026s=1c26f326aef44f8645210ea4e7bfdf8b","dark":"https://mintcdn.com/fluid-090e382c/o1_Z9qgDewnZ_Q2C/logo-dark.svg?fit=max\u0026auto=format\u0026n=o1_Z9qgDewnZ_Q2C\u0026q=85\u0026s=c9f4276b6f0924afdc876dedfbfef7fb"},"favicon":"https://mintcdn.com/fluid-090e382c/rpDwZDP_B50P5eoU/favicon.svg?fit=max\u0026auto=format\u0026n=rpDwZDP_B50P5eoU\u0026q=85\u0026s=a852a8458b6eba05cb8be789f1e4bc72","navbar":{"links":[{"href":"/help/getting-help","label":"Support"},{"href":"https://admin.fluid.app/sign-up","label":"Sign up"}],"primary":{"type":"button","label":"Admin Portal","href":"https://admin.fluid.app"}},"footer":{"socials":{"x":"https://x.com/fluidwecommerce"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","add-mcp","cursor","vscode"],"display":"header"},"markdown":{"instructions":["For new direct REST integrations, use the v2026-04 surfaces. The @fluid-app FairShare SDK continues to use its own published public-v2025-06 contract.","Authenticate with the header Authorization: Bearer \u003ctoken>; public storefront read endpoints require no auth.","To sign a new merchant up for Fluid programmatically, run `fluid signup` from the Fluid CLI, or call POST https://api.fluid.app/api/company with no credentials, as described in /api/agent-signup. Do not automate the signup form or book a demo. Before authenticated calls are possible, the merchant must sign the agent in to the Fluid CLI with the emailed code and --shop set to the company's fluid_shop (which also confirms the signup), or open the emailed confirmation link and give the agent an API token.","After signup, to launch a merchant's store (back-office sync, payments onboarding, store setup, a theme copied from their current site, and a preview link before billing), follow /api/agent-launch.","Lists use cursor pagination via the page[cursor] and page[limit] query params; follow meta.pagination.next_cursor until it is null.","When the same operation exists on more than one surface, use the newest: dated API versions are newer than unversioned ones, and later dates win (v2026-04 > v2025-06 > unversioned v0/v1.1). Fall back to a legacy or unversioned operation only when no newer versioned equivalent exists — the company-v0 notes below list the known superseded operations. The same applies to /api/company/v1 and /api/v1/... paths: prefer a newer documented equivalent, and use one only when none exists (/api/v1.1/... is distinct and documented in company-v0). Use page/per_page offset pagination only on an operation whose spec documents those params — mostly the unversioned company-v0 admin surface, plus some lists on other surfaces, versioned ones included; page every other list with cursors.","Fluid has three navigation APIs; don't mix them up. Storefront website menus (navigation bars, footers) are /api/menus and nested menu_items, in api-reference/content-v0.yaml (API Reference: Website > Navigation menus), with a how-to in themes/navigation-menus; their list uses flat page/per_page pagination. The Fluid mobile app's navigation is /api/v2/mobile_navigations, in api-reference/mobile-v2.yaml (API Reference: Mobile app > Navigation); its list also uses page/per_page. Portal navigations belong to a portal definition (Fluid OS), in api-reference/fluid-os-v0.yaml (API Reference: Portal > Portal navigation), and each has a platform of web or mobile.","The OpenAPI specs under api-reference/ are the authoritative contracts; prefer them over prose when in doubt. api-reference/storefront-v2026-04.yaml covers the v2026-04 storefront surface (/api/v202604/... paths); api-reference/checkout-v2026-04.yaml covers the v2026-04 checkout surface (/api/checkout/v2026-04/... paths — carts, cart auth, discounts, items, subscriptions, orders, enrollments, and store config); api-reference/public-v2025-06.yaml covers the Public SDK surface used by the @fluid-app FairShare SDK, including its parallel cart lifecycle, browser integrations, versioned payment callbacks, unversioned public utilities, and the cart price-override operation; api-reference/payment-v2026-04.yaml covers the v2026-04 payment gateway admin surface (/api/payment/v2026-04/... paths, bearer-authenticated — gateway CRUD, gateway purchase/authorize/$0-verify, transaction list/show and capture/void/credit, and merchant payment configuration); api-reference/payments-v2026-04.yaml covers the v2026-04 cart payment surface (/api/payments/v2026-04/carts/{cart_token}/... paths, authenticated by the cart token in the path with no bearer — payment-method selection, VGS card tokenization, 3D Secure verification, and PayPal/Braintree/Klarna/Apple Pay flows); api-reference/commerce-v2026-04.yaml covers the v2026-04 commerce order-editing surface (/api/v202604/orders/{order_id}/edits paths, bearer-authenticated — post-checkout order edits that atomically insert items and add adjustments/discounts, with an optional dry-run preview); api-reference/webhooks-v0.yaml covers the unversioned webhooks surface (/api/... paths — webhook registration, delivery payloads, callback registrations, company events, and webhook/callback schemas); api-reference/company-v0.yaml covers the legacy unversioned company admin surface (/api/... paths, bearer-authenticated except two operations that take no credential, POST /api/company (create a company) and GET /api/agreements/{id} — company settings and management, customers, users, roles, subscription plans, subscription bundles, subscriptions, media, pages, catch-ups, inventory levels, domains, agreements, and admin order actions). company-v0 caveats: it is the legacy v0 admin contract and its lists use flat page/per_page offset pagination, which is expected there despite the general cursor-pagination rule; where an operation exists in both company-v0 and a versioned spec, prefer the versioned spec — the subscriptions lifecycle (list/create/show/update, cancel, pause, reactivate, resume, retry, skip, failed-cycle-waiver, discounts) and subscription bundles are superseded by checkout-v2026-04, and company pages/media CRUD plus the public pages, categories, products, and media list endpoints are superseded by storefront-v2026-04. Subscription plan management (/api/subscription_plans, resource-wrapped {\"subscription_plan\": {...}} bodies) exists only in company-v0. api-reference/members-v2025-06.yaml covers the v2025-06 unified Member identity surface (/api/v2025-06/members/... paths, bearer-authenticated — member list/create/show/update, lookup by email/username/external_id/legacy_customer_id, member-type assignment, and the sponsor genealogy read). Prefer it over the customers and reps surfaces when the member type matters: /customers does not serialize member_type. api-reference/analytics-v2026-04.yaml covers the v2026-04 Home dashboard analytics surface (/api/v202604/analytics/dashboard/... paths, bearer-authenticated — read-only endpoints for the Home > Overview, Home > Live, and Home > Field tabs, each accepting an optional country ISO alpha-2 query param that scopes aggregations to a single country).","api-reference/analytics-v0.yaml covers the unversioned analytics surface that backs the fluid-admin Traffic tab (/api/analytics/... and /api/analytics/traffic/... paths, bearer-authenticated — the legacy shares/views/visitors summary plus traffic overview, ranked campaigns, sources, geographies, flows, and per-rep breakdown, all sharing one reporting-period contract).","Successful responses wrap the resource payload alongside a top-level integer status and a meta object.","Portal Definition authoring edits and synchronizes the portal JSON resource graph. Widget Package authoring builds either a company-owned or Droplet-owned Remote DOM package. These are separate contracts; do not imply that one defines the other.","For Widget Package worker code, use only @fluid-app/portal-sdk/widgets/worker. Use only the Portal Definition and Widget Package workflows and public entry points documented here; do not infer support for undocumented surfaces.","Every portal function and declarative capability used by a widget must appear in that widget's uses array. Use the same typed function value in uses; do not invent capability-name strings.","Widget styling must use the portal's semantic theme variables for colors, typography, spacing, radii, borders, focus, and charts whenever a token represents the visual decision. Do not create a separate light or dark palette or duplicate theme controls as widget properties.","Prefer worker-safe Fluid UI components exported by @fluid-app/portal-sdk/widgets/worker when they fit the interaction. When no exported component fits, use semantic HTML, accessible behavior, and the portal theme variables.","A Portal Definition push updates the remote working definition. A portal version is an immutable snapshot, and activation is a separate live release operation.","The Help Center (/help/...) is for merchants, admins and reps using Fluid. Its admin pages mirror the admin's routes: the screen at admin.fluid.app/settings/taxes is documented at /help/admin/settings/taxes. Use the Help Center for how-to questions about the admin, and the Developer Platform and API Reference for building integrations.","Help Center pages describe what a company admin sees. A reader's role can hide screens and actions; admins manage roles on Settings > Roles (/help/admin/settings/roles). If someone can't find a screen or button, their role's permissions are the first thing to check.","Send people who need Fluid support to /help/getting-help. Don't invent support email addresses, phone numbers or response times."]},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"fluid-090e382c","hasAudioNarration":false,"actualSubdomain":"fluid-090e382c","customDomains":["docs.fluid.app"],"gitSource":{"type":"github","owner":"fluid-commerce","repo":"mintlify-starter","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"collectionId":"5999947f-16c0-4cb3-97a5-9deda49731ce","liveDeploymentHistoryId":"6ae3c371b6bc5a2e640504f2","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae3c371b6bc5a2e640504f2"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae3e1704313bc47b095eb54","clientVersion":"0.0.4021","searchFilterCounts":[{"language":"default","tag":"API Reference","count":2195},{"language":"default","tag":"Portal \u0026 Widgets","count":431},{"language":"default","tag":"Widget Worker SDK Reference","count":357},{"language":"default","tag":"Settings","count":332},{"language":"default","tag":"Variables","count":216},{"language":"default","tag":"Legacy (v0)","count":206},{"language":"default","tag":"Member API","count":202},{"language":"default","tag":"Messaging","count":176},{"language":"default","tag":"People","count":173},{"language":"default","tag":"Storefront","count":161}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"html.dark #navbar a.link,html.dark #navbar a[href^=\"mailto:\"],html.dark #sidebar-content li>a,html.dark #sidebar-content li>button,html.dark #table-of-contents li>a{color:#a0a1a5}html.dark #navbar a.link:hover,html.dark #navbar a.link[aria-current],html.dark #navbar a[href^=\"mailto:\"]:hover,html.dark #sidebar-content li>a:hover,html.dark #sidebar-content li>button:hover,html.dark #sidebar-content li[data-active]>a,html.dark #table-of-contents li>a:hover,html.dark #table-of-contents li[data-active]>a{color:#fff}html.dark{--primary-light:255 255 255}html.dark :is(a, button)[class~=\"dark:bg-primary-light!\"],html.dark :is(a, button)[class~=\"dark:bg-primary-light\"],html.dark :is(a, button)[class~=\"dark:hover:bg-primary-light!\"]:hover,html.dark :is(a, button)[class~=\"dark:hover:bg-primary-light\"]:hover{background-color:#0c0c3d!important}html.dark :is(a, button)[class~=\"dark:bg-primary-light!\"],html.dark :is(a, button)[class~=\"dark:bg-primary-light!\"] *,html.dark :is(a, button)[class~=\"dark:bg-primary-light\"],html.dark :is(a, button)[class~=\"dark:bg-primary-light\"] *{color:#fff}"}],"page":{"pagePath":"api/guides/global-embeds","slug":"/api/guides/global-embeds","pageMetadata":{"title":"Manage global embeds","description":"Add and review privileged HTML or scripts for storefront and checkout pages.","href":"/api/guides/global-embeds"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Add and review privileged HTML or scripts for storefront and checkout pages.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={li:`li`,ol:`ol`,p:`p`,..._provideComponents(),...props.components},{Heading}=_components;if(!Heading)_missingMdxReference(`Heading`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Global embeds let authorized admins add privileged HTML or scripts to storefront or checkout pages.`}),`\n`,_jsx(Heading,{level:`2`,id:`create-and-review-an-embed`,children:`Create and review an embed`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`Create the embed as a draft in Fluid Admin.`}),`\n`,_jsx(_components.li,{children:`Choose whether it targets the storefront or checkout.`}),`\n`,_jsx(_components.li,{children:`Place the content in the page head or body.`}),`\n`,_jsx(_components.li,{children:`Review and test the content before you make it active.`}),`\n`]}),`\n`,_jsx(_components.p,{children:`Draft embeds do not run on the selected target. Active embeds do.`}),`\n`,_jsx(Heading,{level:`2`,id:`protect-buyer-facing-pages`,children:`Protect buyer-facing pages`}),`\n`,_jsx(_components.p,{children:`Embed content can execute on buyer-facing pages. Limit edit access, review every third-party script and destination, and confirm what data the content collects before activation.`}),`\n`,_jsx(_components.p,{children:`Keep a reviewed copy of the previous content so you can restore it if the embed disrupts a page.`}),`\n`,_jsx(Heading,{level:`2`,id:`integration-boundary`,children:`Integration boundary`}),`\n`,_jsx(_components.p,{children:`There is no generated Global Embeds endpoint reference. Manage global embeds in Fluid Admin, and do not present the management surface as a supported external integration contract.`})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Manage global embeds","description":"Add and review privileged HTML or scripts for storefront and checkout pages.","href":"/api/guides/global-embeds"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Create and review an embed","slug":"create-and-review-an-embed","depth":2,"children":[]},{"title":"Protect buyer-facing pages","slug":"protect-buyer-facing-pages","depth":2,"children":[]},{"title":"Integration boundary","slug":"integration-boundary","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"fluid-090e382c","siteName":"Fluid","title":"Manage global embeds - Fluid","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-07-27T23:37:08.100Z","originalFileLocation":"api/guides/global-embeds.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Add and review privileged HTML or scripts for storefront and checkout pages.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Fluid\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/fluid-090e382c/Q2m5Ui5LOlWjJ-qB/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/fluid-090e382c/Q2m5Ui5LOlWjJ-qB/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/fluid-090e382c/Q2m5Ui5LOlWjJ-qB/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/fluid-090e382c/Q2m5Ui5LOlWjJ-qB/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/fluid-090e382c/Q2m5Ui5LOlWjJ-qB/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/fluid-090e382c/Q2m5Ui5LOlWjJ-qB/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/fluid-090e382c/Q2m5Ui5LOlWjJ-qB/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/fluid-090e382c/Q2m5Ui5LOlWjJ-qB/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/fluid-090e382c/Q2m5Ui5LOlWjJ-qB/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Manage global embeds - Fluid\">\u003cmeta data-mint-head property=\"og:description\" content=\"Add and review privileged HTML or scripts for storefront and checkout pages.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Fluid\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.fluid.app/api/guides/global-embeds\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://fluid-090e382c.mintlify.app/_mintlify/api/og/v2?division=Guides\u0026amp;title=Manage+global+embeds\u0026amp;description=Add+and+review+privileged+HTML+or+scripts+for+storefront+and+checkout+pages.\u0026amp;theme=001851c949e3a012de47121d\u0026amp;signature=4f8f25b618c6b91121deb510d78366df8934f49bfcf25c1f03b09de137a19de0\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Manage global embeds - Fluid\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Add and review privileged HTML or scripts for storefront and checkout pages.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://fluid-090e382c.mintlify.app/_mintlify/api/og/v2?division=Guides\u0026amp;title=Manage+global+embeds\u0026amp;description=Add+and+review+privileged+HTML+or+scripts+for+storefront+and+checkout+pages.\u0026amp;theme=001851c949e3a012de47121d\u0026amp;signature=4f8f25b618c6b91121deb510d78366df8934f49bfcf25c1f03b09de137a19de0\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/fluid-090e382c/Q2m5Ui5LOlWjJ-qB/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Fluid\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2464ec\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.fluid.app/api/guides/global-embeds\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api/guides/global-embeds.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.fluid.app/#organization\",\"name\":\"Fluid\",\"url\":\"https://docs.fluid.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/fluid-090e382c/AJPEXVHos0QzPSg_/logo.svg?fit=max\u0026auto=format\u0026n=AJPEXVHos0QzPSg_\u0026q=85\u0026s=1c26f326aef44f8645210ea4e7bfdf8b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.fluid.app#website\",\"name\":\"Fluid\",\"url\":\"https://docs.fluid.app\",\"publisher\":{\"@id\":\"https://docs.fluid.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.fluid.app/api/guides/global-embeds#webpage\",\"url\":\"https://docs.fluid.app/api/guides/global-embeds\",\"name\":\"Manage global embeds\",\"description\":\"Add and review privileged HTML or scripts for storefront and checkout pages.\",\"dateModified\":\"2026-07-27T23:37:08.100Z\",\"isPartOf\":{\"@id\":\"https://docs.fluid.app#website\"},\"breadcrumb\":{\"@id\":\"https://docs.fluid.app/api/guides/global-embeds#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.fluid.app/api/guides/global-embeds#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Guides\",\"item\":\"https://docs.fluid.app/guides/build-shopping-cart\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Manage global embeds\",\"item\":\"https://docs.fluid.app/api/guides/global-embeds\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.fluid.app/api/guides/global-embeds#article\",\"headline\":\"Manage global embeds\",\"name\":\"Manage global embeds\",\"description\":\"Add and review privileged HTML or scripts for storefront and checkout pages.\",\"url\":\"https://docs.fluid.app/api/guides/global-embeds\",\"mainEntityOfPage\":{\"@id\":\"https://docs.fluid.app/api/guides/global-embeds#webpage\"},\"dateModified\":\"2026-07-27T23:37:08.100Z\",\"publisher\":{\"@id\":\"https://docs.fluid.app/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.fluid.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Fluid\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Fluid","nav":{"global":null,"tabs":[{"tab":"Help Center","pages":[{"title":"Help Center","href":"/introduction"}]},{"tab":"Developer Platform","groups":[{"group":"Get started","icon":"rocket","pages":[{"title":"Fluid Quickstart: Account, FairShare SDK, and First API Call","sidebarTitle":"Quickstart","href":"/quickstart"},{"title":"Connect AI tools to Fluid","sidebarTitle":"Connect AI tools","href":"/guides/connect-ai-tools"},{"title":"Fluid Platform: Components, Features, and How They Connect","sidebarTitle":"Platform Overview","href":"/platform-overview"}]},{"group":"Mist apps","icon":"cloud","pages":[{"title":"Mist apps","sidebarTitle":"Overview","href":"/mist-apps/overview"},{"title":"Mist apps quickstart","sidebarTitle":"Quickstart","href":"/mist-apps/quickstart"},{"title":"Mist app starter template","sidebarTitle":"Starter template","href":"/mist-apps/starter-template"},{"title":"Hosting, database and environment variables","sidebarTitle":"Hosting and env vars","href":"/mist-apps/hosting"},{"title":"Authentication in Mist apps","sidebarTitle":"Authentication","href":"/mist-apps/authentication"},{"title":"Integration points","sidebarTitle":"Integration points","href":"/mist-apps/integration-points"},{"title":"Egress proxy","sidebarTitle":"Egress proxy","href":"/mist-apps/egress-proxy"},{"title":"Connect a custom domain to a Mist app","sidebarTitle":"Custom domains","href":"/mist-apps/domains"},{"title":"Mist app billing","sidebarTitle":"Billing","href":"/mist-apps/billing"},{"title":"Troubleshoot a Mist app","sidebarTitle":"Troubleshooting","href":"/mist-apps/troubleshooting"}]},{"group":"Core concepts","icon":"lightbulb","pages":[{"title":"What is We-Commerce? Direct Sales Meets E-Commerce","sidebarTitle":"We-Commerce","href":"/concepts/we-commerce"},{"title":"FairShare: sales rep attribution","sidebarTitle":"FairShare","href":"/concepts/fair-share"},{"title":"Droplets: Extend Fluid with Third-Party Integrations","sidebarTitle":"Droplets","href":"/concepts/droplets"},{"title":"We-Commerce Checkout: High-Converting One-Page Checkout","sidebarTitle":"Checkout","href":"/concepts/checkout"},{"title":"Order currency and base amounts: reporting revenue across currencies","sidebarTitle":"Order currency","href":"/concepts/order-currency"},{"title":"Commerce metrics: how Fluid counts revenue, orders and subscribers","sidebarTitle":"Commerce metrics","href":"/concepts/metrics"}]},{"group":"Guides","icon":"book","pages":[{"title":"Build a Shopping Cart with Fluid: Cart API and SDK Guide","sidebarTitle":"Shopping Cart","href":"/guides/build-shopping-cart"},{"title":"Choosing a cart surface: Checkout API vs. Public SDK API","sidebarTitle":"Choosing a cart surface","href":"/api/choosing-a-cart-surface"},{"title":"Build a headless checkout","href":"/api/guides/headless-commerce"},{"title":"Build and Publish a Fluid Droplet: Setup to Marketplace","sidebarTitle":"Creating Droplets","href":"/guides/creating-droplets"},{"title":"Register and handle webhooks","href":"/api/guides/webhooks"},{"title":"Answer callbacks from Fluid","sidebarTitle":"Callbacks","href":"/api/guides/callbacks"},{"title":"Message members, customers and contacts","sidebarTitle":"Messaging","href":"/api/guides/messaging"},{"title":"We-Bots","sidebarTitle":"We-Bots","href":"/api/guides/we-bots"},{"title":"Embed apps with drop zones","description":"Choose the right Drop Zones surface and embed external apps safely in Fluid.","href":"/api/guides/drop-zones"},{"title":"Manage global embeds","href":"/api/guides/global-embeds"},{"title":"Connect ad accounts and launch ads","sidebarTitle":"Ads","description":"Connect a company's Meta and Google Ads accounts, choose the account to advertise from, generate ad images, launch paused campaigns, and read their results.","href":"/api/guides/ads"},{"title":"React to Cart Changes in a Checkout Drop Zone: Cart Events Guide","sidebarTitle":"Checkout Cart Events","href":"/guides/checkout-cart-events"},{"title":"Collect Enrollment Details After Payment: Checkout Forms Guide","sidebarTitle":"Checkout Forms","href":"/guides/checkout-forms"},{"title":"Get user information in mobile and Portal widgets","sidebarTitle":"Widget user information","href":"/guides/widget-user-information"},{"title":"Mist Skills","sidebarTitle":"Mist Skills","href":"/guides/mist-skills"}]},{"group":"Guided setup","icon":"list-check","pages":[{"title":"Guided setup","href":"/setup/overview"},{"title":"Agent signup: create a Fluid company with the API","sidebarTitle":"Agent signup","href":"/api/agent-signup"},{"title":"How to launch an ecommerce store with an AI agent on Fluid","sidebarTitle":"Agent launch guide","href":"/api/agent-launch"},{"title":"Set up a custom domain","sidebarTitle":"Custom domain","href":"/setup/custom-domain"},{"title":"Connect Exigo to Fluid","sidebarTitle":"Connect Exigo","href":"/setup/connect-exigo"},{"title":"Connect InfoTrax to Fluid","sidebarTitle":"Connect InfoTrax","href":"/setup/connect-infotrax"},{"title":"Connect ByDesign to Fluid","sidebarTitle":"Connect ByDesign","href":"/setup/connect-bydesign"},{"title":"Connect Pillars to Fluid","sidebarTitle":"Connect Pillars","href":"/setup/connect-pillars"},{"title":"Connect TikTok Shop","sidebarTitle":"TikTok Shop","href":"/setup/sales-channel-tiktok"},{"title":"Connect Meta (Facebook and Instagram)","sidebarTitle":"Meta","href":"/setup/sales-channel-meta"},{"title":"Connect Google Merchant Center","sidebarTitle":"Google Merchant Center","href":"/setup/sales-channel-google"},{"title":"Complete payments onboarding","sidebarTitle":"Payments onboarding","href":"/setup/payments-onboarding"},{"title":"Create a page","sidebarTitle":"Create a page","href":"/setup/create-a-page"},{"title":"Open a country","sidebarTitle":"Open a country","href":"/setup/open-a-country"},{"title":"Add a language and translate your storefront","sidebarTitle":"Add a language","href":"/setup/add-a-language"}]},{"group":"Storefront guides","icon":"cart-shopping","pages":[{"title":"Storefront API overview","sidebarTitle":"Overview","href":"/storefront/overview"},{"title":"Public and company storefront endpoints","sidebarTitle":"Public and company endpoints","href":"/storefront/public-and-company-endpoints"},{"title":"Storefront resources","sidebarTitle":"Resources","href":"/storefront/resources"},{"title":"Find and create storefront resources","sidebarTitle":"Find and create resources","href":"/storefront/find-and-create"},{"title":"Visibility, drafts, and scheduling","sidebarTitle":"Visibility and drafts","href":"/storefront/visibility"},{"title":"Slugs and URLs","sidebarTitle":"Slugs and URLs","href":"/storefront/slugs-and-urls"},{"title":"SEO for storefront resources","sidebarTitle":"SEO","href":"/storefront/seo"},{"title":"Metafields on storefront resources","sidebarTitle":"Metafields","href":"/storefront/metafields"},{"title":"Control country availability","sidebarTitle":"Country availability","href":"/storefront/country-availability"},{"title":"Translate storefront resources","sidebarTitle":"Translations","href":"/storefront/translations"},{"title":"FairShare SDK and the storefront","sidebarTitle":"FairShare SDK and the storefront","href":"/storefront/fairshare-sdk"},{"title":"Run a headless storefront","sidebarTitle":"Headless storefront","href":"/storefront/headless-storefront"},{"title":"Work with the category hierarchy","sidebarTitle":"Category hierarchy","href":"/storefront/category-hierarchy"}]},{"group":"SDKs","icon":"code","pages":[{"group":"FairShare SDK","pages":[{"title":"FairShare SDK: Attribution and Commerce for Any Website","sidebarTitle":"Overview","href":"/sdk/overview"},{"title":"Install the FairShare SDK on Any Website in Minutes","sidebarTitle":"Installation","href":"/sdk/installation"},{"title":"FairShare Cart API: JavaScript Methods and HTML Controls","sidebarTitle":"Cart API","href":"/sdk/cart-api"},{"title":"FairShare Web Components","sidebarTitle":"Components","href":"/sdk/components"},{"title":"FairShare media","sidebarTitle":"Media","href":"/sdk/media"},{"title":"Migrate to server-side attribution","sidebarTitle":"Server-side attribution","href":"/migration/server-side-attribution"}]},{"group":"Files SDK","pages":[{"title":"Files SDK","sidebarTitle":"Files SDK","href":"/sdk/files-sdk"},{"title":"Embed Fluid's DAM Picker: Asset Selection SDK Guide","sidebarTitle":"DAM Picker SDK","href":"/guides/dam-picker"}]},{"group":"Exigo SDK","pages":[{"title":"Exigo connection SDK","sidebarTitle":"Exigo SDK","href":"/sdk/exigo-sdk"}]}]},{"group":"Portal \u0026 Widgets","icon":"desktop","pages":[{"title":"Portal and widget development","sidebarTitle":"Overview","href":"/portal-widgets/overview"},{"group":"Portal Definitions","pages":[{"group":"Build","pages":[{"title":"Portal Definition quickstart","sidebarTitle":"Quickstart","href":"/portal-widgets/portal-definitions/quickstart"},{"title":"Generated portal project structure","sidebarTitle":"Project structure","href":"/portal-widgets/portal-definitions/project-structure"},{"title":"Portal resource graph","sidebarTitle":"Resource graph","href":"/portal-widgets/portal-definitions/resource-graph"},{"title":"Screens and built-in widgets","sidebarTitle":"Screens and widgets","href":"/portal-widgets/portal-definitions/screens-and-widgets"},{"title":"Navigation, profiles, and themes","sidebarTitle":"Navigation and themes","href":"/portal-widgets/portal-definitions/navigation-profiles-themes"}]},{"group":"Ship and reference","pages":[{"title":"Preview and validate a Portal Definition","sidebarTitle":"Preview and validate","href":"/portal-widgets/portal-definitions/preview-and-validation"},{"title":"Pull, reconcile, and push","sidebarTitle":"Pull and push","href":"/portal-widgets/portal-definitions/synchronize"},{"title":"Create and activate portal versions","sidebarTitle":"Versions","href":"/portal-widgets/portal-definitions/versions"},{"title":"Portal Definition CLI workflows","sidebarTitle":"CLI workflows","href":"/portal-widgets/portal-definitions/cli-reference"},{"title":"Troubleshoot Portal Definition authoring","sidebarTitle":"Troubleshooting","href":"/portal-widgets/portal-definitions/troubleshooting"}]}]},{"group":"Widget Packages","pages":[{"group":"Get started","pages":[{"title":"Choose a Widget Package model","sidebarTitle":"Choose a model","href":"/portal-widgets/widget-packages/choose-package-model"},{"title":"Company Widget Package quickstart","sidebarTitle":"Company quickstart","href":"/portal-widgets/widget-packages/company-quickstart"},{"title":"Droplet Widget Package quickstart","sidebarTitle":"Droplet quickstart","href":"/portal-widgets/widget-packages/droplet-quickstart"}]},{"group":"Build","pages":[{"title":"Define packages and widgets","sidebarTitle":"Packages and widgets","href":"/portal-widgets/widget-packages/define-packages-and-widgets"},{"title":"Property schemas and defaults","sidebarTitle":"Properties and defaults","href":"/portal-widgets/widget-packages/properties-and-defaults"},{"title":"Use portal functions","sidebarTitle":"Portal functions","href":"/portal-widgets/widget-packages/portal-functions"},{"title":"Read Droplet data in a Portal widget","sidebarTitle":"Droplet data","href":"/portal-widgets/widget-packages/droplet-data"},{"title":"Runtime, styling, and accessibility","sidebarTitle":"Runtime and styling","href":"/portal-widgets/widget-packages/runtime-and-accessibility"},{"title":"Network access for Widget Packages","sidebarTitle":"Network access","href":"/portal-widgets/widget-packages/network-access"}]},{"group":"Ship and reference","pages":[{"title":"Validate, build, and publish","sidebarTitle":"Build and publish","href":"/portal-widgets/widget-packages/build-and-publish"},{"title":"Widget Package CLI workflows","sidebarTitle":"CLI workflows","href":"/portal-widgets/widget-packages/cli-reference"},{"title":"Troubleshoot Widget Packages","sidebarTitle":"Troubleshooting","href":"/portal-widgets/widget-packages/troubleshooting"}]}]}]}]},{"tab":"Themes","pages":[{"title":"Themes","href":"/themes/overview"}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api/overview"}]}]},"title":"Manage global embeds - Fluid","buildId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","deploymentId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","dynamics":[],"chunks":[]}