> ## Documentation Index
> Fetch the complete documentation index at: https://docs.msportal.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Ticket Settings

> Configure ticket sync settings and status mappings

The Ticket Settings step lets you configure how tickets are displayed and synced from your PSA. You'll set up status mappings, display preferences, and sync behavior.

<Note>
  This step only appears if you selected a PSA integration. It becomes available after the initial PSA sync completes.
</Note>

## What You'll Configure

* **Status Mappings** - Map your PSA statuses to MSPortal status categories
* **Display Settings** - How tickets appear in the portal
* **Sync Settings** - What ticket data to sync and how often
* **Company Settings** - Per-company ticket visibility options

## Steps to Complete

<Steps>
  <Step title="Wait for PSA Sync">
    If the initial sync is still in progress, the wizard will show a waiting indicator. This ensures your ticket statuses are available for mapping.
  </Step>

  <Step title="Navigate to Ticket Settings">
    Click **Go to Settings** in the onboarding wizard, or go to **Settings > Tickets**.
  </Step>

  <Step title="Configure General Settings">
    On the **General** tab, set default ticket views and display options.
  </Step>

  <Step title="Set Up Status Mappings">
    On the **Statuses** tab, map your PSA ticket statuses to MSPortal categories (Open, In Progress, Waiting, Closed).
  </Step>

  <Step title="Configure Company Settings">
    On the **Companies** tab, set which ticket types are visible to company users.
  </Step>

  <Step title="Save Changes">
    Click **Save** after configuring each section.
  </Step>
</Steps>

## Status Categories

MSPortal uses four status categories to organize tickets:

| Category        | Description                  | Example Statuses             |
| --------------- | ---------------------------- | ---------------------------- |
| **Open**        | New tickets awaiting action  | New, Unassigned              |
| **In Progress** | Actively being worked on     | In Progress, Scheduled       |
| **Waiting**     | On hold or waiting for input | Waiting on Customer, On Hold |
| **Closed**      | Completed tickets            | Resolved, Closed, Cancelled  |

## Manual Completion

This step requires **manual completion**. Click **Mark Complete** in the wizard when you've finished configuring your ticket settings.

<Tip>
  Accurate status mapping is important for reporting. Make sure each PSA status maps to the correct MSPortal category.
</Tip>

## Related Documentation

* [Ticketing Overview](/user-guides/ticketing/index) - Full ticketing guide
* [Ticket Settings](/user-guides/settings/tickets) - Settings reference
* [How to Create a Ticket Template](/user-guides/ticketing/how-to-create-a-ticket-template) - Create templates for common tickets