What Timezone Handling means in Capillary

In Capillary, date and time values are used across promotions, rewards, events, reporting, and MemberCare. To ensure these behave consistently across regions, Capillary follows a structured approach to timezone handling.

At the core of this approach are two reference timezones:

• Organization timezone
• Server timezone

Each serves a specific purpose and is applied consistently across the platform.

Organization timezone

The organizations timezone represents the headquarter timezone for your business.

• It reflects where your organization primarily operates.
• It is used for displaying dates and times in the UI.
• It is the reference timezone for scheduling promotions, campaigns, and journeys.

Server timezone

The server timezone is based on where the Capillary server cluster is located.

• Each cluster uses the timezone of the region it operates in.
• This timezone is used for processing and storing events and transactions.
• It ensures consistent and reliable system behaviour within that cluster.

In simple terms, the server timezone defines how time is processed internally by the system.

Where organization timezone and server timezone are used

The way date and time values are interpreted in Capillary depends on whether timezone standardization is enabled for your organization.

Earlier, timezone handling evolved organically across different modules. As a result, date and time values were displayed and processed using a mix of organization timezone and server timezone. This made it difficult to predict how time would appear across the platform. Timezone standardization introduces a clear and consistent model for how timezones are applied. Once enabled, each module follows a defined timezone behaviour, making date and time handling predictable and easier to understand.