Membership form integration
Configure membership forms so they are presented at the right point in the membership lifecycle. Membership forms support a form action type property that determines which lifecycle event triggers the form (such as signup, cancellation, or renewal), and a renewal form binding that links a specific form to the membership renewal flow.
Audience: Administrators who create and configure membership forms for their organization.
Before you begin
- Your organization must have active membership programs configured.
- The form must be of type Membership β action type configuration is not available on other form types.
Permission: Edit under CustomFields in the Administrator section of the security role β Required to configure membership form definitions and their action types.
Steps
Configure a membership form's action type
The form action type tells Zenoti which membership lifecycle action this form applies to. A membership form can cover one or more action types.
- Navigate to Configuration > Forms > Form creation > Custom forms.
- Select an existing membership form, or create a new form with the Membership form type.
- In the form definition settings, locate Form action type.
- Select the action type(s) this form applies to:
- Signup β Presented during new membership enrollment.
- Cancellation β Presented when canceling a membership.
- Freeze β Presented when freezing a membership.
- Upgrade/Downgrade β Presented when changing membership tiers.
- Transfer β Presented when transferring a membership to another guest.
- Renewal β Presented during membership renewal.
- Click Save.
Bind a renewal form to a membership form definition
You can link a dedicated renewal form to a membership form definition. When a membership comes up for renewal, Zenoti presents the bound renewal form to the guest instead of the standard membership form.
- Navigate to Configuration > Forms > Form creation > Custom forms.
- Select the membership form definition that should trigger a renewal form.
- In the form definition settings, locate the Renewal form field.
- Select the form that should appear during membership renewals from the dropdown.
- Optionally, configure the Membership expiry period β the number of days after which the membership form expires and must be re-submitted by the guest.
- Click Save.
Mandate form submission for a membership action
Configuring a form's action type (above) makes the form available for that lifecycle event. To make submitting a form mandatory before the action can complete, configure the mandate setting for that action:
| Action | Mandate behavior |
|---|---|
| Signup / Recurring Sale | Form required before invoice close |
| Upgrade / Downgrade | Form required before the action proceeds |
| Freeze | Form required before the freeze action |
| Cancellation | Form required at POS (Point of Sale) only (not for remote cancellation) |
| Transfer (Fixed Billing) | Form required before the transfer action |
| Add-on Member | Form required with family memberships enrollment |
| Payment Method Change | Form required before the payment method is updated |
Forms are optional per membership β you configure which memberships require forms for each action. See Notification templates and scheduled communications for the full settings reference.
To mandate the Signup / Recurring Sale form specifically:
- At the organization or center level, navigate to Configuration > Memberships.
- Select the Membership forms and notifications configuration.
- Under Sign-up of a recurring membership, enable the Mandate form submission in POS (Web and ZMA v2) toggle.
- Click Save.
Note: If your organization uses Fitness/Classes, checking in a member with an unsigned membership form can also trigger a Visits-page alert independent of this mandate setting β see Enable alerts for unsigned membership forms.
Tips
- Use separate form definitions for each action type to collect the most relevant information for each membership lifecycle event.
- When configuring a renewal form binding, ensure the renewal form has the Renewal action type set on its own definition.
- The membership expiry period is useful when compliance or consent forms need to be re-collected periodically.
Note: Settings that enforce form submission before membership lifecycle actions (for example, requiring a form before cancellation or freeze) are configured in the Memberships category. This article documents how membership forms are authored and associated in Forms, and includes the Signup mandate procedure above; the other lifecycle-action mandates and PDF sending are configured in the Memberships-owned articles below.
Related Memberships scenarios
The following membership-form scenarios live in the Memberships category because they tie the form to a membership lifecycle action. Cross-link to the specific article when a reader asks about each scenario:
| Scenario | Owning article |
|---|---|
| Make forms mandatory before signup / a recurring sale (require before invoice close) | Notification templates and scheduled communications |
| Make forms mandatory before adding an add-on member | Configure guest pass and add-on members |
| Make forms mandatory before a payment-method change on a membership | Manage recurring collections |
| Enable memberships forms organization-wide | Configure membership settings |
| Send PDF of completed form on signup, cancellation, or freeze | Configure membership notification templates |
See the Memberships overview for the entry point to each.