ZenotiHelp

Manage package validity

ZTZenoti Docs Team Updated September 23, 2026 12 min readGuide

Zenoti lets you adjust a package's validity period after it has been sold β€” extending the expiry date, moving the start date forward, extending the grace period, and temporarily freezing or unfreezing the package. These operations accommodate guest needs (illness, travel, payment disputes) without requiring a new package purchase.

Audience: Front desk staff and administrators who manage guest package validity.


On this page


Before you begin

Permission: Edit under Packages in the Administrator section of the security role β€” required to extend a package's validity.

Freezing and unfreezing are controlled separately. Your role needs its own permission for each, granted under Packages, and having Edit alone does not include them: if you can open a package but see no Freeze or Unfreeze button, ask your administrator to check those two permissions for your role. Viewing Frozen History does not require either.

Specific validity actions map to dedicated permissions under Guests:

  • Extend Expiry β€” required to change a package's expiry date.
  • Extend Grace Period β€” required to extend a package's grace period.
  • Transfer Credits β€” required for credit transfers (covered in a separate article).
  • The Freeze packages organization setting must be active to use freeze and unfreeze.
  • Freeze requires the package to be in status Active; unfreeze requires status Frozen.

Note: These validity actions apply to one package at a time β€” the package details panel has no bulk option, and bulk freeze and unfreeze are not available for packages at all (bulk freeze/unfreeze is supported for memberships only.)

Access the package details

Every procedure in this article starts at the package details panel. Open it once, then follow the relevant procedure.

  1. Open the Guest Profile for the guest whose package you want to adjust.
  2. Select the Packages tab.
  3. Click the name of the package you want to adjust. The package details panel opens and shows the package's status, balance, redemption history, and the action buttons for this article's procedures.

Note β€” Balance Amount for custom packages: For custom packages, the Balance Amount field is only visible after the package invoice is closed. If you do not see a Balance Amount immediately after purchase, close the invoice first, then re-open the package details.

Tip: Keep the panel open while you work. All procedures below begin with "From the package details panel..."

From the Packages tab listing (before opening a package), the following columns are editable without opening the package:

Column Action
Expiration Click the date link to change the package expiry date (calendar picker). Requires Extend Expiry permission.
Expiration with Grace Click the date link to extend the grace period end date (calendar picker). Requires Extend Grace Period permission.
Invoice Click the invoice number link to view the package sale invoice.

Extend expiry date

Extending the expiry date gives the guest additional time to redeem remaining package benefits.

  1. From the package details panel, click Extend Expiry.

  2. Select the new expiry date, or select Never expires to remove the expiry date altogether.

    The date you select cannot be earlier than the date the guest bought the package. If the guest has already redeemed a benefit, it cannot be earlier than their most recent redemption.

  3. Add a comment explaining the reason for the change.

  4. Click Save.

Note: If the package is paid by scheduled payments and the date you select falls before the last scheduled payment, Zenoti asks you to confirm before saving. Moving an expiry date earlier immediately shortens the window in which the guest can redeem benefits they have already paid for β€” confirm the change with them first.

No audit viewer surfaces extend-expiry events directly β€” the comment you enter is retained on the package record for internal reference.

Change start date

Move a package's start date forward when the guest hasn't begun using it yet.

  1. From the package details panel, click Change Start Date.
  2. Select the new start date.
  3. Click Save.

Important: You can only change the start date of a package that has no existing redemptions. If the guest has redeemed any benefit, Zenoti blocks the change and shows an error referencing the existing redemption date.

Extend grace period

The grace period is an additional window after the expiry date during which redemption is still allowed for a package that is configured with a grace period.

  1. From the package details panel, click Extend Grace Period.
  2. Select the new grace period end date.
  3. Click Save.

Note: The Extend Grace Period button appears only on packages that have a grace period configured at the package level. If the button is missing, the package does not have grace-period support in its definition.

Freeze a package

Freezing a package temporarily pauses the validity period. While frozen, the guest cannot redeem benefits, the validity clock stops counting down, and any scheduled-payment collections on the package are paused until the package is unfrozen.

Important: Each package has a maximum freeze count configured at the package definition level. Once that count is reached, Freeze is disabled for the package.

  1. From the package details panel, click Freeze. The Freeze Package popup opens.

  2. Choose how the package should unfreeze β€” select one of three options:

    Option Description
    Unfreeze on Select a specific calendar date. Zenoti automatically unfreezes the package on that date.
    Unfreeze after Enter the number of days after which the package automatically unfreezes.
    Manual unfreeze Do not select an automatic option. A staff member must manually unfreeze the package later (see Unfreeze a package).
  3. Enter a comment explaining the reason for the freeze.

  4. Click Save and Proceed.

Note: Zenoti checks the freeze count against the package's configured maximum. If the limit is reached, the freeze is blocked with an error. Otherwise the package status changes to Frozen, the validity clock pauses, and any pending scheduled-payment collections are suspended (see Configure scheduled payments).

Zenoti records the selected unfreeze date or duration and reactivates the package automatically if an automatic option was chosen. Automatic unfreeze aligns with membership freeze behavior for consistent handling across the platform.

Unfreeze a package

Unfreezing resumes the validity period and re-enables redemption.

  1. From the package details panel, click Unfreeze.
  2. Optionally enter a number of days to extend the package, compensating the guest for the frozen period.
  3. Click Confirm.

Note: The compensation days value has no system-imposed maximum β€” enter whatever your policy requires. If you leave it blank, no compensation is added. The package status returns to Active, the validity clock resumes, and previously-paused scheduled-payment collections resume (see Configure scheduled payments).

View Frozen History

Every freeze and unfreeze action for a package is recorded in its Frozen History view.

  1. From the package details panel, click the Frozen History link.
  2. The Package Frozen History modal opens and lists each freeze/unfreeze event with the action date, the staff member who performed the action, and the comment entered at the time.

Note: Frozen History is the only audit surface in the package details panel. Extend Expiry, Change Start Date, and Extend Grace Period actions are recorded in the package's underlying transaction records but do not have a dedicated audit viewer in the UI.

Note: The Frozen History link appears whether or not the package has ever been frozen β€” on a package that has never been frozen it opens an empty history. The link is not shown at all when the package is closed, refunded, or past its grace period without being frozen, or when the package is of a type that does not support freezing. If you expected the link and it is absent, check the package's status first rather than assuming no history was kept.

Automatic freeze on payment disputes

When a payment dispute is raised on a collected payment, Zenoti automatically freezes the associated package. While frozen, the package status displays as Frozen and all freeze behaviors apply (validity paused, redemption blocked, scheduled payments paused).

Payment dispute resolution β€” three outcomes

Dispute outcome Package behavior
Business wins the dispute Package automatically unfreezes; paused scheduled payments resume
Guest withdraws all disputes related to the package Package automatically unfreezes; paused scheduled payments resume
Guest wins any dispute Package remains frozen for manual review β€” staff must manually unfreeze (protective default)

The "Enable automatic unfreeze if business wins dispute" sub-setting (Default: On) in the freeze rules configuration controls automatic unfreeze for the first two outcomes above. If this sub-setting is off, the package remains frozen even when the business wins β€” staff must unfreeze manually.

No guest notification is sent by default when an automatic freeze or unfreeze occurs β€” the package state is visible to staff in the package details panel, and your payment gateway's own notifications cover the dispute lifecycle.

Automatic freeze on payment failure

When a scheduled payment attempt fails, Zenoti automatically freezes the associated package. The package remains frozen until the failed payment is successfully collected.

The "Enable automatic unfreeze when payment conditions met" sub-setting (Default: On) in the freeze rules configuration controls whether the package automatically unfreezes when the failed payment is later collected. If this sub-setting is on, the package automatically unfreezes on successful payment recovery without staff intervention.

For freeze rule configuration (including how to enable these settings), see Configure package settings and Configure scheduled payments.

View package redemption status

You can view the status of each package redemption invoice from the guest profile or from the Appointment Book.

From the guest profile:

  1. Open the Guest Profile for the guest.
  2. Select the Packages tab.
  3. Click the name of the package to open the package details panel.
  4. Each service redemption shows its invoice status.

From the Appointment Book:

  1. Open the Appointment Book.
  2. Open the Booking Panel for the relevant appointment.
  3. Select the Service tab.
  4. The redemption invoice status is shown for each service.

Note: Invoice numbers are clickable links β€” click to view further details on the invoice.

Redemption invoice statuses:

Status Meaning
Open Invoice is created but not yet closed.
No Show Guest did not attend the appointment.
Cancelled Appointment was cancelled.
Closed Service was rendered and the invoice is closed.
Closed (No Show) Invoice closed after a no-show event.
Closed (Cancelled) Invoice closed after cancellation.

Note: These are redemption invoice statuses, distinct from the package-level statuses (Active, Frozen, Expired, Inactive, Active (Refunded), Refunded, Closed) shown in the Packages tab.

View forms associated with a package

You can view and print forms associated with a guest's package from the package listing in the guest profile.

Primary path:

  1. Open the Guest Profile for the guest.
  2. Select the Packages tab.
  3. In the Form column next to the package, click View.

Alternate path:

  1. Click the name of the package to open the package details panel.
  2. Click the Forms link.
  3. To view a specific form, click its name. To print a form, click the print icon next to it.

This feature is available for both series and custom packages.

Worked example

A guest buys a 6-month series package on January 1. The package has a maximum freeze count of 3 and no configured grace period. On April 1, three months in, the guest breaks their arm and asks you to freeze the package for 2 weeks.

  1. Freeze the package on April 1. Access the package details, click Freeze, enter a comment ("Guest injured β€” 2-week pause requested"), and click Confirm. The status changes to Frozen. The expiry date (originally June 30) stops advancing.
  2. Unfreeze on April 15. Access the package details, click Unfreeze. In the compensation-days field, enter 14 (matching the frozen period). Click Confirm. Status returns to Active, and the new expiry date becomes July 14 (original June 30 + 14 days).
  3. Confirm the audit record. Click Frozen History. The modal shows both the freeze on April 1 and the unfreeze on April 15 with your staff name and the comment you entered.

If the same guest later needs two more 1-week pauses during the remaining validity, you can grant them β€” that uses up the package's remaining freeze count (2 more, totalling 3). A fourth freeze attempt is blocked with an error.

Tips

  • Before you freeze, confirm with the guest the expected return date so you can enter a realistic compensation value when unfreezing. This avoids repeat adjustments.
  • The comment field is internal. Write for the next staff member who opens the package, not for the guest β€” guests do not see this text.
  • If a guest expects to be away longer than one freeze's worth of goodwill and the package has a low configured maximum freeze count, consider an Extend Expiry (which does not consume a freeze slot) instead of a Freeze.
  • For packages with scheduled payments, freezing pauses collections. Let the guest know so they aren't surprised when collections resume after the unfreeze.

Troubleshooting

Symptom Cause and resolution
Freeze button is disabled on an Active package. The package has reached its maximum freeze count. Open Frozen History to see how many freezes have occurred. If the guest needs an exception, escalate to a manager β€” there is no in-UI override; the package-definition maximum governs.
Change Start Date is rejected with "Cannot change start date since there exists a package redemption on [date]." The package has at least one redemption. Start-date changes are only permitted before any benefit is redeemed. If the guest needs relief for an unredeemed package, use Extend Expiry instead.
Extend Grace Period button is missing. The package was configured without a grace period. Grace period is a package-definition attribute, not a runtime option. Consider Extend Expiry as an alternative.
Package remains stuck in Frozen status after a dispute was closed. Automatic unfreeze triggers on dispute resolution from your payment gateway. If the gateway has confirmed the dispute was resolved in your favor but the package is still Frozen, check the payment gateway integration logs with your administrator. As a workaround, use the manual Unfreeze action.
*Expiry date change is rejected with "Enddate can be a date after purchase date or redemption date".* The date selected is earlier than the package's purchase date, or earlier than the guest's most recent redemption. Choose a date on or after whichever is later.
Compensation days field is ignored on unfreeze. The compensation value is only added if the package was previously Frozen. If the package was in any other status at the time of unfreeze (which should not normally happen), the value is ignored. Refresh the package details panel and confirm the current status.

Developer / Webhook reference

Integration developers can subscribe to the following webhook events to track package validity changes externally. These events are for integration audiences only and are fired when the Event Management System is enabled for the organization.

Event Fires on Payload Typical use
Guest.Package.Validity.Updated Extend Expiry, Change Start Date, Extend Grace Period user_package_details Sync package validity changes to an external scheduling or CRM system.
Guest.Package.Status.Updated Freeze, Unfreeze, Automatic freeze/unfreeze, Closed user_package_details Track package lifecycle state changes in downstream analytics or reporting.

See the Zenoti APIs documentation for event payload details and subscription setup.

Integration developers can also read a package's freeze history directly: GET /v1/guests/{guest_id}/packages/{package_user_id}/frozen_history. Companion routes exist for freezing and unfreezing a package. See the Zenoti APIs documentation for request and response details.

Was this article helpful?
Your feedback helps us improve our documentation.