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

# Configuring the Seller Domain (DNS)

> How to connect a custom seller (shop) domain to a Vivenu seller and verify it via DNS in GoDaddy.

## Overview

By default a new Vivenu seller is served from an auto-generated `vivenushop.com` address. This SOP covers connecting a branded custom domain (the customer-facing shop URL) to the seller and verifying ownership through a DNS record in GoDaddy.

<Note>
  This SOP assumes you already know how to access and navigate Vivenu. If you need access, [email support](mailto:advanced-technology-c0a6ecefe97b@intake.linear.app).
</Note>

***

## Prerequisites

* Vivenu access for the relevant seller
* Access to the `fat-kartingleague.com` DNS in [GoDaddy](https://dcc.godaddy.com/)
* The hub code confirmed (e.g. `de` for Germany, `us-ca` for US California). See the [naming convention](/software/third-party/vivenu/general/vivenu-naming-convention) for how hub codes are assigned.

***

## Connecting the Custom Domain

<Steps>
  <Step title="Open Domains">
    Under **Settings > Domains**, click **Connect custom domain**.
  </Step>

  <Step title="Enter the hostname">
    In the **Create Domain** dialog, enter the **Hostname** using the convention:

    ```
    shop.<hub-code>.fat-kartingleague.com
    ```

    Where `<hub-code>` is the code for your hub. For example, for Germany this is `shop.de.fat-kartingleague.com`.

    <img src="https://mintcdn.com/smedley_group/InEdB1yfdYn2-5Z7/images/software/third-party/vivenu/hub-deployment/development/configure-seller-domain/create-domain.png?fit=max&auto=format&n=InEdB1yfdYn2-5Z7&q=85&s=e2963aa0cdf435928bbefe1f68957458" alt="The Create Domain dialog in Vivenu with the Hostname field" width="958" height="708" data-path="images/software/third-party/vivenu/hub-deployment/development/configure-seller-domain/create-domain.png" />
  </Step>
</Steps>

***

## Adding the DNS Record

After creating the domain, Vivenu displays a single **CNAME** record to add to your DNS. It will show as **PENDING** until the record is verified.

<Steps>
  <Step title="Copy the CNAME record from Vivenu">
    Note the two values Vivenu provides:

    | Field         | Use as                          | Example value                   |
    | ------------- | ------------------------------- | ------------------------------- |
    | Hostname      | Host / Name of the CNAME record | `shop.de.fat-kartingleague.com` |
    | CNAME Content | Value / Target / Destination    | `domains.vivenu.com`            |

    <img src="https://mintcdn.com/smedley_group/InEdB1yfdYn2-5Z7/images/software/third-party/vivenu/hub-deployment/development/configure-seller-domain/dns-records.png?fit=max&auto=format&n=InEdB1yfdYn2-5Z7&q=85&s=08aa644d883d8529b56d65ad081110f5" alt="The CNAME record details shown by Vivenu" width="960" height="1722" data-path="images/software/third-party/vivenu/hub-deployment/development/configure-seller-domain/dns-records.png" />
  </Step>

  <Step title="Add the record in GoDaddy">
    In [GoDaddy](https://dcc.godaddy.com/), open the DNS management for `fat-kartingleague.com` and add a new **CNAME** record using the **Hostname** and **CNAME Content** values from the previous step.

    <Note>
      Enter only the host portion (e.g. `shop.de`) - GoDaddy appends the root domain automatically. The fully qualified record must resolve to `shop.<hub-code>.fat-kartingleague.com`.
    </Note>
  </Step>
</Steps>

***

## Verifying and Setting as Primary

<Steps>
  <Step title="Wait for DNS to propagate">
    DNS changes can take a few minutes to become active. Allow time for the record to propagate before expecting verification to succeed.
  </Step>

  <Step title="Refresh until the domain is active">
    Return to **Settings > Domains** and refresh the page periodically. Once the record is verified, the domain's **Status** and **SSL** will both show **ACTIVE**.
  </Step>

  <Step title="Set the domain as primary">
    Click **Set as primary** on the custom domain row. It will then show the **PRIMARY** badge, and the default `vivenushop.com` domain will no longer be primary.

    <img src="https://mintcdn.com/smedley_group/InEdB1yfdYn2-5Z7/images/software/third-party/vivenu/hub-deployment/development/configure-seller-domain/domains-set-primary.png?fit=max&auto=format&n=InEdB1yfdYn2-5Z7&q=85&s=5db9b65b99ffd0574a742ed5cdf805ed" alt="The Domains list with the custom domain set as primary" width="1942" height="596" data-path="images/software/third-party/vivenu/hub-deployment/development/configure-seller-domain/domains-set-primary.png" />
  </Step>
</Steps>