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

# Add roles

> Post the jobs your scouts can refer candidates to.

Scouts can only refer candidates to **active roles** on your programme. There are two ways to add them.

## Option 1: Paste a URL (fastest)

1. Go to [**/hiring/roles**](https://app.trychora.com/hiring/roles).
2. Paste the full URL of a role on your careers page in the **Add by link** field.
3. Click **Add role**.

Chora scrapes the title, description, location, and employment type automatically. Review the result and click **Save** to publish.

## Option 2: Create by hand

1. On the Roles page, click **New role**.
2. Fill in **Title**, **Location**, **Employment type**, and an **About this role** description.
3. Optionally override the **Scout fee** for this role (see [Set scout fees](https://help.trychora.com/hirers/set-scout-fees.md)).
4. Click **Publish**.

## Keep roles fresh

Chora can re-scan your careers page on a schedule and close roles automatically when they disappear:

1. Set your **Careers page URL** on [**/hiring/account**](https://app.trychora.com/hiring/account).
2. Chora checks every 6 hours and marks missing roles as **Closed**.
3. Scouts can no longer refer to closed roles. They stay visible in your referral history.

> [!TIP]
>
> Scanning catches most ATS surfaces (Greenhouse, Lever, Ashby, Workable, Teamtailor, self-hosted). If your careers page fails to parse, email [support@trychora.com](mailto:support@trychora.com) with the URL and we'll add a parser.

## Close a role manually

On [**/hiring/roles**](https://app.trychora.com/hiring/roles), click the status dropdown next to any role and choose **Close**. Scouts stop seeing it immediately; existing referrals keep moving through their pipeline.

## Next step

[Invite your scouts →](https://help.trychora.com/hirers/invite-scouts.md)


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