Skip to content

Sync Progress

When you run a full sync, Configly shows a real-time progress indicator on the dashboard. It replaces the simple "Syncing..." spinner with detailed per-type status so you always know exactly where the sync is up to.

What You See

The progress indicator shows:

  • Progress bar -- Visual progress based on how many types have completed
  • Current type -- The name of the type being synced right now
  • Position -- Where you are in the sequence (e.g., "5 of 41")
  • Elapsed time -- How long the sync has been running
  • Completed types -- A mini-list of types already synced with item counts

When the sync finishes, the progress indicator collapses to a summary line showing total time and item counts before disappearing.

Sync Order

Types are synced in a specific order to ensure lookup data is available before types that reference it:

Phase Types Why First
1. Lookup Groups, Brands, Schedules, Ticket Forms, Locales, Account Settings, Ticket Settings Other types reference these objects
2. Fields Ticket Fields, User Fields, Organisation Fields, Custom Statuses, Tags Behaviour types reference fields
3. Custom Objects Custom Objects, Custom Object Fields May be referenced by routing and behaviour types
4. Integrations Webhooks, Targets, Dynamic Content, Support Addresses, OAuth Clients, Workspaces Referenced by triggers and automations in actions
5. Routing Routing Attributes, Routing Attribute Values, Queues Depend on lookup data
6. Behaviour Triggers, Automations, Macros, Views, SLA Policies, Trigger Categories Depend on lookup, field, routing, and integration data
7. People Custom Roles, Sharing Agreements Depend on lookup data
8. Apps App Installations, Apps Owned, OAuth Global Clients, Resource Collections Independent of other phases
9. Guide Articles, Sections, Categories, Themes, User Segments, Permission Groups Independent of other phases

This ordering means dependency extraction always has the lookup data it needs to resolve references correctly.

Typical Sync Times

Sync times depend on instance size and the number of enabled types:

Instance Size Objects per Type Full Sync (41 types)
Small < 100 30--90 seconds
Medium 100--500 90--180 seconds
Large 500+ 3--7 minutes

Reduce sync time

If you don't need all 41 types, disable unused types in Instance Settings to speed up every sync proportionally.

How It Works

The progress indicator polls the server every 1 second for the latest sync status. The server tracks progress in memory (not persisted to the database) since sync state is inherently transient.

After a sync completes, the progress data is automatically cleaned up after 30 seconds. If you navigate away and come back within that window, you'll still see the completion summary.

Selective Sync

When you sync a single type (selective sync), the progress indicator shows that one type being synced. The same elapsed time and item count details are available.

Next Steps