The currently published embed.js bundle constructs its internal form iframe on oy.fm from the configured form ID. Your form still works when the account also has a custom public hostname, but the internal widget request does not switch to that hostname.
If the embedded iframe itself must load through your custom hostname, use the direct iframe method. Do not change the embed.js script hostname unless Onlyform serves the widget bundle from that hostname.
Merge these sources into the site’s existing policy rather than replacing the complete header.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Onlyform API","description":"Build form workflows with the Onlyform Public API.","colors":{"primary":"#3969D9","light":"#3969D9","dark":"#3969D9"},"logo":{"light":"https://mintcdn.com/onlyform/RnsX4UGJCHnHam6k/logo/light.svg?fit=max\u0026auto=format\u0026n=RnsX4UGJCHnHam6k\u0026q=85\u0026s=cae3932a26badebbae26a1fba8fdafd2","dark":"https://mintcdn.com/onlyform/RnsX4UGJCHnHam6k/logo/dark.svg?fit=max\u0026auto=format\u0026n=RnsX4UGJCHnHam6k\u0026q=85\u0026s=64148451f3b0011928a85dfd56929e7c","href":"https://onlyform.com"},"favicon":"https://mintcdn.com/onlyform/RnsX4UGJCHnHam6k/favicon.svg?fit=max\u0026auto=format\u0026n=RnsX4UGJCHnHam6k\u0026q=85\u0026s=08829be30aaef0e0ff46c47d550f80df","api":{"openapi":"openapi.json","playground":{"display":"interactive","proxy":false},"examples":{"defaults":"required","languages":["curl","javascript","python","go"],"prefill":true,"autogenerate":true},"url":"full"},"navbar":{"primary":{"type":"button","label":"Open dashboard","href":"https://app.onlyform.com"}},"fonts":{"family":"Inter"},"contextual":{"options":["copy","view","download-spec","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"onlyform","hasAudioNarration":false,"actualSubdomain":"onlyform","customDomains":["docs.onlyform.com"],"gitSource":{"type":"github","owner":"sullyal","repo":"onlyform-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6a6e528152f58c8d8ff01953","collectionId":"cdc5ab2d-12d7-4333-b5f0-fee2a91ab234","liveDeploymentHistoryId":"6a6e528152f58c8d8ff01953","schemaVersion":"v3"},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6a6e528152f58c8d8ff01953:success","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"Developers","count":38},{"language":"default","tag":"API reference","count":30},{"language":"default","tag":"Forms","count":12},{"language":"default","tag":"Schema","count":7},{"language":"default","tag":"Form schema","count":7},{"language":"default","tag":"Get started","count":6},{"language":"default","tag":"Widgets","count":6},{"language":"default","tag":"Webhooks","count":6},{"language":"default","tag":"Core concepts","count":5},{"language":"default","tag":"Workspaces","count":5}],"searchSettings":{"isFiltersEnabled":true}},"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":"full-page-search","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":"turbopuffer-dual-write","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},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"widgets/custom-domains","slug":"/widgets/custom-domains","pageMetadata":{"title":"Custom domains","description":"Embed forms using the default URL, an Onlyform subdomain, or a connected custom hostname.","href":"/widgets/custom-domains"},"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: \"Embed forms using the default URL, an Onlyform subdomain, or a connected custom hostname.\"\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={code:`code`,p:`p`,pre:`pre`,span:`span`,..._provideComponents(),...props.components},{CodeBlock,Heading,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`The public form URL shown on the Share page is canonical. Depending on the account configuration, it can use:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`4`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`https://oy.fm/FORM_ID`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`https://YOUR_SUBDOMAIN.oy.fm/FORM_ID`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`https://forms.example.com/FORM_ID`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Heading,{level:`2`,id:`iframe-embeds`,children:`Iframe embeds`}),`\n`,_jsx(_components.p,{children:`An iframe can use the complete custom-domain URL directly:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`html`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`html`,children:_jsxs(_components.code,{language:`html`,numberOfLines:`5`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`\u003c`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`iframe`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:` src`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://forms.example.com/FORM_ID\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:` title`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Contact us\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:` style`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"width: 100%; height: 600px; border: 0;\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>\u003c/`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`iframe`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Hidden fields and UTM values remain query parameters on that URL:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`https://forms.example.com/FORM_ID?account_id=acct_123\u0026utm_source=website`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Heading,{level:`2`,id:`javascript-widgets`,children:`JavaScript widgets`}),`\n`,_jsx(_components.p,{children:`Load the widget library from its stable Onlyform asset URL:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`html`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`html`,children:_jsxs(_components.code,{language:`html`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`\u003c`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`script`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:` type`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"module\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:` src`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://oy.fm/embed.js\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>\u003c/`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`script`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`The currently published `,_jsx(_components.code,{children:`embed.js`}),` bundle constructs its internal form iframe on `,_jsx(_components.code,{children:`oy.fm`}),` from the configured form ID. Your form still works when the account also has a custom public hostname, but the internal widget request does not switch to that hostname.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`If the embedded iframe itself must load through your custom hostname, use the direct iframe method. Do not change the `,_jsx(_components.code,{children:`embed.js`}),` script hostname unless Onlyform serves the widget bundle from that hostname.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`content-security-policy`,children:`Content Security Policy`}),`\n`,_jsx(_components.p,{children:`Allow every hostname actually used by the selected method:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`script-src https://oy.fm;`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`frame-src https://oy.fm https://forms.example.com;`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(_components.p,{children:`Merge these sources into the site’s existing policy rather than replacing the complete header.`})]})}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":"Custom domains","description":"Embed forms using the default URL, an Onlyform subdomain, or a connected custom hostname.","href":"/widgets/custom-domains"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Iframe embeds","slug":"iframe-embeds","depth":2,"children":[]},{"title":"JavaScript widgets","slug":"javascript-widgets","depth":2,"children":[]},{"title":"Content Security Policy","slug":"content-security-policy","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"onlyform","siteName":"Onlyform API","title":"Custom domains - Onlyform API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-01T20:09:55.672Z","originalFileLocation":"widgets/custom-domains.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=\"Embed forms using the default URL, an Onlyform subdomain, or a connected custom hostname.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Onlyform API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/onlyform/debok6LykAdNqPQj/_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/onlyform/debok6LykAdNqPQj/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/onlyform/debok6LykAdNqPQj/_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/onlyform/debok6LykAdNqPQj/_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/onlyform/debok6LykAdNqPQj/_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/onlyform/debok6LykAdNqPQj/_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/onlyform/debok6LykAdNqPQj/_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/onlyform/debok6LykAdNqPQj/_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/onlyform/debok6LykAdNqPQj/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Custom domains - Onlyform API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Embed forms using the default URL, an Onlyform subdomain, or a connected custom hostname.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Onlyform API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.onlyform.com/widgets/custom-domains\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://onlyform.mintlify.app/_mintlify/api/og/v2?division=Reference\u0026amp;title=Custom+domains\u0026amp;description=Embed+forms+using+the+default+URL%2C+an+Onlyform+subdomain%2C+or+a+connected+custom+hostname.\u0026amp;theme=438d117f9ba8b13a7a593906\u0026amp;signature=29048552d543443687fe2ae9bc010133a9753be4d5b99600766a3bdbf3cdcfe2\">\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=\"Custom domains - Onlyform API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Embed forms using the default URL, an Onlyform subdomain, or a connected custom hostname.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://onlyform.mintlify.app/_mintlify/api/og/v2?division=Reference\u0026amp;title=Custom+domains\u0026amp;description=Embed+forms+using+the+default+URL%2C+an+Onlyform+subdomain%2C+or+a+connected+custom+hostname.\u0026amp;theme=438d117f9ba8b13a7a593906\u0026amp;signature=29048552d543443687fe2ae9bc010133a9753be4d5b99600766a3bdbf3cdcfe2\">\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/onlyform/debok6LykAdNqPQj/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Onlyform API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3969D9\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.onlyform.com/widgets/custom-domains\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/widgets/custom-domains.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.onlyform.com/#organization\",\"name\":\"Onlyform API\",\"url\":\"https://docs.onlyform.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/onlyform/RnsX4UGJCHnHam6k/logo/light.svg?fit=max\u0026auto=format\u0026n=RnsX4UGJCHnHam6k\u0026q=85\u0026s=cae3932a26badebbae26a1fba8fdafd2\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.onlyform.com#website\",\"name\":\"Onlyform API\",\"url\":\"https://docs.onlyform.com\",\"publisher\":{\"@id\":\"https://docs.onlyform.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.onlyform.com/widgets/custom-domains#webpage\",\"url\":\"https://docs.onlyform.com/widgets/custom-domains\",\"name\":\"Custom domains\",\"description\":\"Embed forms using the default URL, an Onlyform subdomain, or a connected custom hostname.\",\"dateModified\":\"2026-08-01T20:09:55.672Z\",\"isPartOf\":{\"@id\":\"https://docs.onlyform.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.onlyform.com/widgets/custom-domains#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.onlyform.com/widgets/custom-domains#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Reference\",\"item\":\"https://docs.onlyform.com/widgets/options\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Custom domains\",\"item\":\"https://docs.onlyform.com/widgets/custom-domains\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.onlyform.com/widgets/custom-domains#article\",\"headline\":\"Custom domains\",\"name\":\"Custom domains\",\"description\":\"Embed forms using the default URL, an Onlyform subdomain, or a connected custom hostname.\",\"url\":\"https://docs.onlyform.com/widgets/custom-domains\",\"mainEntityOfPage\":{\"@id\":\"https://docs.onlyform.com/widgets/custom-domains#webpage\"},\"dateModified\":\"2026-08-01T20:09:55.672Z\",\"publisher\":{\"@id\":\"https://docs.onlyform.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.onlyform.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Onlyform API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Onlyform API","nav":{"global":null,"tabs":[{"tab":"Developers","pages":[{"title":"Developers","href":""}]},{"tab":"Schema","pages":[{"title":"Schema","href":"/schema/overview"}]},{"tab":"SDKs","pages":[{"title":"SDKs","href":"/sdks/overview"}]},{"tab":"Widgets","groups":[{"group":"Get started","pages":[{"title":"Widgets overview","href":"/widgets/overview"},{"title":"Embed with an iframe","href":"/widgets/iframe"},{"title":"Embed with embed.js","href":"/widgets/embed-js"}]},{"group":"Reference","pages":[{"title":"Widget options","description":"Reference for iframe settings and the embed.js configuration object.","href":"/widgets/options"},{"title":"Custom domains","href":"/widgets/custom-domains"},{"title":"Widget troubleshooting","description":"Diagnose blank embeds, inactive buttons, sizing issues, and browser security restrictions.","href":"/widgets/troubleshooting"}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog/overview"}]}]},"basePath":"","title":"Custom domains - Onlyform API","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":[],"chunks":[]}
