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

# Hostname

> Configure a custom domain or hostname for your Snag-powered loyalty experience.

<head>
  <script type="application/ld+json">
    {JSON.stringify({
            "@context": "https://schema.org",
            "@graph": [
              {
                "@type": "TechArticle",
                "headline": "Hostname",
                "description": "Configure a custom domain or hostname for your Snag-powered loyalty experience.",
                "author": {"@type": "Organization", "name": "Snag Solutions", "url": "https://www.snagsolutions.io/"},
                "publisher": {"@type": "Organization", "name": "Snag Solutions", "url": "https://www.snagsolutions.io/", "logo": {"@type": "ImageObject", "url": "https://assets.snagsolutions.io/public/docs/snag-logo-dark-no-bg.svg"}},
                "mainEntityOfPage": "https://docs.snagsolutions.io/setup/hostname"
              },
              {
                "@type": "BreadcrumbList",
                "itemListElement": [
                  {"@type": "ListItem", "position": 1, "name": "Home", "item": "https://docs.snagsolutions.io/welcome"},
                  {"@type": "ListItem", "position": 2, "name": "Set up", "item": "https://docs.snagsolutions.io/setup/setup-overview"},
                  {"@type": "ListItem", "position": 3, "name": "Hostname"}
                ]
              }
            ]
          })}
  </script>
</head>

### Activating your platform

<Steps>
  <Step title="Decide on the domain name">
    Choose the domain name where you'd like to point your platform, e.g. `{yourwebsite}.com`.
  </Step>

  <Step title="Choose the subdomain">
    Choose the subdomain for your platform, e.g. `loyalty.{yourwebsite}.com`.
  </Step>

  <Step title="Add a DNS record">
    Have a technical member on your team add a DNS record to your domain host. We will be adding a `CNAME record`.

    <Frame>
      ![AWS Route 53 CNAME record setup for a custom Snag subdomain](https://assets.snagsolutions.io/public/docs/dns-configuration.png)
    </Frame>
  </Step>

  <Step title="Input your subdomain">
    Navigate to the **Hostname** section on admin.snagsolutions.io and input your new subdomain.
  </Step>
</Steps>

If you're having trouble with setting up your subdomain / CNAME, please refer to the following pages to resolve those issues:

* GoDaddy: [https://www.godaddy.com/help/add-a-cname-record-19236](https://www.godaddy.com/help/add-a-cname-record-19236)
* Cloudflare: [https://developers.cloudflare.com/dns/zone-setups/partial-setup/setup/](https://developers.cloudflare.com/dns/zone-setups/partial-setup/setup/)
* NameCheap: [https://www.namecheap.com/support/knowledgebase/article.aspx/9646/2237/how-to-create-a-cname-record-for-your-domain/](https://www.namecheap.com/support/knowledgebase/article.aspx/9646/2237/how-to-create-a-cname-record-for-your-domain/)

### Cloudflare Proxy Troubleshooting

If you're using Cloudflare and experiencing DNS resolution issues:

<Warning>
  Sometimes you need to toggle the Cloudflare proxy off (or lower the TTL) to resolve DNS propagation issues. After turning the proxy back on, it should continue to work properly.
</Warning>

<Steps>
  <Step title="Disable Cloudflare proxy">
    1. Log into your Cloudflare dashboard
    2. Navigate to DNS settings for your domain
    3. Find your CNAME record and click the orange cloud icon to disable the proxy
    4. Wait for DNS propagation (usually 5-15 minutes)
  </Step>

  <Step title="Re-enable Cloudflare proxy">
    1. Once DNS is working, click the gray cloud icon to re-enable the proxy
    2. Your subdomain should now work with Cloudflare's proxy enabled
  </Step>
</Steps>

<Tip>
  You can also try lowering the TTL (Time To Live) value in your DNS settings to speed up propagation.
</Tip>

***

Contact us if you have any questions or need additional help configuring your specific environment.
