Skip to content

Dashboard Overview

The Dashboard is your central hub for managing and monitoring your Zendesk configuration. It provides at-a-glance visibility into your connection status, configuration inventory, and recent sync activity.

What You See

Connection Header

At the top of the dashboard, you'll see your connection details:

  • Connection name — with an avatar showing the name initials
  • Zendesk subdomain — e.g., yourcompany.zendesk.com
  • Connection status badge
    • Connected (green) — authentication is valid and working
    • Failed (red) — there's an authentication problem that needs fixing
    • Not tested (grey) — connection hasn't been verified yet
  • Last sync time — shown in relative format (e.g., "5 minutes ago", "2 hours ago")

Configuration Type Cards

The main dashboard displays a grid of cards for each configuration type Configly tracks:

Configuration Type What It Includes
Triggers Automated rules that run when tickets are created or updated
Automations Time-based rules that run on a schedule
Macros Pre-built sets of actions agents can apply to tickets
Views Filtered lists of tickets for agents and admins
Ticket Fields Custom fields on tickets
User Fields Custom fields on user profiles
Organization Fields Custom fields on organizations
SLA Policies Service level agreement rules and targets
Groups Agent group definitions
Brands Brand configurations
Schedules Business hour schedules
Ticket Forms Ticket submission form configurations

Each card shows:

  • Total count — how many of that object type exist in your Zendesk (prominently displayed)
  • Active count — how many are currently active or enabled (shown below the total)
  • Config type icon — visual identifier for the type
  • Click to browse — each card links to a filterable list of items for that type

Quick Actions

Below the instance summary, you'll find quick action buttons:

  • Sync Now — pull the latest configuration from Zendesk
  • Compare Versions — jump to the snapshot comparison view
  • Search — open the global search

Press Cmd+K (Mac) / Ctrl+K (Windows/Linux) from the dashboard (or anywhere in the app) to open the command palette. Search across all configuration types at once.

Learn more about search →

What-If Mode

When viewing a connection, you'll see a What-If Mode toggle in the navigation bar. Enable it to simulate configuration changes without affecting your live Zendesk.

  • Toggle with the button or press Cmd+Shift+S / Ctrl+Shift+S
  • When active, the button turns amber and shows a badge with your pending change count

Learn more about What-If Mode →

First-Time Experience

If you haven't synced a connection yet, the dashboard shows a guided first-sync experience instead of the standard card grid:

  1. Progress view — shows each configuration type being retrieved with real-time status
  2. Celebration screen — displays total items found with per-type badges
  3. Next steps — buttons to explore configuration or compare snapshots

Common Actions

Sync All Configurations

Click Sync Now to pull the latest configuration from Zendesk. This:

  1. Connects to your Zendesk instance
  2. Downloads all configuration types
  3. Saves a snapshot with a timestamp
  4. Updates the dashboard counts

When to sync:

  • After making changes in Zendesk that you want to track
  • Before comparing configurations (to ensure you have the latest)
  • When setting up a new connection for the first time

View Configuration Details

Click any configuration type card to see:

  • All objects of that type
  • Details for each object (name, conditions, actions, etc.)
  • Search and filter options
  • Dependency information (what fields, groups, or tags each object uses)

Understanding Sync Versions

Each time you sync, Configly creates a snapshot with a timestamp version. This version groups all configuration types synced together.

  • You can compare any two sync versions to see what changed
  • Each version is a complete "point in time" snapshot of your Zendesk
  • You can go back and view your configuration as it was weeks or months ago

Dashboard Tips

Monitor Connection Health

If you see a red "Failed" status:

  1. Click on the connection to view details
  2. Check if your OAuth credentials expired
  3. Click "Refresh Token" to manually refresh
  4. Test the connection to verify it's working

Keep Your Dashboard Fresh

  • Sync before planning changes so you have the latest baseline
  • Sync after deploying changes to Zendesk to track what changed
  • Set up a regular sync cadence (daily or weekly) to maintain history

Next Steps