Export Scheduling & Timing Guide

Widget Exports are deprecated. Existing widget exports keep running for now, but don't set up new ones: use Export Pipelines instead. To move an existing widget export, see Migrating from Legacy Exports to Export Pipelines.

This guide explains when each type of Clarisights export runs, how timezones apply, and how to choose a schedule that delivers complete data.

Export Pipelines

Each schedule of an export pipeline runs on the Cadence you pick in the schedule editor. Users with the Admin or Data Manager role set and change it themselves.

Cadence	Runs
Hourly	Every hour, at the minute you pick
Every N hours	Every 2, 3, 4, 6, 8 or 12 hours, from the first run time you pick
Daily	Once a day, at the time you pick
Weekly	On the days you pick, at the time you pick
Custom cron…	Any other cadence, as a cron expression. For example, 0 5 1 * * runs at 5:00 on the first day of every month (there is no monthly option in the list).

A schedule can run at most once an hour.

• Timezone: The cadence and the date range are both read in the schedule's Timezone. Company default follows your company timezone. Under the cadence, Next runs lists the next five run times in that timezone.

• Date range: Under Date range per run, pick a Preset (such as Yesterday or Last 7 Days) or Custom range…. Resolves today to shows the dates a run would cover today.

• Delivery: The export starts at the scheduled time. Files appear in your bucket once the run has finished, which takes longer for large extracts and long date ranges.

• Extra runs: Publishing a pipeline that has a schedule, or adding a schedule to a live pipeline, usually starts an export right away, on top of the regular cadence. If it doesn't start, the first export runs at the next scheduled time.

• Several runs: A pipeline can have several schedules, for example a daily export of yesterday and a weekly export of the last 30 days.

Important: A new schedule starts as Hourly with Last 7 Days, which re-exports the last 7 days every hour: 24 sets of files a day. Most teams need Daily, so change the cadence before you save.

See Managing Export Schedules for every schedule setting, including Run now and the file name template.

Widget Exports (Legacy)

Each widget export runs at a chosen hour, in your company's timezone, and then repeats every few hours:

Setting	Default	Description
Export hour	0 (midnight)	The hour of the day (0 to 23) to run, in your company's timezone
Interval	24 hours	The number of hours between runs (1 to 24)

A file usually arrives within a couple of hours of the scheduled hour, depending on the size of the widget.

Data Exporters (Legacy)

Data Exporters run once a day at a fixed time set by Clarisights. They can include a second daily run that re-exports only the last 3 days, which is useful when your systems need fresher data without waiting for the next full export. Contact us if you need to know or change when your Data Exporters run.

Choosing the Right Time

• Let the data arrive first. Clarisights imports data from your channels several times a day, and channels keep updating recent days (for example late conversions). To export a complete previous day, schedule the export later in the morning rather than right after midnight.

• Re-export recent days. If your numbers for recent days change after the first export, use a date range that covers the last few days and let each export replace those days in your warehouse. For Export Pipelines, pick Custom range… with Start of window -3d and End of window -1d for the last 3 full days, or use Last 7 Days.

• Match timezones. Dates in the export follow the schedule's timezone (Export Pipelines) or your company's timezone (legacy exports). Use the same timezone in your warehouse to avoid off-by-one-day differences.

Common Questions

Can I change when my export runs?

Yes. For Export Pipelines, users with the Admin or Data Manager role change it themselves:

1. Click Export pipelines in the left sidebar and open the pipeline.

2. On the Schedules tab, click Edit on the schedule.

3. Change the Cadence or the Timezone, then click Save schedule.

For widget exports and Data Exporters, click ? at the bottom right of Clarisights and choose Send us a message, and tell us the new time you need.

My export didn't arrive today. What should I check?

For Export Pipelines, start with the Runs tab. Clarisights sends no email or Slack alerts, so failures only show in the app.

1. Click Export pipelines in the left sidebar. If a pipeline needs attention, a banner at the top says so (Last run failed or Destination deleted).

2. Open the pipeline and go to the Runs tab. If the run is Failed, click it to read the error message and use Retry once you've fixed the cause. If it is still Running, allow time for it to finish.

3. If there is no run at the expected time, check on the Schedules tab that the schedule and the pipeline aren't paused, the destination wasn't deleted, and the next run time and timezone are what you expect.

4. If the run Succeeded, click it to see the folder and the file for each extract, and check that you are looking at that folder in your bucket.

5. If the run failed with an access error, check the bucket permissions with Test connection. See Configuring Export Pipeline Destinations & Permissions.

For legacy exports, check the time and timezone, and allow time for the export to finish. If the file is still missing, contact us with the widget or channel name and the expected time, and we will check the run for you. More causes and fixes are in Troubleshooting Export Failures.