Custom Form Instances β Route for Guest Profile Forms
Guests and staff who share direct links to guest profile form instances can use two URL routes to reach them through the Webstore. This article explains how the forminstances route works alongside the existing guest custom form route, so that deep links to guest profile forms resolve correctly.
Audience: Administrators and staff who share direct links to guest profile form instances, and guests who follow those links to complete forms through the Webstore.
On this page
Before you begin
- Your organization must have custom forms configured and associated with guest profiles. For form builder and field setup, see topic.
- The Webstore must be active for your organization.
- The form instance link must be generated from the guest profile in the Zenoti admin portal. Links cannot be created manually.
Steps
Understand the two supported routes
The Webstore serves the guest custom form module at two routes:
webstoreNew/guestcustomformβ the original route for guest profile formswebstoreNew/forminstancesβ an additional route that resolves the same module
Both routes load the same guest profile form experience. The webstoreNew/forminstances route was added so that direct links to specific form instances resolve correctly when shared with guests.
Note: If a guest follows a link and lands on a blank page or an error, the most likely cause is that the link uses an unsupported route pattern. Verify that the link uses one of the two routes listed above.
Share a form instance link
- Sign in to the Zenoti admin portal and open the guest profile for the relevant guest.
- Navigate to the form instance you want to share.
- Copy the direct link to the form instance. The system generates a link using the
webstoreNew/forminstancesroute. - Send the link to the guest by email or SMS.
Note: The guest must be signed in to their Webstore account, or the link must include the authentication token required to open the form. Guests who are not signed in are prompted to sign in before the form loads.
Confirm the link resolves correctly
- Open the copied link in a browser.
- Confirm that the form loads as expected.
- If the form does not load, check that the link uses either
webstoreNew/forminstancesorwebstoreNew/guestcustomformas the route prefix.
Worked example: A staff member copies a link to a health intake form for a guest named Maria. The generated link is
https://yourwebstore.com/webstoreNew/forminstances?formInstanceId=abc123. Maria receives the link by email, taps it, signs in to her account, and the form opens directly.
Tips
- Always use links generated by the Zenoti admin portal rather than constructing links manually. The system produces the correct route and includes the required identifiers.
- If your organization sends form links through automated notifications, verify that the notification template uses the
webstoreNew/forminstancesroute. For notification template customization, see Notifications and confirmations. - After sharing a form link, allow up to 30 minutes for any related configuration changes to propagate across the Webstore before testing.
- Test form instance links from a guest account before distributing them broadly to confirm the correct form loads.
Troubleshooting
| Problem | Resolution |
|---|---|
| Guest reports the link shows a blank page | Confirm the link uses webstoreNew/forminstances or webstoreNew/guestcustomform. Links using any other route pattern are not supported and will not load the form. |
| Guest is taken to the sign-in screen instead of the form | This is expected behavior when the guest is not already signed in. Ask the guest to sign in to their Webstore account; the form will load after authentication. |
| Form loads but displays the wrong form instance | Verify that the link was copied directly from the correct form instance in the guest profile. A link copied from a different form instance will open that form instead. |