Sign In

Linking Catalog Items

Reference services, customers, or other entities inline to add context and traceability to incidents.

In Upstat, you can link incidents to items in your Catalog directly from the incident summary or comment thread. This creates a lightweight but powerful way to tie incidents to the systems or entities they affect—without interrupting your workflow.

How Linking Works

Upstat supports inline smart mentions that let you reference catalog items as you type.

  1. Type # in the incident summary or a comment
  2. Begin typing the name of a catalog entity (e.g., #auth-api, #customer-1123)
  3. Select from the autocomplete list
  4. The linked item will appear as an interactive pill with its name and type

These links display as inline tokens and can be hovered to reveal metadata like service type, owner, or related monitors.

![Placeholder: Inline Catalog Link Screenshot]

You can link any item defined in your project’s Catalog, including:

  • Services (e.g., Auth API, Billing Gateway)
  • Customers or tenants
  • Infrastructure components
  • Custom types you’ve defined (e.g., teams, third-party systems)

Each linked item adds traceability and can be used later in filtering or reporting.

Where Linked Items Show Up

  • Incident summary and comment threads
  • Catalog item views list all incidents where the item was mentioned
  • Future reports will surface incident frequency by catalog item

These relationships are automatically created—no manual tagging required.

Why It Matters

Linking catalog items helps your team:

  • Understand scope — What was impacted, and what else depends on it
  • Accelerate triage — Quickly navigate to monitors, docs, and automations tied to the entity
  • Improve reporting — Track incident trends by service, customer, or component
  • Build historical traceability — Spot repeat issues over time

Summary

  • Use # mentions in summaries or comments to link catalog items inline
  • Linked items are interactive and automatically backlinked to incidents
  • This enhances context, visibility, and incident history across the platform

Learn more