FormWork documentation

Sharing & Preview

Use direct links, draft previews, and production embed code safely.

The builder’s Share page provides a direct URL and website embed code for the version you are viewing.

Choose the right output

VersionDirect linkEmbedUse
PublishedLoads the latest published versionLoads the latest published versionProduction data collection
DraftIncludes the draft preview_version_idIncludes preview-version-idStaging and testing only
ArchivedUnavailableUnavailableHistoric reference only

Use the standalone link when sending a form by email or message, linking from a button, or when the destination does not allow custom HTML.

A published link has the form ID but no version ID. Publishing later updates it automatically:

https://app.useformwork.com/client/forms/FORM_ID

A draft preview is locked to one version:

https://app.useformwork.com/client/forms/FORM_ID?preview_version_id=VERSION_ID

Website Embed Code

The production snippet is:

<formwork-form form-id="FORM_ID"></formwork-form>
<script src="https://app.useformwork.com/static/client.js" type="module"></script>

The draft snippet adds preview-version-id="VERSION_ID" to the element. Paste the snippet where the form should appear. The script can define multiple <formwork-form> elements on a page.

Saved appearance is loaded automatically; no theme stylesheet is required.

Test without leaking a draft

  • Put draft embeds on access-controlled staging pages where possible.
  • Do not publish or index draft preview URLs as production links.
  • Remember that a test submission creates an entry; there is no special preview-entry status.
  • Replace the draft snippet with the published snippet before launch.

After publishing

You do not need to copy a new published link or embed after each publish. Both resolve the current published version. An entry that already began remains pinned to its original version.

For attributes, events, resume behaviour, and host controls, continue to the Web Component & JavaScript API. For styling, see Appearance.