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

# Configuring referral links for your partner groups

> Learn how set default referral links, additional links, and UTM parameters for each partner group in your Dub partner program

<Tip>
  This feature is only available on [Business plans and
  above](https://dub.co/pricing/partners).
</Tip>

## Where to find your referral link settings

Each [partner group](/help/article/partner-groups) has its own referral link settings. To find them, open a group and click **Links** in the top navigation.

<Frame>
  <img src="https://assets.dub.co/cms/group-link-settings-main.png" alt="Group referral link settings" />
</Frame>

## Default referral links

A default link is created during program setup, so new [partner groups](/help/article/partner-groups) always have a referral link. You can also set up additional default links that are automatically created when a partner is enrolled in the partner group.

Click **Create Link** to add more default links:

<Frame>
  <img src="https://assets.dub.co/cms/default-links.png" alt="Group default links" />
</Frame>

<Info>
  When creating a default link, you'll be asked to enter a **Destination URL**.
  This is the page users land on after clicking a referral link. It’s often your
  homepage or a dedicated program landing page.
</Info>

**Default Link Behavior**

* **When you create a default link**, a new link is generated for every partner in that group. This includes both current and future partners in that group.
* **When you update a default link's** destination URL, it updates all the corresponding partner links in that group with the destination URL you set.
* **When you delete a default link**, the link remains for existing partners in that group to ensure historical stats/commissions are preserved.

## Additional partner links

You can also let your partners create their own links beyond the defaults:

<Frame>
  <img src="https://assets.dub.co/cms/additional-partner-links.png" alt="Additional partner links" />
</Frame>

For your additional partner links, you can specify the following:

* **Link limit**: the maximum number of links partners can create
* **Link domains**: the domains that your partner's links must match (either any page on that domain, or the homepage only)

<Frame>
  <img src="https://assets.dub.co/cms/adding-link-domain.png" alt="Adding link domain" />
</Frame>

<Warning>
  Ensure the domain you're adding has conversion tracking set up, or your links
  won't be tracking correctly. [Learn more here.](/docs/quickstart/server)
</Warning>

## Link settings

Define the link structure and UTM parameters for all partners in the group.

<Frame>
  <img src="https://assets.dub.co/cms/link-settings.png" alt="Adding link domain" />
</Frame>

### Link structure

Dub supports two referral link formats. Choose based on how you want links to look and where they’ll be shared. Both formats work the same for attribution.

<Frame>
  <img src="https://assets.dub.co/cms/link-structure.png" alt="Link structure" />
</Frame>

<Info>
  You can use any of the referral link types interchangeably – the option above
  is to determine which format is shown in the partner dashboard.
</Info>

**Option 1: Short Links**

**Format:** `getacme.link/{partnerName}`

A clean, branded short link that’s easy to remember and perfect for sharing in social posts, bios, or messages.

<Tip>
  We recommend using short links for several reasons:

  1. Some web browsers block [client-side click tracking](/docs/sdks/client-side/features/click-tracking), which breaks attribution – with `getacme.link/john` the click will be tracked server-side too, which improves attribution accuracy
  2. Some web browsers drop query params, which breaks attribution as well
  3. It's cleaner ✨
</Tip>

**Option 2: Query Parameter**

**Format:** `acme.com?via={partnerName}`

Appends the partner name as a query string on your destination URL. Ideal for users who are [migrating from Rewardful](/help/article/migrating-from-rewardful) and want to maintain backwards compatibility for existing partner links.

### UTM parameters

Set default [UTM parameters](/help/article/utm-builder) for all links in this group. This gives you group-specific insights in analytics.

<Frame>
  <img src="https://assets.dub.co/cms/link-utm.png" alt="Link UTM" />
</Frame>

When you update a group’s [UTM template](/help/article/how-to-create-utm-templates), all partner links in the
group are refreshed and overwritten with the new UTM tags.

## Changing your referral link domain

If you need to change the domain used for your referral links (for example, from `ref.getacme.com` to `ref.acme.com`), you must follow the steps below in order. Skipping or reordering these steps will break your existing partner links.

<Steps>
  <Step title="Add your new domain in Dub">
    Add your new domain (`ref.acme.com`) in your [domains settings page](https://app.dub.co/settings/domains).
  </Step>

  <Step title="Set up a redirect on your old domain">
    Set up a redirect from your old domain to your new domain so that any traffic hitting an existing partner link is forwarded to the new domain. You'll want a wildcard redirect that maps `ref.getacme.com/:path*` to `ref.acme.com/:path*`.

    Most hosting providers and CDNs support wildcard redirects. Check your provider's documentation for how to configure them (often via a configuration file, dashboard setting, or rewrite/redirect rule). If you're on [Vercel](https://vercel.com/docs/routing/redirects/configuration-redirects), you can add this to your `vercel.json` file.
  </Step>

  <Step title="Update your default link">
    Once both the new domain and the redirect are in place, update your **Default Link** to use the new domain on your [group links page](https://app.dub.co/program/groups/default/links).
  </Step>
</Steps>

## How partner group changes affect referral links

As mentioned earlier, a partner's link settings are tied to the [partner group](/help/article/partner-groups) they're in. When you update a partner's group, or delete groups, their partner links will be updated as well.

### Moving partners to a group

When a partner is moved to a new group, their links automatically update to match the new group’s defaults and UTM parameters.

<Info>
  **Why would you move partners?**

  * To promote them from a starter group to a group with a higher reward tier
  * To try out new rewards in a test group
  * To tidy up your structure and general reorganization
</Info>

### Deleting groups

If you delete a group, all partners in that group are moved to the default group. Their links are updated to match the default group’s settings.

<Info>
  **Why would you delete a group?**

  * The campaign has ended
  * You created a duplicate group by mistake
  * A beta trial group is no longer needed
</Info>
