Package Form Association
Associate a published form of type Package with a package or package template so that the form is automatically required at the point of sale.
Audience: Administrators who configure packages and manage form associations.
On this page
- Before you begin
- Steps
- Series packages only β offer packages are not supported
- How package form association differs from membership form association
- Tips
- Troubleshooting
- Related articles
Before you begin
- You must have an existing series package or series package template in Zenoti to associate a form with. The Forms tab is only available for series packages and series package templates β it is not presented for offer packages. See Series packages only β offer packages are not supported below.
- The form you want to associate must be published and its form type must be set to Package. Forms of any other type do not appear in the Available Forms dropdown on the package Forms tab.
- Verify that the correct form type is selected in the form definition before proceeding. If you need to create or update a form, see Create and manage custom forms.
Permission: You need the Edit permission under Packages in the Administrator section of the security role to associate a form with a package or package template. This is the same permission that governs modifying any other aspect of a package definition. No forms-specific permission is required for this task.
Steps
Open the package definition
- Navigate to Configuration > Packages.
- Locate the series package or series package template you want to update.
- Select the package to open its definition.
- Select the Forms tab within the package definition.
Associate a form with the package
On the Forms tab, locate the Available Forms dropdown.
Select the form you want to associate from the Available Forms dropdown.
Note: The Available Forms dropdown displays only published forms whose form type is set to Package. If the form you need does not appear, verify that the form is published and that its form type is Package before returning to this step.
Click Add to create the form association.
The form now appears in the list of forms associated with this package. The association is written immediately when you click Add β no further save action is needed to persist it.
Important: Once a form is associated with a package, it is automatically required at the point of sale. The invoice cannot be completed until the associated form is filled and signed. There is no separate toggle to make the form optional β association and requirement are the same action for packages.
Worked example: You manage a "Deep Tissue Massage Package" (a series package) that requires guests to complete an intake form before checkout. You navigate to Configuration > Packages, open the "Deep Tissue Massage Package" definition, and select the Forms tab. In the Available Forms dropdown, you select "Massage Intake Form" (a published form with form type Package) and click Add. The association is saved immediately. The next time a guest purchases this package, the cashier cannot close the invoice until the guest has filled and signed the Massage Intake Form.
Series packages only β offer packages are not supported
The Forms tab is available only for series packages and series package templates. It is not offered for offer packages, and the Available Forms dropdown does not appear in the offer package definition regardless of the operator's permissions or whether a suitable form exists.
This is a package-type constraint, not a form-type or permission constraint. Even if you have the Edit permission under Packages and the form is published with form type Package, you cannot associate a form with an offer package through the package definition.
If you need a signed agreement for a guest purchasing an offer package, send the form to the guest outside Zenoti as the only available workaround.
How package form association differs from membership form association
Package form association and membership form association work differently. Understanding the distinction helps you configure form requirements correctly across your organization.
The table below summarizes the key differences:
| Aspect | Package forms | Membership forms |
|---|---|---|
| Where forms are associated | Series package definition Forms tab | Membership definition, per lifecycle action |
| When the form is required | At the point of sale, before invoice close | At specific lifecycle actions (sign-up, cancellation, freeze, and so on) |
| Mandatory vs. optional toggle | No toggle β association always makes the form mandatory | Configurable per lifecycle action: "require before invoice close" can be enabled or disabled |
| Form type required | Package | Membership (or the action-specific type) |
| Supported package or membership types | Series packages and series package templates only | All membership types |
Note: For membership-specific form enforcement and PDF sending during lifecycle actions, see Memberships overview.
About field-level required validation
Making individual fields within a form required β so they cannot be submitted blank β is a separate, independent setting. You configure field-level required validation inside the form builder, on a per-field basis.
Field-level required validation and package-level form association are independent of each other:
- Associating a form with a package makes the form as a whole mandatory at the point of sale. The invoice cannot close until the form is filled and signed.
- Enabling required validation on individual fields prevents those fields from being submitted blank, but does not by itself make the form mandatory at checkout. Only associating the form with the package does that.
You can use both settings together: associate the form with the package (to gate invoice close), and mark specific fields as required within the form builder (to prevent incomplete submissions).
Tips
- Before associating a form, open it in the form builder and confirm it is published and set to form type Package. A form that is in draft status or set to a different form type will not appear in the Available Forms dropdown.
- You can associate more than one form with the same package. Each associated form will be required at the point of sale before the invoice can be closed.
- The Forms tab is only available on series packages and series package templates. If you do not see the Forms tab when editing a package, check whether the package is an offer package β the tab is not presented for offer packages.
- If you want to gate invoice close for memberships in a similar way, that configuration is done separately at the membership level per lifecycle action β not on this tab. See Memberships overview for details.
- To update or retire a form that is already associated with a package, unpublish or update the form definition and then return to the package Forms tab to manage the association.
- Review the form in the form builder before associating it with a package to confirm the guest experience matches your expectations.
Troubleshooting
The form I need does not appear in the Available Forms dropdown.
The Available Forms dropdown only shows forms that meet both of the following conditions:
- The form's status is Published (not Draft or Deprecated).
- The form's type is set to Package.
To resolve this, navigate to Configuration > Forms, open the form definition, verify that the form type is Package, and publish the form. Return to the package Forms tab and check the dropdown again.
I am editing a package but there is no Forms tab.
The Forms tab is only available for series packages and series package templates. Offer packages do not have a Forms tab, and the Available Forms dropdown does not appear for them. Confirm the package type:
- Navigate to Configuration > Packages and open the package definition.
- Check whether the package is configured as a series package or an offer package.
- If the package is an offer package and you need a signed agreement, send the form to the guest outside Zenoti β there is no in-product workaround for offer packages.
Guests can still complete checkout without filling the associated form.
Confirm that the form association was created correctly:
- Navigate to Configuration > Packages and open the package definition.
- Select the Forms tab and verify that the form appears in the list of associated forms.
- If the form is not listed, repeat the association steps β click Add to persist the association.
If the form is listed but checkout is not gated, contact your Zenoti administrator to confirm that no configuration at the center level is affecting point-of-sale form enforcement.
I associated the wrong form with the package. How do I remove it?
Navigate to Configuration > Packages, open the package definition, and select the Forms tab. Locate the form in the associated forms list and remove it from the association. Then repeat the association steps with the correct form.