Admin Lesson 15: Panel Customization

Admin Lesson 15: Panel Customization

The Agent and Dispatch panels work out of the box, but they don't know which scope tabs your team actually uses, which actions your team needs as one-click buttons, or which forms should be wired up as named buttons on ticket cards. Panel Customization is where you tune both panels so they match how your team actually works.

Why panel customization matters

Problem: Out of the box, the Agent panel shows a generic set of scope tabs and actions. Half are useful for your team, half aren't. Agents see clutter they ignore, miss buttons they'd actually use, and spend time picking the right view from a menu instead of having it default-loaded. Multiply across a team and the friction adds up.

Horizon's answer: Per-panel customization for Agent and Dispatch. You decide which scope tabs appear, which one loads by default, which refinement filters are wired in, which action buttons are visible, and which custom forms surface as named buttons on ticket cards. Once configured, every agent and dispatcher gets a panel tuned to your team's workflow without each user having to set their own preferences.

The Admin panel doesn't get this treatment — admin work is rare and the navigation already groups by purpose. Customization applies only to Agent and Dispatch.

Where panel settings live

Open the admin panel and navigate to Settings → Panels. You'll find:

PageWhat it does
Agent Panel Settingsconfigures the Agent panel's scope tabs, default scope, refinement filters, action buttons, and form attachments
Dispatch Panel Settingssame configuration for the Dispatch panel

The two pages have the same shape. You configure each independently because the workflows are different — agents work their own queue, dispatchers work the team's.

What you can configure

Each panel settings page exposes:

SettingWhat it controls
Scope tabswhich scope tabs appear at the top of the board (e.g. "My Tickets", "All Open", "Awaiting Customer", "Overdue")
Default scopewhich scope tab loads when the user opens the panel
Refinement filtersper-board secondary filters available within each scope (e.g. "narrow to my company", "narrow to priority High+")
Action buttonswhich one-click actions show on ticket cards (e.g. "Send Booking Link", "Submit Custom Form", "Smart Assign", "Snooze")
Action formscustom forms surfaced as named buttons on ticket cards (instead of being buried in a generic submit-form picker)
Email template defaultsper-panel default templates for booking links, customer replies, etc.

What you do not configure here: ticket card columns, sort order of tickets within scope tabs, or any field-level helpdesk settings. Those are either fixed or controlled elsewhere (helpdesk integration, the user's own preferences).

Scope tabs and default scope

Scopes are saved filters tied to the panel's board view. Each scope is built from a HelpdeskEvalCriteria definition. The panel settings page lets you:

  1. Pick which existing scopes to expose as tabs.
  2. Order them.
  3. Mark one as the default.

The agent or dispatcher's default panel opens to that default scope tab. Pick the one that matches the most common entry-point workflow:

  • For agents: usually "My Open Tickets" or "My Today".
  • For dispatchers: usually "All Unassigned" or "At Risk".

If your team uses three or four distinct views, expose all of them as tabs. If your team only ever uses one, don't expose the rest — fewer tabs is less cognitive load.

Refinement filters

Within any scope tab, refinement filters let users narrow further without losing the scope. Common refinements:

  • Company"only show tickets for this customer".
  • Priority"only High and above".
  • Type"only Service Requests".
  • Assignee (dispatch only) — "only this agent's tickets".

You configure which refinements are available per scope. Users pick from those available refinements when they need them. The point is to give users the right knobs, not every knob.

Action buttons on ticket cards

Each ticket card on a board can show a row of action buttons. The full catalog of available actions includes things like:

  • Send Booking Link
  • Submit Custom Form
  • Smart Assign
  • Snooze
  • Defer
  • Open in Helpdesk
  • Create Scheduled Todo
  • Create Floating Todo

You pick which subset shows on the card. A typical Agent panel might show Send Booking Link, Submit Custom Form, Defer, Open in Helpdesk. A dispatch panel might show Smart Assign, Snooze, Open in Helpdesk, plus dispatcher-specific actions.

Don't try to expose everything. Cards get cluttered fast. Five buttons is a lot. Three is plenty for most teams.

Action forms — surfacing custom forms as named buttons

By default, when an agent wants to submit a custom form, they click a generic Submit Custom Form button and pick from a dropdown. That's fine for rarely-used forms. For frequently-used forms (a Vendor Escalation form your team uses three times a day, an Approval Request form that's part of a standard process), you can promote the form to a named button on the ticket card.

In Panel Settings, configure each promoted form with:

  • The custom form to attach.
  • The button label (e.g. "Vendor Escalation" — what the agent sees on the card).
  • The button icon and color (optional).
  • The panel(s) it should appear on.

The result: instead of "click Submit Custom Form → pick Vendor Escalation from dropdown → fill it out", the agent clicks "Vendor Escalation" directly. Two fewer clicks, and the form's discoverability goes from buried to obvious.

Promote a form when it's used often enough that the dropdown step becomes friction. Leave it in the dropdown when it's situational.

Setting up panel customization

  1. Navigate to Settings → Panels → Agent Panel Settings (or Dispatch).
  2. Configure scope tabs — pick which to expose, order them, set a default.
  3. Configure refinement filters per scope — pick which to expose.
  4. Configure action buttons — pick which to show on ticket cards.
  5. Configure action forms — promote the frequently-used custom forms to named buttons.
  6. Save.

Test by opening the Agent panel as a regular user (or use the panel switcher) and confirm the layout matches what you configured. Iterate based on team feedback.

Iterating on panel customization

Panel layout decisions are best made after watching the team use the panel for a few weeks. Signals to act on:

  • Agents always pick the same scope tab — make it the default.
  • A scope tab is never used — remove it.
  • Agents repeatedly use a refinement filter that isn't exposed — expose it.
  • A custom form gets used dozens of times per week — promote it to an action button.
  • Agents complain about "too many buttons" — strip the card down.

The goal is a panel that fits the team's workflow tightly. The fewer decisions an agent has to make to find their work, the better.

When panel customization is set up correctly

  • Agents and dispatchers open the panel and see exactly the scopes they need.
  • Default scope matches the most common entry-point.
  • Action buttons cover the team's common cases without clutter.
  • Frequently-used forms are promoted to named buttons; situational forms stay in the picker.
  • Team feedback about panel friction trails toward zero.

Tip: Panel customization is one of the few places where you'll be tempted to match the helpdesk exactly — same tabs, same filters, same button placement. Don't. Horizon panels exist to replace the helpdesk's queue management, not mirror it. If the helpdesk's view is a 16-column ticket list and your team operates from a focused four-tab view in Horizon, that's the system working. Configure for clarity, not parity.

    • Related Articles

    • Admin Lesson 3: Tour of the Admin Panel

      You don't need to know every page in detail — that's what the rest of the series is for. You do need to know where things live so you can find them when you need them. This lesson walks the admin panel left-side navigation top to bottom, group by ...
    • Admin Lesson 13: Custom Forms

      Custom forms turn repeatable agent actions into structured, queryable, automatable events. Instead of agents free-texting "escalating to vendor" into ticket notes, they fill out a Vendor Escalation form. The data is structured, the action is logged, ...
    • Admin Lesson 4: Helpdesk Integration

      Helpdesk integration is the first thing you set up. Until Horizon can read tickets from your PSA and write back to it, nothing else matters — triage has nothing to triage, assignment has nothing to assign, scheduled todos have no tickets to attach ...
    • Admin Lesson 16: Manual vs Automatic — Calibrating Your Account

      You've configured the building blocks. Now the question becomes how aggressively should the system act on its own? Every major piece of Horizon — triage, assignment, todo creation, watchlist transitions, form lifecycles — has a manual mode and an ...
    • Admin Lesson 14: Watchlists

      Watchlists are deadline monitors. They watch a datetime field on every open ticket, compare it to the current time, and bucket each ticket into a stage — approaching a future deadline, or elapsed past a past one. Agents see those stages in their ...