Embed a form
What is embed?
Display a published RapidoForm on your website using its public respondent URL or the widget code generated by the builder. Embeds do not use X-API-KEY or X-EMAIL.
How to embed
- Finish and review the form, then publish it (status Collecting).
- Open Share → Embed in the builder.
- Select a full form or a question and choose inline, popover or side tab.
- Copy the generated code into your site’s HTML area. Use the platform-specific option when embedding in a site builder.
- Test the page as a respondent, including a mobile screen. Confirm that a test submission appears in your reports.
Prefer the code generated by your form’s Share screen, which supplies the correct host, form ID and options.
Inline iframe example
Replace 12345 with your published form ID. The production respondent surface is hosted on www.rapidoreach.com; use the exact share URL produced by your builder if your deployment uses another host.
<iframe
src="https://www.rapidoreach.com/sn/navigator?surveyId=12345&lang=en"
title="Customer feedback form"
width="100%"
height="600"
style="border: 0;"
allow="camera; microphone; payment"
></iframe>
Give the frame enough height for your questions and an accessible title. Camera and microphone questions require HTTPS and browser permission. Do not include preview=true for real submissions; previews are excluded from respondent reports.
Widget code
The builder generates a RORSurveyToolWidget element with surveyId and lang attributes, a bundle.css stylesheet and a bundle.js script from the configured respondent host. Embed types are inline, popup (popover) and sidedrawer (side tab). A single-question embed also includes questionId. Copy these together from Share; do not place an API key in the markup.
Email clients generally block scripts and iframes. Use the builder’s Embed in an email option for email-safe content that links respondents into the form.
Troubleshooting
If the form does not load, check its published status, the exact share URL and your site’s Content Security Policy frame/script rules. For recording questions, check browser permission and the iframe’s allow attribute. If you cannot scroll through the form on mobile, increase the iframe height or use the generated responsive widget.