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

# Slug

> Pre-fill form answers by adding slugs to questions and passing values through the application URL

A slug is a short, URL-friendly identifier that you can assign to any question in your hiring flow form. When a candidate opens an application link that includes the slug as a URL parameter, the corresponding question is automatically pre-filled with the value from the URL.

***

## How It Works

1. **Assign a slug** to a question in the form builder (e.g., `source`, `location`, `referral_code`)
2. **Append the slug as a URL parameter** to the funnel link
3. When the candidate opens the link, the question is **automatically pre-filled** with the value

### Example

If you have a question with the slug `source`, your funnel link would look like:

```
https://app.firstwork.com/apply/your-funnel?source=LinkedIn
```

When the candidate opens this link, the "source" question will already be filled in with "LinkedIn".

You can pass multiple slugs in the same URL:

```
https://app.firstwork.com/apply/your-funnel?source=LinkedIn&location=New+York&referral_code=REF123
```

***

## Common Use Cases

| Slug            | Purpose                                                                 |
| --------------- | ----------------------------------------------------------------------- |
| `source`        | Track where the candidate came from (job board, social media, referral) |
| `location`      | Pre-fill the work location based on the job listing                     |
| `referral_code` | Capture referral information from the link                              |
| `position`      | Pre-fill the role or position title                                     |
| `campaign`      | Track which marketing campaign drove the application                    |

***

## Setting Up Slugs

1. Open your hiring flow in the form builder
2. Select the question you want to make pre-fillable
3. In the question settings, enter a slug value
4. Share the funnel link with the slug as a URL parameter

> \[!NOTE]
> Slugs must be unique within a form. Use lowercase letters, numbers, and underscores (e.g., `referral_code`).
