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

# Pretty URL

> Create a custom, memorable URL for your survey instead of sharing a long auto-generated link.

> [!NOTE]
>
> **Self-Hosted Only**: Pretty URLs are available exclusively on self-hosted Formbricks instances. This feature is not available on Formbricks Cloud.

## What is a Pretty URL?

By default, every survey is accessible at a URL containing its auto-generated ID, e.g. `yourdomain.com/s/cm1abc123xyz`. A Pretty URL lets you replace that with a short, human-readable slug of your choice:

```
yourdomain.com/p/customer-feedback
```

When someone visits the pretty URL, they are automatically redirected to the actual survey. Query parameters such as `suId` and `lang` are forwarded as well.

## Setting Up a Pretty URL

**1. Open the Distribute modal**

Navigate to your survey's **Summary** page and click the **Distribute** button in the top toolbar.

**2. Go to the Pretty URL tab**

In the Distribute modal, select the **Pretty URL** tab.

![The Pretty URL tab of the Distribute modal](https://mintcdn.com/formbricks/3IQmApSwJ9OD7AdA/images/surveys/link-surveys/pretty-url/custom-slug.webp?fit=max\&auto=format\&n=3IQmApSwJ9OD7AdA\&q=85\&s=77198d7a04d1fcf9b5e70a4a9de743b9)

**3. Enter a slug**

Type your desired slug in the input field. Slugs may only contain **lowercase letters, numbers, and hyphens** (e.g. `customer-feedback`, `q4-nps-2024`).

The full URL is shown in real time below the input so you can confirm how it will look.

**4. Save**

Click **Save**. The slug is now live. Anyone visiting the pretty URL is immediately redirected to your survey.

## Managing Pretty URLs

Once a slug is saved, the Pretty URL tab shows the active link with two actions:

* **Copy**: copies the full pretty URL to your clipboard.
* **Remove**: deletes the slug (after a confirmation prompt). The survey remains accessible via its original `/s/[surveyId]` URL.

## Viewing All Pretty URLs in Your Organization

All surveys that have a pretty URL assigned are listed in one place:

1. Go to **Settings → Organization → Domain**.
2. Open the **Pretty URLs** section.

The table has three columns — **Survey Name**, **Workspace**, and **Pretty URL** — with one row per survey that has a slug.

## Slug Rules

| Rule | Detail |
| - | - |
| Characters | Lowercase letters (a-z), digits (0-9), and hyphens (-) |
| Uniqueness | Must be unique across your entire Formbricks instance |
| Format example | `customer-feedback`, `onboarding-survey`, `q4-nps` |

## Query Parameter Forwarding

Pretty URLs forward all query parameters to the destination survey URL. For example:

```
/p/customer-feedback?suId=contact123&lang=de
```

redirects to:

```
/s/[surveyId]?suId=contact123&lang=de
```

This means features like [single-use links](https://formbricks.com/docs/surveys/link-surveys/single-use-links.md), [data prefilling](https://formbricks.com/docs/surveys/link-surveys/data-prefilling.md), and [multi-language surveys](https://formbricks.com/docs/surveys/general-features/multi-language-surveys.md) all work with pretty URLs.


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