Integrate a Form Into External Website

You can embed any Solidarity Tech page on an external website. The embed automatically resizes to fit its content, and form submissions work the same as they do on your Solidarity Tech site.

Embedding a page

1. Open the page in your dashboard and go to Page Settings.
2. Find the Embed Code field and click Copy.
3. Paste the code into your website's HTML.

The embed code looks like this:

<iframe data-st-embed src="https://your-site.solidarity.tech/page-url/embed" allow="payment *" style="width:100%;border:none;min-height:500px;" title="Your Page Title"></iframe>
<script src="https://your-site.solidarity.tech/embed/v1.js" async></script>

It has two parts: the iframe displays your page, and the script makes the frame automatically resize to fit its content. Keep both. If you embed multiple pages on the same website page, include the script tag once; it handles every embed on the page.

Where to paste it:

WordPress: Add a Custom HTML block.
Squarespace: Add a Code block.
Wix: Add an Embed Code element.
Webflow: Add an Embed element.
Other platforms: Paste anywhere the platform accepts custom HTML.

By default the embed shows only the form. Forms submitted through an embed record the same data as regular submissions, and UTM parameters on the host page's URL are automatically carried into the submission.

Options

You can customize the embed by adding URL parameters to the iframe src:

?full=true: Also shows the page's title, image, and content above the form.

?breakout=true: Redirects the entire host page after submission instead of just the embedded frame. If your page's "Redirect To" setting points anywhere other than the default thank you page or the share overlay, this parameter is already included in your embed code, because those destinations can't display inside the embedded frame.

?only_event_session_ids=123,456: For event pages, limits which sessions appear in the embedded RSVP form. To find a session's ID, click edit on the session in your event's dashboard and copy the number from the URL (/events/…/calendars/SESSION_ID/edit).

Combine parameters with &, for example /embed?full=true&breakout=true.

If your website builder strips script tags

Some platforms remove <script> tags from custom HTML. In that case, use just the iframe part of the embed code and give it a fixed height:

<iframe src="https://your-site.solidarity.tech/page-url/embed" style="width:100%;border:none;" height="900"></iframe>

The form will work normally, but the frame won't resize automatically.

If the platform only accepts a link (not HTML), link directly to the page's /embed URL or to the page itself.

Troubleshooting

"Refused to connect" when clicking links inside the embed

If you embed a page with clickable elements (like an events calendar), clicks inside the frame may show "refused to connect."

1. Enable "Hide Navbar" in Page Settings to remove navigation links from the embed
2. Add ?breakout=true to the iframe URL so clicks redirect the full page instead of the frame
3. Create a dedicated page for embedding that removes elements that navigate away

Form doesn't submit or shows errors

1. Make sure your iframe URL ends with /embed (e.g., yoursite.solidarity.tech/join/embed)
2. Check that your external site allows third-party cookies (some browsers block them by default)

Donation pages

Card payments and 3D Secure verification work inside embeds.

For developers

The embed emits DOM events on the iframe element that you can use for analytics on the host page: st:embed:loaded fires when the embed finishes loading, and st:embed:submitted fires after a successful form submission. Both events bubble, so you can listen on document.

Embeds inserted after page load (single-page apps, tag managers, or content swapped in by a framework) are detected and activated automatically. If you want to trigger it yourself, call SolidarityEmbeds.load() after inserting the iframe, and SolidarityEmbeds.resize() to force a re-measure.

Legacy manual resize script

Before the embed code was available in Page Settings, auto-resizing required pasting a script into the page's Head HTML and a matching listener on the external site. Existing setups using the solidarity-tech-resize script continue to work unchanged. New embeds don't need it; the embed code from Page Settings handles resizing automatically.