A timezone provides the regional context for date and time values. The same moment in time can appear differently across locations.

For example, a transaction that happens at a single instant may appear as:

16 December 2025, 14:30 in India
16 December 2025, 17:00 in Singapore
16 December 2025, 09:00 in London

Although the clock time differs, it represents the same event.

To manage this consistently across regions, systems use a common reference time (UTC). Each region expresses its local time as an offset from UTC (for example, +05:30 or +08:00).

Timezone Concepts in Capillary

Capillary uses two key timezone references:

Organization timezone
Server timezone

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

Organization timezone

The organization's 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.

For example, if your organization's timezone is in IST, the listing pages display the time in IST.

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.

Timezone Selection in the UI

In certain modules, you can explicitly select the timezone during configuration.

Where supported:

A timezone dropdown is available
The list uses IANA timezone format (for example, Asia/Shanghai, Europe/London, America/New_York)
The selected timezone defines the local time context for that configuration

Example

When creating a promotion:

You can select Asia/Shanghai from the dropdown
The promotion schedule (start and end date) is interpreted in that timezone
The listing and detail pages reflect that selected timezone context

This allows brands operating across regions to configure time-based logic in the appropriate local timezone.