> ## 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

<Steps>
  <Step title="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**.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Save your labels">
    Choose **Save Changes**. Settings save automatically.
  </Step>
</Steps>

## 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?

<AccordionGroup>
  <Accordion title="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>

  <Accordion title="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>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>


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