Publish a public form, allow embed domains, set trusted IPs, and review submissions.
Share an active form as a public link or show it on your website.You can share a form as a public link, or show the same form in an iframe on your website. A visitor does not need a Broker Panel account to open or submit it. See Form Center for building forms and for activating, deactivating, or deleting them.
The allowed-domain list applies to every form for your broker. A form can always run in a same-origin iframe, but each external website origin must be added before that site can show the form. Admin only.
Manage Embed Domains
1
Open Form Settings
Select Form Settings in Form Center.
2
Open Manage Embed Domains
Select Manage Embed Domains.
3
Enter the Origins
Enter one origin per line in Allowed Domains. Use a full HTTPS origin.
4
Save
Select Save Changes.
Origin Format
The saved value keeps the protocol, host, and port when present, and the panel removes any path. This dialog accepts HTTP only for localhost.
One Entry per Origin
Add every required origin separately, because a different protocol, subdomain, or port is a different origin. Clearing Allowed Domains stops external websites from framing your forms.
Public form submissions have a broker-wide rate limit: one source IP can send five form submissions in a 60-minute window for one broker. Further submissions are blocked until the window permits another.A trusted IP bypasses only this submission rate limit. It does not bypass form status checks, spam checks, or field validation. Admin only.
1
Open Form Settings
Select Form Settings in Form Center.
2
Open Trusted IPs
Select Trusted IPs.
3
Enter the Addresses
Enter one IP address per line in Trusted IP Addresses.
4
Save
Select Save Changes.
Add only an IP that you control and trust. Do not add a visitor IP to work
around a temporary rate limit.
Accepted Addresses
The panel accepts individual IPv4 and IPv6 addresses only, not ranges or CIDR notation.
The panel opens Requests with the form filter applied.
What Happens After a Submission
Each successful submission creates a New Service request with Form as its source. The visitor sees the configured success message and is redirected if the form has a redirect URL.The form’s Approval value decides what happens next:
Approval
Result
Manual
The request stays pending for staff review.
Automatic
System approval starts after the request is created. If system approval cannot complete, the request stays pending.
The broker does not have a slug. Contact Support to configure it.
The Public Form Does Not Load
Confirm the row shows the Active status, then use Manage > Open Form to test the current URL. An incorrect broker slug, an incorrect form slug, or an inactive form returns a not-found page.
The Website Refuses to Show the Iframe
Open Form Settings > Manage Embed Domains and confirm Allowed Domains contains the exact parent website origin, including protocol, subdomain, and port. Save the change and reload the parent website. If the embed-domain lookup fails, the panel permits same-origin framing only.
An Entry Is Rejected
Manage Embed Domains needs one full URL per line, HTTPS for an external website, and no path segments. Trusted IPs needs one individual IPv4 or IPv6 address per line, with no ranges, CIDR suffixes, or other text.
A Visitor Sees a Rate-Limit Message
The source IP reached five submissions in the 60-minute window for this broker. Wait for the window to permit another submission, and use Trusted IPs only for a fixed source IP that you control.
A Submission Does Not Appear in Requests
Confirm the visitor saw the success message, then use Manage > View Submissions to apply the correct form filter. If submission still fails, test the public form and correct the field error it shows.
{"docsConfig":{"theme":"palm","$schema":"https://mintlify.com/docs.json","name":"Broker Panel Docs","colors":{"primary":"#0E3A8C","light":"#4F7FFF","dark":"#0A2B66"},"logo":{"light":"https://mintcdn.com/nycs-partner-portal/VNrdR5TP4VcU6sO6/logo/nyc-servers-black.gif?fit=max\u0026auto=format\u0026n=VNrdR5TP4VcU6sO6\u0026q=85\u0026s=70df48f74232b81c9a07e249bc62d013","dark":"https://mintcdn.com/nycs-partner-portal/VNrdR5TP4VcU6sO6/logo/nyc-servers-white.gif?fit=max\u0026auto=format\u0026n=VNrdR5TP4VcU6sO6\u0026q=85\u0026s=e00124760ad8c920a754347c54656f1a"},"favicon":"https://mintcdn.com/nycs-partner-portal/0o5Bk7WV4bw-FcD4/favicon.svg?fit=max\u0026auto=format\u0026n=0o5Bk7WV4bw-FcD4\u0026q=85\u0026s=31a029f8f5444e906067c2cf53fb7696","api":{"playground":{"display":"interactive"},"mdx":{"auth":{"method":"bearer"},"server":"https://brokers.newyorkcityservers.com/api"}},"navbar":{"primary":{"type":"button","label":"Contact Support","href":"https://brokers.newyorkcityservers.com/support"}},"footer":{"links":[{"header":"Help","items":[{"label":"Contact Support","href":"https://brokers.newyorkcityservers.com/support"},{"label":"FAQ \u0026 Troubleshooting","href":"/broker/faq"}]}]},"seo":{"indexing":"navigable"},"fonts":{"family":"Geist"},"styling":{"eyebrows":"breadcrumbs","latex":false},"metadata":{"timestamp":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"nycs-partner-portal","hasAudioNarration":false,"actualSubdomain":"nycs-partner-portal","customDomains":["broker-docs.newyorkcityservers.com"],"gitSource":{"type":"github","owner":"nycservers","repo":"broker-panel","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6adbaa91de4e168f98ba7d55","collectionId":"8cfbf04c-7977-4dfc-96f7-2442953a64ad","liveDeploymentHistoryId":"6adbaa91de4e168f98ba7d55","schemaVersion":"v3"},"entitlements":{},"buildId":"6adbaa91de4e168f98ba7d55","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"Guides","count":25},{"language":"default","tag":"API Reference","count":21},{"language":"default","tag":"Getting Started","count":13},{"language":"default","tag":"Services","count":9},{"language":"default","tag":"Forms \u0026 API","count":5},{"language":"default","tag":"Services \u0026 Requests","count":5},{"language":"default","tag":"Billing","count":3},{"language":"default","tag":"Branding \u0026 Email","count":3},{"language":"default","tag":"Reports","count":2},{"language":"default","tag":"Requests","count":2}]},"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":true},"customCss":[],"page":{"pagePath":"broker/integrations/form-embedding","slug":"/broker/integrations/form-embedding","pageMetadata":{"title":"Publish and Embed Forms","description":"Publish a public form, allow embed domains, set trusted IPs, and review submissions.","href":"/broker/integrations/form-embedding"},"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: \"Publish a public form, allow embed domains, set trusted IPs, and review submissions.\"\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={a:`a`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,Card,Frame,Heading,OptimizedImage,Step,Steps,Tab,Table,Tabs,Warning}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!Card)_missingMdxReference(`Card`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Share an active form as a public link or show it on your website.`}),`\n`,_jsxs(_components.p,{children:[`You can share a form as a public link, or show the same form in an iframe on your website. A visitor does not need a Broker Panel account to open or submit it. See `,_jsx(_components.a,{href:`/broker/integrations/form-center`,children:`Form Center`}),` for building forms and for activating, deactivating, or deleting them.`]}),`\n`,_jsx(Heading,{level:`2`,id:`who-can-do-this`,children:`Who Can Do This`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Action`}),_jsx(_components.th,{children:`Admin`}),_jsx(_components.th,{children:`Staff`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Copy or open a direct link`}),_jsx(_components.td,{children:`✅`}),_jsx(_components.td,{children:`✅`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Get embed code`}),_jsx(_components.td,{children:`✅`}),_jsx(_components.td,{children:`✅`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Review submissions`}),_jsx(_components.td,{children:`✅`}),_jsx(_components.td,{children:`✅`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Allow an external embed domain`}),_jsx(_components.td,{children:`✅`}),_jsx(_components.td,{children:`❌`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Configure trusted IPs`}),_jsx(_components.td,{children:`✅`}),_jsx(_components.td,{children:`❌`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`publish-a-form`,children:`Publish a Form`}),`\n`,_jsxs(Tabs,{children:[_jsxs(Tab,{title:`Direct Link`,id:`direct-link`,children:[_jsxs(Steps,{children:[_jsx(Step,{title:`Choose the Language`,children:_jsxs(_components.p,{children:[`On the builder success screen, select `,_jsx(_components.strong,{children:`Display Language`}),` if the form has a saved translation.`]})}),_jsx(Step,{title:`Copy the Form URL`,children:_jsxs(_components.p,{children:[`Use `,_jsx(_components.strong,{children:`Direct Link`}),` to copy the `,_jsx(_components.strong,{children:`Form URL`}),`. The open icon tests the URL in a new browser tab.`]})})]}),_jsxs(_components.p,{children:[`For an existing form, use `,_jsx(_components.strong,{children:`Copy Form URL`}),` or `,_jsx(_components.strong,{children:`Open Form`}),` in the row’s `,_jsx(_components.strong,{children:`Manage`}),` menu, or the copy icon in the `,_jsx(_components.strong,{children:`Direct URL`}),` column.`]})]}),_jsxs(Tab,{title:`Website Iframe`,id:`website-iframe`,children:[_jsx(Frame,{caption:`Embed Code Dialog`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/nycs-partner-portal/P-PivY7wgrANbTTC/images/broker/integrations/form-share-dialog.png?fit=max\u0026auto=format\u0026n=P-PivY7wgrANbTTC\u0026q=85\u0026s=c7bddb3f4ef690a633a91969a7bdb4e1`,alt:`Form sharing dialog with an iframe embed snippet`,\"data-og-width\":`800`,width:`800`,\"data-og-height\":`338`,height:`338`,\"data-path\":`images/broker/integrations/form-share-dialog.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/nycs-partner-portal/P-PivY7wgrANbTTC/images/broker/integrations/form-share-dialog.png?w=280\u0026fit=max\u0026auto=format\u0026n=P-PivY7wgrANbTTC\u0026q=85\u0026s=b65c7778ba111136f4fb72a2b6929ccf 280w, https://mintcdn.com/nycs-partner-portal/P-PivY7wgrANbTTC/images/broker/integrations/form-share-dialog.png?w=560\u0026fit=max\u0026auto=format\u0026n=P-PivY7wgrANbTTC\u0026q=85\u0026s=926b9bf8dd3ba91c2ab5e0dd53753ef2 560w, https://mintcdn.com/nycs-partner-portal/P-PivY7wgrANbTTC/images/broker/integrations/form-share-dialog.png?w=840\u0026fit=max\u0026auto=format\u0026n=P-PivY7wgrANbTTC\u0026q=85\u0026s=37e432b5f1b9fa2046728ab9b7f507d5 840w, https://mintcdn.com/nycs-partner-portal/P-PivY7wgrANbTTC/images/broker/integrations/form-share-dialog.png?w=1100\u0026fit=max\u0026auto=format\u0026n=P-PivY7wgrANbTTC\u0026q=85\u0026s=a41cea3b5b688c18d6b0197e10eed7c5 1100w, https://mintcdn.com/nycs-partner-portal/P-PivY7wgrANbTTC/images/broker/integrations/form-share-dialog.png?w=1650\u0026fit=max\u0026auto=format\u0026n=P-PivY7wgrANbTTC\u0026q=85\u0026s=46a19c181df0c06c6f76d43b6317095c 1650w, https://mintcdn.com/nycs-partner-portal/P-PivY7wgrANbTTC/images/broker/integrations/form-share-dialog.png?w=2500\u0026fit=max\u0026auto=format\u0026n=P-PivY7wgrANbTTC\u0026q=85\u0026s=00470724478558bf605158cf84ab0cc7 2500w`})}),_jsxs(_components.p,{children:[_jsx(_components.a,{href:`#allow-an-external-embed-domain`,children:`Allow the external website origin`}),` first, then copy the generated iframe code.`]}),_jsxs(Steps,{children:[_jsx(Step,{title:`Find the Form`,children:_jsxs(_components.p,{children:[`Find the form in `,_jsx(_components.strong,{children:`Form Center`}),`.`]})}),_jsx(Step,{title:`Get the Embed Code`,children:_jsxs(_components.p,{children:[`Select `,_jsx(_components.strong,{children:`Manage`}),` > `,_jsx(_components.strong,{children:`Get Embed Code`}),`.`]})}),_jsx(Step,{title:`Choose the Language`,children:_jsxs(_components.p,{children:[`Select a value in `,_jsx(_components.strong,{children:`Language`}),`.`]})}),_jsx(Step,{title:`Copy and Paste`,children:_jsxs(_components.p,{children:[`Select `,_jsx(_components.strong,{children:`Copy`}),`, then paste the iframe code into your website’s HTML.`]})})]}),_jsxs(_components.p,{children:[`The same code is available from `,_jsx(_components.strong,{children:`Embed Code`}),` on the builder success screen.`]})]})]}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`Embed Languages`,id:`embed-languages`,children:_jsxs(_components.p,{children:[`The `,_jsx(_components.strong,{children:`Language`}),` list contains English and the form’s saved translations. The generated URL includes the selected language when it is not English.`]})}),_jsx(Accordion,{title:`Iframe Size`,id:`iframe-size`,children:_jsx(_components.p,{children:`The generated iframe fills the width of its container and is 500 pixels tall. Change those display values in your website code.`})})]}),`\n`,_jsx(Heading,{level:`2`,id:`allow-an-external-embed-domain`,children:`Allow an External Embed Domain`}),`\n`,_jsx(_components.p,{children:`The allowed-domain list applies to every form for your broker. A form can always run in a same-origin iframe, but each external website origin must be added before that site can show the form. Admin only.`}),`\n`,_jsx(Frame,{caption:`Manage Embed Domains`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/nycs-partner-portal/P-PivY7wgrANbTTC/images/broker/integrations/embed-domains.png?fit=max\u0026auto=format\u0026n=P-PivY7wgrANbTTC\u0026q=85\u0026s=e262638031ed53c3098cd6c08737a37e`,alt:`Manage Embed Domains dialog with allowed domain entries`,\"data-og-width\":`672`,width:`672`,\"data-og-height\":`595`,height:`595`,\"data-path\":`images/broker/integrations/embed-domains.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/nycs-partner-portal/P-PivY7wgrANbTTC/images/broker/integrations/embed-domains.png?w=280\u0026fit=max\u0026auto=format\u0026n=P-PivY7wgrANbTTC\u0026q=85\u0026s=242ffb8d94e1d356264508c416e47aca 280w, https://mintcdn.com/nycs-partner-portal/P-PivY7wgrANbTTC/images/broker/integrations/embed-domains.png?w=560\u0026fit=max\u0026auto=format\u0026n=P-PivY7wgrANbTTC\u0026q=85\u0026s=528913ad7db96c4a8df52cd46fe308c8 560w, https://mintcdn.com/nycs-partner-portal/P-PivY7wgrANbTTC/images/broker/integrations/embed-domains.png?w=840\u0026fit=max\u0026auto=format\u0026n=P-PivY7wgrANbTTC\u0026q=85\u0026s=959c948a875b16259033564fe90020d5 840w, https://mintcdn.com/nycs-partner-portal/P-PivY7wgrANbTTC/images/broker/integrations/embed-domains.png?w=1100\u0026fit=max\u0026auto=format\u0026n=P-PivY7wgrANbTTC\u0026q=85\u0026s=e4d45db1690499126b9af35b3f38b568 1100w, https://mintcdn.com/nycs-partner-portal/P-PivY7wgrANbTTC/images/broker/integrations/embed-domains.png?w=1650\u0026fit=max\u0026auto=format\u0026n=P-PivY7wgrANbTTC\u0026q=85\u0026s=b80f82719380bded2b0c6e7cee630d27 1650w, https://mintcdn.com/nycs-partner-portal/P-PivY7wgrANbTTC/images/broker/integrations/embed-domains.png?w=2500\u0026fit=max\u0026auto=format\u0026n=P-PivY7wgrANbTTC\u0026q=85\u0026s=28439c2ca3bbc867efb0c360e2d8c814 2500w`})}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open Form Settings`,children:_jsxs(_components.p,{children:[`Select `,_jsx(_components.strong,{children:`Form Settings`}),` in `,_jsx(_components.strong,{children:`Form Center`}),`.`]})}),_jsx(Step,{title:`Open Manage Embed Domains`,children:_jsxs(_components.p,{children:[`Select `,_jsx(_components.strong,{children:`Manage Embed Domains`}),`.`]})}),_jsx(Step,{title:`Enter the Origins`,children:_jsxs(_components.p,{children:[`Enter one origin per line in `,_jsx(_components.strong,{children:`Allowed Domains`}),`. Use a full HTTPS origin.`]})}),_jsx(Step,{title:`Save`,children:_jsxs(_components.p,{children:[`Select `,_jsx(_components.strong,{children:`Save Changes`}),`.`]})})]}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`Origin Format`,id:`origin-format`,children:_jsx(_components.p,{children:`The saved value keeps the protocol, host, and port when present, and the panel removes any path. This dialog accepts HTTP only for localhost.`})}),_jsx(Accordion,{title:`One Entry per Origin`,id:`one-entry-per-origin`,children:_jsxs(_components.p,{children:[`Add every required origin separately, because a different protocol, subdomain, or port is a different origin. Clearing `,_jsx(_components.strong,{children:`Allowed Domains`}),` stops external websites from framing your forms.`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`set-trusted-ips`,children:`Set Trusted IPs`}),`\n`,_jsx(_components.p,{children:`Public form submissions have a broker-wide rate limit: one source IP can send five form submissions in a 60-minute window for one broker. Further submissions are blocked until the window permits another.`}),`\n`,_jsx(_components.p,{children:`A trusted IP bypasses only this submission rate limit. It does not bypass form status checks, spam checks, or field validation. Admin only.`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open Form Settings`,children:_jsxs(_components.p,{children:[`Select `,_jsx(_components.strong,{children:`Form Settings`}),` in `,_jsx(_components.strong,{children:`Form Center`}),`.`]})}),_jsx(Step,{title:`Open Trusted IPs`,children:_jsxs(_components.p,{children:[`Select `,_jsx(_components.strong,{children:`Trusted IPs`}),`.`]})}),_jsx(Step,{title:`Enter the Addresses`,children:_jsxs(_components.p,{children:[`Enter one IP address per line in `,_jsx(_components.strong,{children:`Trusted IP Addresses`}),`.`]})}),_jsx(Step,{title:`Save`,children:_jsxs(_components.p,{children:[`Select `,_jsx(_components.strong,{children:`Save Changes`}),`.`]})})]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Add only an IP that you control and trust. Do not add a visitor IP to work\naround a temporary rate limit.`})}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`Accepted Addresses`,id:`accepted-addresses`,children:_jsx(_components.p,{children:`The panel accepts individual IPv4 and IPv6 addresses only, not ranges or CIDR notation.`})}),_jsx(Accordion,{title:`Disable the Bypass`,id:`disable-the-bypass`,children:_jsx(_components.p,{children:`Clear the field and save to disable the bypass.`})})]}),`\n`,_jsx(Heading,{level:`2`,id:`review-submissions`,children:`Review Submissions`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open the Submissions`,children:_jsxs(_components.p,{children:[`Select `,_jsx(_components.strong,{children:`Manage`}),` > `,_jsx(_components.strong,{children:`View Submissions`}),`.`]})}),_jsx(Step,{title:`Review the Requests`,children:_jsxs(_components.p,{children:[`The panel opens `,_jsx(_components.strong,{children:`Requests`}),` with the form filter applied.`]})})]}),`\n`,_jsx(AccordionGroup,{children:_jsxs(Accordion,{title:`What Happens After a Submission`,id:`what-happens-after-a-submission`,children:[_jsxs(_components.p,{children:[`Each successful submission creates a New Service request with `,_jsx(_components.strong,{children:`Form`}),` as its source. The visitor sees the configured success message and is redirected if the form has a redirect URL.`]}),_jsxs(_components.p,{children:[`The form’s `,_jsx(_components.strong,{children:`Approval`}),` value decides what happens next:`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:_jsx(_components.strong,{children:`Approval`})}),_jsx(_components.th,{children:`Result`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Manual`})}),_jsx(_components.td,{children:`The request stays pending for staff review.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Automatic`})}),_jsx(_components.td,{children:`System approval starts after the request is created. If system approval cannot complete, the request stays pending.`})]})]})]})]})}),`\n`,_jsx(Heading,{level:`2`,id:`troubleshooting`,children:`Troubleshooting`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`Direct-Link or Embed Controls Are Not Available`,id:`direct-link-or-embed-controls-are-not-available`,children:_jsxs(_components.p,{children:[`The broker does not have a slug. `,_jsx(_components.a,{href:`https://brokers.newyorkcityservers.com/support`,children:`Contact Support`}),` to configure it.`]})}),_jsx(Accordion,{title:`The Public Form Does Not Load`,id:`the-public-form-does-not-load`,children:_jsxs(_components.p,{children:[`Confirm the row shows the `,_jsx(_components.strong,{children:`Active`}),` status, then use `,_jsx(_components.strong,{children:`Manage`}),` > `,_jsx(_components.strong,{children:`Open Form`}),` to test the current URL. An incorrect broker slug, an incorrect form slug, or an inactive form returns a not-found page.`]})}),_jsx(Accordion,{title:`The Website Refuses to Show the Iframe`,id:`the-website-refuses-to-show-the-iframe`,children:_jsxs(_components.p,{children:[`Open `,_jsx(_components.strong,{children:`Form Settings`}),` > `,_jsx(_components.strong,{children:`Manage Embed Domains`}),` and confirm `,_jsx(_components.strong,{children:`Allowed Domains`}),` contains the exact parent website origin, including protocol, subdomain, and port. Save the change and reload the parent website. If the embed-domain lookup fails, the panel permits same-origin framing only.`]})}),_jsx(Accordion,{title:`An Entry Is Rejected`,id:`an-entry-is-rejected`,children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Manage Embed Domains`}),` needs one full URL per line, HTTPS for an external website, and no path segments. `,_jsx(_components.strong,{children:`Trusted IPs`}),` needs one individual IPv4 or IPv6 address per line, with no ranges, CIDR suffixes, or other text.`]})}),_jsx(Accordion,{title:`A Visitor Sees a Rate-Limit Message`,id:`a-visitor-sees-a-rate-limit-message`,children:_jsxs(_components.p,{children:[`The source IP reached five submissions in the 60-minute window for this broker. Wait for the window to permit another submission, and use `,_jsx(_components.strong,{children:`Trusted IPs`}),` only for a fixed source IP that you control.`]})}),_jsx(Accordion,{title:`A Submission Does Not Appear in Requests`,id:`a-submission-does-not-appear-in-requests`,children:_jsxs(_components.p,{children:[`Confirm the visitor saw the success message, then use `,_jsx(_components.strong,{children:`Manage`}),` > `,_jsx(_components.strong,{children:`View Submissions`}),` to apply the correct form filter. If submission still fails, test the public form and correct the field error it shows.`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`next-step`,children:`Next Step`}),`\n`,_jsx(Card,{title:`Review Service Requests`,icon:`arrow-right`,href:`/broker/services/requests`,children:_jsx(_components.p,{children:`Approve or reject the requests your forms create.`})})]})}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":"Publish and Embed Forms","description":"Publish a public form, allow embed domains, set trusted IPs, and review submissions.","href":"/broker/integrations/form-embedding"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Who Can Do This","slug":"who-can-do-this","depth":2,"children":[]},{"title":"Publish a Form","slug":"publish-a-form","depth":2,"children":[]},{"title":"Allow an External Embed Domain","slug":"allow-an-external-embed-domain","depth":2,"children":[]},{"title":"Set Trusted IPs","slug":"set-trusted-ips","depth":2,"children":[]},{"title":"Review Submissions","slug":"review-submissions","depth":2,"children":[]},{"title":"Troubleshooting","slug":"troubleshooting","depth":2,"children":[]},{"title":"Next Step","slug":"next-step","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"nycs-partner-portal","siteName":"Broker Panel Docs","title":"Publish and Embed Forms - Broker Panel Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-05T10:11:38.849Z","gitLastModified":"2026-10-04T20:53:49.000Z","originalFileLocation":"broker/integrations/form-embedding.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=\"Publish a public form, allow embed domains, set trusted IPs, and review submissions.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Broker Panel Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/nycs-partner-portal/r-zWxzTcT_yMLD0g/_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/nycs-partner-portal/r-zWxzTcT_yMLD0g/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/nycs-partner-portal/r-zWxzTcT_yMLD0g/_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/nycs-partner-portal/r-zWxzTcT_yMLD0g/_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/nycs-partner-portal/r-zWxzTcT_yMLD0g/_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/nycs-partner-portal/r-zWxzTcT_yMLD0g/_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/nycs-partner-portal/r-zWxzTcT_yMLD0g/_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/nycs-partner-portal/r-zWxzTcT_yMLD0g/_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/nycs-partner-portal/r-zWxzTcT_yMLD0g/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Publish and Embed Forms - Broker Panel Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Publish a public form, allow embed domains, set trusted IPs, and review submissions.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Broker Panel Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://broker-docs.newyorkcityservers.com/broker/integrations/form-embedding\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://nycs-partner-portal.mintlify.app/_mintlify/api/og/v2?division=Forms+%26+API\u0026amp;title=Publish+and+Embed+Forms\u0026amp;description=Publish+a+public+form%2C+allow+embed+domains%2C+set+trusted+IPs%2C+and+review+submissions.\u0026amp;theme=74a662f2b66a16030d7b80a1\u0026amp;signature=751874694bd3c2752a0d6e50fd840bd0a6954a427a97cd3aac44dcbdbaac5f54\">\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=\"Publish and Embed Forms - Broker Panel Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Publish a public form, allow embed domains, set trusted IPs, and review submissions.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://nycs-partner-portal.mintlify.app/_mintlify/api/og/v2?division=Forms+%26+API\u0026amp;title=Publish+and+Embed+Forms\u0026amp;description=Publish+a+public+form%2C+allow+embed+domains%2C+set+trusted+IPs%2C+and+review+submissions.\u0026amp;theme=74a662f2b66a16030d7b80a1\u0026amp;signature=751874694bd3c2752a0d6e50fd840bd0a6954a427a97cd3aac44dcbdbaac5f54\">\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/nycs-partner-portal/r-zWxzTcT_yMLD0g/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Broker Panel Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0E3A8C\">\u003clink data-mint-head rel=\"canonical\" href=\"https://broker-docs.newyorkcityservers.com/broker/integrations/form-embedding\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/broker/integrations/form-embedding.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://broker-docs.newyorkcityservers.com/#organization\",\"name\":\"Broker Panel Docs\",\"url\":\"https://broker-docs.newyorkcityservers.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/nycs-partner-portal/VNrdR5TP4VcU6sO6/logo/nyc-servers-black.gif?fit=max\u0026auto=format\u0026n=VNrdR5TP4VcU6sO6\u0026q=85\u0026s=70df48f74232b81c9a07e249bc62d013\"}},{\"@type\":\"WebSite\",\"@id\":\"https://broker-docs.newyorkcityservers.com#website\",\"name\":\"Broker Panel Docs\",\"url\":\"https://broker-docs.newyorkcityservers.com\",\"publisher\":{\"@id\":\"https://broker-docs.newyorkcityservers.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://broker-docs.newyorkcityservers.com/broker/integrations/form-embedding#webpage\",\"url\":\"https://broker-docs.newyorkcityservers.com/broker/integrations/form-embedding\",\"name\":\"Publish and Embed Forms\",\"description\":\"Publish a public form, allow embed domains, set trusted IPs, and review submissions.\",\"dateModified\":\"2026-10-04T20:53:49.000Z\",\"isPartOf\":{\"@id\":\"https://broker-docs.newyorkcityservers.com#website\"},\"breadcrumb\":{\"@id\":\"https://broker-docs.newyorkcityservers.com/broker/integrations/form-embedding#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://broker-docs.newyorkcityservers.com/broker/integrations/form-embedding#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Forms \u0026 API\",\"item\":\"https://broker-docs.newyorkcityservers.com/broker/integrations/form-center\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Publish and Embed Forms\",\"item\":\"https://broker-docs.newyorkcityservers.com/broker/integrations/form-embedding\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://broker-docs.newyorkcityservers.com/broker/integrations/form-embedding#article\",\"headline\":\"Publish and Embed Forms\",\"name\":\"Publish and Embed Forms\",\"description\":\"Publish a public form, allow embed domains, set trusted IPs, and review submissions.\",\"url\":\"https://broker-docs.newyorkcityservers.com/broker/integrations/form-embedding\",\"mainEntityOfPage\":{\"@id\":\"https://broker-docs.newyorkcityservers.com/broker/integrations/form-embedding#webpage\"},\"dateModified\":\"2026-10-04T20:53:49.000Z\",\"publisher\":{\"@id\":\"https://broker-docs.newyorkcityservers.com/#organization\"},\"isPartOf\":{\"@id\":\"https://broker-docs.newyorkcityservers.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Broker Panel Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Broker Panel Docs","nav":{"global":null,"tabs":[{"tab":"Guides","groups":[{"group":"Getting Started","icon":"rocket","pages":[{"title":"Broker Panel Overview","href":""},{"title":"Logging In \u0026 MFA","href":"/broker/logging-in"},{"title":"Dashboard Tour","href":"/broker/dashboard-tour"},{"title":"Roles \u0026 Team Management","href":"/broker/roles-and-team"},{"title":"Account Settings","href":"/broker/account-settings"}]},{"group":"Services \u0026 Requests","icon":"server","pages":[{"title":"Services Overview","href":"/broker/services/overview"},{"title":"Service Details","href":"/broker/services/service-details"},{"title":"Upgrade or Downgrade a Service Plan","href":"/broker/services/plan-changes"},{"title":"Cancel Services","href":"/broker/services/cancellations"},{"title":"Requests","href":"/broker/services/requests"}]},{"group":"Billing","icon":"credit-card","pages":[{"title":"Billing Overview","href":"/broker/billing/overview"},{"title":"Invoices","href":"/broker/billing/invoices"},{"title":"Payment Methods \u0026 Autopay","href":"/broker/billing/payment-methods"}]},{"group":"Reports \u0026 Analytics","icon":"chart-line","pages":[{"title":"Reports","href":"/broker/reports/reports"},{"title":"Scheduled Reports","href":"/broker/reports/scheduled-reports"}]},{"group":"Forms \u0026 API","icon":"code","pages":[{"title":"Form Center","description":"Create, publish, and manage VPS service request forms.","href":"/broker/integrations/form-center"},{"title":"Publish and Embed Forms","href":"/broker/integrations/form-embedding"},{"title":"API Center","description":"Manage integration keys, restrict network access, and review API activity.","href":"/broker/integrations/api-overview"},{"title":"API Keys","href":"/broker/integrations/api-keys"},{"title":"API Logs","href":"/broker/integrations/api-logs"}]},{"group":"Branding \u0026 Email","icon":"palette","pages":[{"title":"Brand","href":"/broker/customization/brand"},{"title":"Email Templates","href":"/broker/customization/email-templates"},{"title":"Email Settings","href":"/broker/customization/email-settings"}]},{"group":"Help \u0026 Support","icon":"life-ring","pages":[{"title":"Support Tickets","href":"/broker/support"},{"title":"FAQ \u0026 Troubleshooting","href":"/broker/faq"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api/overview"}]}]},"basePath":"","title":"Publish and Embed Forms - Broker Panel Docs","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-DXXFP6nH.js","DynamicMarkdown-B54_zNBF.js","zoom-image-lightbox-BG6oD64b.js","lightbox-handle-r17bVUz3.js"]}