Embedded Form Troubleshooting: Blank Frame, Scrollbars and More
The Frame Is Empty or Says "Page Not Found"
- The form is not published. Open the form in BeeForm and click Publish. If the button says Publish changes, click it to put your latest edits live.
- The link ID is wrong. The ID in
/embed/YOUR-LINK-IDmust be the last part of the form's share link. Copy the code again from the Your form is live window. - You used the normal form link. Other websites cannot show it inside a frame. Use the embed address, which has
/embed/in it.
The Form Shows a Scrollbar or Is Cut Off
The helper script resizes the iframe. If it is not running, the iframe keeps its starting height.
- Check that the
<script src="https://beeform.co/embed.js" async></script>line is on the page, as well as the iframe. - Some website builders and security plugins remove script tags from pasted HTML. If yours does, look for a setting to allow scripts or use its "custom code" area. Otherwise set a taller
heighton the iframe by hand, such asheight="900". - Keep
scrolling="no"on the iframe so a second scrollbar does not appear while the form is resizing.
The Form Is Too Tall With Empty Space
The script sets the height to match the form, so empty space usually means the page sets its own height on the iframe. Remove any fixed height from your own CSS for that iframe, and do not put it in a container with a fixed height.
The Browser Says It Refused to Connect
Your own website can limit which sites it is allowed to show in frames. If your site sends a Content-Security-Policy header with a frame-src or default-src rule, add https://beeform.co to it. Website builders and security plugins can add this rule for you, so look in their security or "allowed sources" settings.
A Dark or Light Box Appears Around a Frame
Framed forms use a see-through background so the frame's shadow lands on your page. A solid box shows when the iframe's color-scheme does not match the embed's theme.
- Keep
color-schemein the iframe'sstyleas the generator wrote it. - If you changed the theme by hand, change
color-schemeto match:light,darkorlight darkfor Auto. - Popup buttons set this for you.
The Popup Button Does Not Appear
- The button appears where the script line is pasted. Make sure the line is inside the page body and that it was not removed by your builder.
- Check that
data-beeform-popuphas your link ID and that the script address ishttps://beeform.co/embed.js. - Make sure the form is published.
My Changes Do Not Show
The embedded form always shows your latest published version. After you change a form in BeeForm, click Publish changes. Then reload the page. Changes to the code itself, such as a new frame, need the new code pasted into your page.
Questions About Privacy and Cookies
- The embed does not show BeeForm's own cookie banner or load its site analytics scripts inside your page.
- Views, starts and submissions of the form are still counted in the form's BeeForm analytics, without cookies. Visitors who send a Do Not Track or Global Privacy Control signal are not tracked.
- Your own site's cookie notice and privacy policy still apply to the page that holds the form. Mention the form in your privacy policy if it collects personal details.
Tips and Best Practices
- Test the page in a private window and on a phone after you paste the code.
- Always copy the code from the Your form is live window instead of retyping it.
- Keep a note of which pages hold which form, so you remember to publish changes.
Common Pitfalls to Avoid
- Do not change the address in the iframe to anything other than the embed address.
- Do not wrap the form in a container that hides overflow with a fixed height.
- Do not forget to publish after you edit the form.