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

# Statuses, tags, and custom fields

> Configure tenant metadata that agents use to organize conversations, contacts, and organizations.

# Statuses, tags, and custom fields

Use Settings to configure metadata that helps agents organize and understand work.

## Status configuration

CXP includes core conversation statuses: **Open**, **Pending**, **Resolved**, and **Closed**.

Administrators can configure pending-related values such as:

* Pending On values
* Pending Reason suggestions

These values help explain why a conversation is waiting and make pending queues easier to scan.

## Tags

Tags are reusable labels for conversations, contacts, and organizations.

Use **Settings > Tags** to manage tenant-wide tag suggestions. Agents can apply tags while working objects, and saving object tags can add new suggestions for future use.

Catalog edits affect future suggestions. They do not rewrite tags already stored on existing conversations, contacts, or organizations.

## Custom fields

Custom fields let administrators add tenant-specific structured data to:

* Conversations
* Contacts
* Organizations

Supported field types can include text, number, boolean, date, email, phone, URL, select, multiselect, and category-backed fields.

## Manage custom field lifecycle

When creating custom fields:

1. Choose the object type.
2. Set a stable key and clear label.
3. Choose the field type carefully.
4. Configure options or category references when needed.
5. Decide whether the field is required in explicit save contexts.

After creation, some field properties, especially field type, may be intentionally fixed to preserve existing data.

## Operational guidance

Keep metadata simple:

* Prefer a small number of high-value tags.
* Use custom fields for structured facts, not long notes.
* Avoid fields that duplicate built-in status, priority, assignment, or category.
* Review metadata periodically and archive stale fields when supported.