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

# Custom PR Labels

> Let CodeAnt select your team’s labels from pull request changes.

CodeAnt adds matching labels to PRs on **GitHub, GitLab, and Azure DevOps**, even when PR descriptions are disabled.

## Set it up

**1. Open review configuration**

[Open review configuration](https://app.codeant.ai/x/settings/prconfsettings) and select your repository.

Under **Review Behavior**, enable **Process PR Review** and set **Custom PR Labels** to **On**.

**2. Add your labels**

The editor opens if no labels are configured. Otherwise, choose **Configure labels**.

Enter a name and an optional description. Use **Add label** for more labels:

| Name | Description |
| - | - |
| `bug fix` | Fixes incorrect behavior in existing functionality. |
| `documentation` | Adds or updates developer documentation. |

Add up to 50 labels. Names must be unique (ignoring case and surrounding whitespace) and 1–50 characters. GitLab names cannot contain commas. Descriptions allow up to 1,000 characters.

**3. Save your labels**

Choose **Save Changes**. Settings save automatically.

## Check it works

Open a new PR. After CodeAnt reviews it, check its labels. A documentation-only PR should receive `documentation` with the example above.

CodeAnt can select multiple labels or none if no label fits. Existing user labels stay in place. **Off** stops future additions without removing labels already applied.

## Need help?

> [accordion] No custom labels appear
>
> Confirm custom labels are **On** or inherit a saved list. Enable **Process PR Review** and check exclusions and **Draft PR Analysis**. Try a PR matching a label's description. [Contact support](mailto:support@codeant.ai) with the PR URL if it still fails.

> [accordion] I cannot save or edit labels
>
> Remove blank or duplicate names, shorten names to 50 characters, and remove commas from GitLab names. Keep at least one label. If you see **View labels**, ask someone with permission to edit Code Review settings.

> [accordion] Apply this to all repositories
>
> Select your organization in review configuration, then enable and configure custom labels. At repository scope, choose **Inherited from Org**. Azure DevOps repositories use **Inherited from Project**; projects can inherit from the organization.
>
> The editor is hidden while inheriting. Choose **On** to customize the list or **Off** to disable custom labels for that scope.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.