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

# Custom domain

> How to use a custom domain on your Motto OTT platform

Every Motto project automatically gets assigned a unique subdomain that can be used to access the OTT platform.
Typically, this is useful while configuring and testing your OTT platform. In your production environment, you may want to use
your own domain name for your fans to see. This document explains how to configure your DNS settings to achieve this.

## Prerequisites

Before you start, make sure you have the following:

* A domain name that you own
* Access to the DNS settings of that domain name
* Patience, as DNS changes can take up to 48 hours to propagate

## Get Started

### Option 1: Use a subdomain

If you want to use a subdomain of your domain name for the OTT platform (like [https://tv.mydomain.com](https://tv.mydomain.com)),
you will only need to configure a `CNAME` record in your DNS settings. This record is uniquely generated for your project by Motto,
and is currently not exposed via the API or Studio. Please reach out to us at [info@mottostreaming.com](mailto:info@mottostreaming.com) to obtain it.

Once the Motto team has sent you the CNAME record, follow these steps:

1. Log in to your domain name registrar's website.
2. Find the DNS settings for your domain name.
3. Add a new `CNAME` record with the following settings:
   * **Name**: `tv` (replace `tv` with the subdomain you want to use)
   * **Type**: `CNAME`
   * **Value**: The unique CNAME value the Motto team sent you
4. Save your changes.

### Option 2: Use the root domain

If you want to use the root domain of your domain name for the OTT platform (like [https://mydomain.com](https://mydomain.com)), there are two different ways to configure this:

<AccordionGroup>
  <Accordion title="Via a 'www' CNAME">
    This is the easiest way to configure your root domain to point to the OTT platform, but it requires that you use the `www` subdomain.
    Modern web browsers do not show the `www` subdomain in the address bar, so this is often not a problem.

    1. Follow the steps in the "Option 1" section above, and use `www` as the subdomain.
    2. Configure your domain name registrar to redirect the root domain to the `www` subdomain. Depending on your domain name registrar, this works a little differently:
       * **GoDaddy**: [Redirect your domain](https://www.godaddy.com/help/forward-a-domain-12123)
       * **Namecheap**: [Redirect your domain](https://www.namecheap.com/support/knowledgebase/article.aspx/385/77/how-can-i-set-up-a-url-redirect-for-my-domain)
       * **Squarespace**: [Redirect your domain](https://support.squarespace.com/hc/en-us/articles/214767107-Forwarding-a-Squarespace-domain)
       * **Other registrars**: Please refer to your registrar's documentation.
  </Accordion>

  <Accordion title="Via a DNS nameserver change">
    <Warning>This option comes at an additional cost of roughly 25 EUR per month.</Warning>

    If you want to use the root domain without the `www` subdomain, you will need to change the nameservers of your domain name.

    Reach out to the Motto team to obtain the correct nameservers. Please include for which Motto project this is,
    and for which domain you are requesting the nameservers. Once you have obtained the nameservers, follow these steps:

    1. Log in to your domain name registrar's website.
    2. Find the domain nameservers settings for your domain name.
    3. Replace the existing nameservers with the ones provided by the Motto team. Typically, this will be two nameservers.
    4. Reach out to the Motto team to confirm that the nameservers have been set up correctly. Once the team confirms this, your domain name will be correctly configured.

    <Note>A consequence of this approach is that Motto controls all DNS records on this domain, which it does via Cloudflare, a trusted cloud and web security provider.</Note>
  </Accordion>
</AccordionGroup>