Configure analytics subscriptions
This article explains the licensing requirements, subscription levels, and data refresh behavior for Analytics β Amazon S3.
Before you begin
- Contact your Zenoti account representative to confirm your licensing entitlements.
- Decide on your data scope (organization, zone, or center level) before requesting access.
License requirements
Analytics β Amazon S3 requires two licenses:
| License | Role |
|---|---|
| Analytics Plus | Base license required for all S3 Data Share functionality |
| S3 Data Share add-on | Paid add-on that enables the S3 bucket export feature |
Both licenses must be active for data delivery to your S3 bucket. If either license lapses, data refreshes pause until the license is reinstated. Contact your Zenoti account representative to purchase or renew licenses.
Subscription levels
An S3 Data Share subscription defines the scope of data delivered to a specific S3 bucket. Zenoti offers three subscription levels:
Organization
An organization-level subscription delivers data for every center in your organization to a single S3 bucket. This is the broadest subscription level and is appropriate for central analytics teams or data warehouses that need a complete view of the business.
Data included:
- All centers in your organization.
- All dimension, fact, and consolidated tables.
- All org-level reference data (campaigns, categories, discounts, and more).
Zone
A zone-level subscription delivers data for all centers in a specific zone to a dedicated S3 bucket. Use this level when different geographic regions or business units need isolated analytics environments.
Data included:
- All centers assigned to the selected zone.
- Zone-filtered transaction and operational data.
- Org-level reference dimension tables replicated for completeness.
Center
A center-level subscription delivers data for a single center to a dedicated S3 bucket. Use this level for franchise models where individual owners need access only to their own center's data.
Data included:
- The single center's transaction and operational data.
- Org-level reference dimension tables replicated for completeness.
Data refresh scheduling
Data refreshes run automatically after onboarding is complete. You do not need to trigger or schedule them manually.
| Phase | Timing |
|---|---|
| Initial full load | Runs once during onboarding; delivers all available historical data |
| Incremental refreshes | Run automatically every 1β2 hours after the initial full load |
Each refresh cycle creates a new GroupID folder in your S3 bucket containing only the records that were created, updated, or deleted since the previous cycle. See S3 folder structure and file format for details on how GroupIDs are organized.
Exact refresh timing may vary depending on data volume and system conditions. There is no user-facing dashboard that shows current refresh status.
Note: If your bucket contains a GroupID folder ending in
_processing, that refresh cycle is still in progress. Do not query data from folders with the_processingsuffix.
What happens when a subscription is activated
When Zenoti activates your S3 Data Share subscription, the following sequence occurs:
- Bucket provisioning β Zenoti creates and configures your S3 bucket and provides you with access credentials.
- Schema files deployed β The SchemaFull folder is populated with schema definition files for all tables included in your subscription.
- Initial full load β A full load of all historical data is delivered to GroupID 1. Depending on your organization's data volume, this may take several hours.
- Incremental refreshes begin β After the initial full load is complete, incremental refresh cycles start running automatically on the standard 1β2 hour cadence.
Requesting changes to your subscription
Subscription scope and scheduling are managed by the Zenoti Implementation team. You cannot change these settings through the Zenoti admin portal. Contact the Zenoti Implementation team to:
- Add a new zone-level or center-level subscription.
- Change the scope of an existing subscription.
- Add or remove centers from a zone subscription.
- Request changes to refresh scheduling (non-standard schedules may be available for enterprise agreements).