> For the complete documentation index, see [llms.txt](https://docs.rafflex.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rafflex.io/getting-started/add-your-domain-to-rafflex.md).

# 2️⃣ Add Your Domain to RaffleX

Connect your own domain to Rafflex through Cloudflare so your site loads securely, and so it can send emails from your own address.

To use your own domain with Rafflex, we need to make sure it is secure. We do this through Cloudflare, a free service that sits in front of your website. It gives your site its padlock (an SSL certificate), which lets your customers and their web browsers know your site is safe to use.

This page walks you through the whole process. It looks like a lot of steps, but each one is quick. The only slow part is waiting for your changes to spread across the internet, and you do not need to watch it happen.

{% hint style="warning" %}
Which steps you need depends on where you bought your domain:

* **Bought on Cloudflare:** your domain is already in your Cloudflare account. Skip ahead to [Get your DNS records from Rafflex](#get-your-dns-records-from-rafflex).
* **Bought somewhere else** (GoDaddy, Namecheap, 123 Reg and so on): start at the top and follow every step.
  {% endhint %}

You can keep your domain with the company you bought it from (GoDaddy, Wix, Squarespace or anyone else). You only change its nameservers so that Cloudflare looks after its DNS records. Add the Rafflex records in Cloudflare, not at your domain provider. Once your nameservers point to Cloudflare, any records left at your domain provider are ignored.

{% embed url="<https://www.youtube.com/watch?v=WoL2I6XpiuU>" %}

### What you will be doing

1. Create a free Cloudflare account.
2. Add your domain to Cloudflare.
3. Point your domain at Cloudflare by updating its nameservers.
4. Get your DNS records from your Rafflex dashboard.
5. Import those records into Cloudflare.
6. Wait for everything to show as verified, then log in to your new site.

{% hint style="info" %}
**What are DNS records and nameservers?** DNS records are like signposts. They tell the internet where to find your website and which services are allowed to send emails for your domain. Nameservers decide *which company* holds those signposts for your domain. By switching your nameservers to Cloudflare, you let Cloudflare manage the signposts for you.
{% endhint %}

***

### Create a Cloudflare account

{% stepper %}
{% step %}

### Open Cloudflare

Go to [Cloudflare](https://www.cloudflare.com/).
{% endstep %}

{% step %}

### Sign up

Click **Sign Up** (on a mobile, click **Log In** and then **Sign Up**).
{% endstep %}

{% step %}

### Verify your email

Check your inbox for Cloudflare's verification email and click the link inside it.
{% endstep %}
{% endstepper %}

***

### Add your domain to Cloudflare

{% stepper %}
{% step %}

### Enter your domain

Enter your existing domain, for example `yourrafflesite.co.uk`. Type just the domain, without `www.` or `https://`.
{% endstep %}

{% step %}

### Choose the Free plan

Scroll down and select the **Free** option. You do not need a paid Cloudflare plan to use Rafflex.
{% endstep %}

{% step %}

### Note your nameservers

You will see **Update Your Nameservers**, with two Cloudflare nameservers listed. Keep this page open, or copy both nameservers somewhere safe, because you need them in the next step.
{% endstep %}
{% endstepper %}

***

### Update your nameservers

Now tell your domain provider to use Cloudflare's nameservers. The exact steps depend on where you bought your domain, so choose your provider below.

{% tabs %}
{% tab title="GoDaddy" %}
{% stepper %}
{% step %}

### Log in to GoDaddy

Log in to [GoDaddy](https://godaddy.com/).
{% endstep %}

{% step %}

### Open your domain

Select **Domain** from the menu.
{% endstep %}

{% step %}

### Manage DNS

Choose your domain, then click **Manage DNS**.
{% endstep %}

{% step %}

### Open nameserver settings

Click **Nameservers**, then **Change nameservers**.
{% endstep %}

{% step %}

### Enter Cloudflare's nameservers

Select **I'll use my own nameservers** and enter the two nameservers provided by Cloudflare.
{% endstep %}
{% endstepper %}
{% endtab %}

{% tab title="Namecheap" %}
{% stepper %}
{% step %}

### Log in to Namecheap

Log in to [Namecheap](https://namecheap.com/).
{% endstep %}

{% step %}

### Open your domain

Select **Domain List**, then your domain.
{% endstep %}

{% step %}

### Switch to Custom DNS

Find **Nameservers**, click the dropdown and select **Custom DNS**.
{% endstep %}

{% step %}

### Enter Cloudflare's nameservers

Enter the two nameservers from Cloudflare and save.
{% endstep %}
{% endstepper %}
{% endtab %}

{% tab title="123 Reg" %}
{% stepper %}
{% step %}

### Log in to 123 Reg

Log in to [123 Reg](https://123-reg.co.uk).
{% endstep %}

{% step %}

### Open your domains

Click **Control Panel**, then **Manage Domains**.
{% endstep %}

{% step %}

### Select your domain

Select the domain you want to connect.
{% endstep %}

{% step %}

### Open nameserver settings

Click **Change Nameservers** (DNS).
{% endstep %}

{% step %}

### Choose custom nameservers

Choose **Enter my own nameservers**.
{% endstep %}

{% step %}

### Enter Cloudflare's nameservers

Add both Cloudflare nameservers and click **Update**.
{% endstep %}
{% endstepper %}
{% endtab %}

{% tab title="Another provider" %}
Every domain provider has a nameserver setting, although the wording varies. Look for something like **Nameservers**, **DNS settings** or **Custom DNS** on your domain's management page.

1. Log in to your domain provider.
2. Open the settings for your domain.
3. Find the nameserver setting and choose the option to use your own (custom) nameservers.
4. Replace the existing nameservers with the two from Cloudflare, then save.

If you cannot find the setting, search your provider's help pages for "change nameservers", or ask their support team.
{% endtab %}
{% endtabs %}

{% hint style="warning" %}
The update can take up to 24 hours, but usually completes within minutes. You will receive an email from Cloudflare confirming the change. Refresh your Cloudflare dashboard and it should say **Cloudflare is protecting your site**. You can carry on with the next step while you wait.
{% endhint %}

Afterwards, the company you bought your domain from may warn you that your nameservers no longer point to them. That is expected, so you can ignore it.

{% hint style="warning" %}
**Already use email on this domain?** Once your nameservers point to Cloudflare, Cloudflare holds every DNS record for your domain, including the ones your email needs. Cloudflare tries to copy your existing records when you add your domain, but it can miss some, and then your email stops sending or arriving.

1. Open your email provider's setup or DNS page for your domain and find the records it needs (usually MX records, plus some TXT and CNAME records).
2. In Cloudflare, go to **DNS**, then **Records**, and check each one is there exactly as your email provider shows it. Add any that are missing.
3. Leave the email records set to **DNS only** (grey cloud).

Rafflex does not provide MX records or a mailbox. They always come from your email provider. See [Set Up Email Inbox](https://docs.rafflex.io/additional-settings/email-setup/set-up-email-inbox.md) if you do not have one yet.
{% endhint %}

***

### Get your DNS records from Rafflex

Rafflex creates a set of DNS records especially for your domain. You will find them on your domain's verification page in your Rafflex dashboard (on rafflex.io, not your website admin panel).

{% tabs %}
{% tab title="I signed up with my own domain" %}
If you entered your own domain when you created your website, you were taken to the verification page automatically after paying. To get back to it at any time:

1. Go to [rafflex.io](https://rafflex.io) and sign in to your Rafflex account.
2. On your **Dashboard**, find the **Website Access** box.
3. Click **Verify your domain!**
   {% endtab %}

{% tab title="I started on a temporary domain" %}
If your site is on a temporary `.rafflex.uk` address, you first need to switch it to your own domain. See [Switch from a temporary domain to your own domain](#switch-from-a-temporary-domain-to-your-own-domain) below, then come back here.
{% endtab %}
{% endtabs %}

The verification page shows your domain at the top, followed by three sections. Each record has a **Type**, a **Host** and a **Value**, with a copy button next to each so you never have to type them out by hand.

| Section                    | What it does                                                                                                       |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| **Verify Your Domain**     | Proves you own the domain and sets up your SSL certificate (the padlock).                                          |
| **Set Your Vanity Domain** | Points your domain at Rafflex so your website loads. This is a CNAME record whose value is `customers.rafflex.io`. |
| **Outgoing Email**         | Lets your site send emails (such as order confirmations) from your own domain without landing in spam.             |

**Verify Your Domain** and **Outgoing Email** each have a status badge that shows **Pending** in red until the records are found, then turns green and shows **Verified**. The page checks again by itself every minute or so, so you can leave it open. **Set Your Vanity Domain** has no status badge, so it never shows **Verified**. Your domain is connected once the other two badges are green and your site loads on your domain.

{% hint style="warning" %}
If the **Outgoing Email** section shows **Error** and asks you to contact support instead of listing any records, [get in touch with Rafflex support](https://rafflex.io/contact-us) so we can sort it out for you. Do the same if **Outgoing Email** still shows **Pending** but has no records listed for you to add.

**Outgoing Email still Pending with records listed?** In Cloudflare, check that each of its CNAME records (the ones with `_domainkey` in the **Host**) is set to **DNS only** (grey cloud), not **Proxied**. Imported records can end up proxied, and these records will not verify that way. You do not need to create a mailbox first, and email can take a little longer to verify than your domain.
{% endhint %}

{% hint style="info" %}
Records only appear on this page while they are still needed. Once a record has been found and checked, it disappears from the list. If a section has no records showing, that part is already done.
{% endhint %}

{% hint style="danger" %}
At the top of the verification page, next to **Cloudflare DNS Import**, you will also see a **Cancel Website** button. This is not part of the domain setup, so do not click it. If you have any questions about your subscription, contact Rafflex support.
{% endhint %}

***

### Import DNS records to Cloudflare

The quickest way to add all your records is to import them in one go.

{% embed url="<https://www.youtube.com/watch?v=MzNHIW4Qwx0>" %}

{% stepper %}
{% step %}

### Download your records file

On your Rafflex verification page, click **Cloudflare DNS Import** at the top. A text file containing all of your DNS records downloads to your computer. It is named after your domain and ends in `_dns_import.txt`.
{% endstep %}

{% step %}

### Open your DNS records in Cloudflare

Log in to your Cloudflare dashboard, click your domain, then click **DNS** and then **Records**.
{% endstep %}

{% step %}

### Open Import and Export

Click the **Import and Export** button, towards the right of the page.
{% endstep %}

{% step %}

### Upload the file

Upload the text file you downloaded from Rafflex.
{% endstep %}

{% step %}

### Check your records

Cloudflare adds all the records from the file to your DNS list. Have a quick look through to make sure they are there, and read [Common errors to avoid](#common-errors-to-avoid) below to check nothing old is getting in the way.

**Cloudflare says some records could not be imported, or are duplicates?** That usually means a record with the same name is already in your DNS list, either left over from your old provider or added the first time you imported the file. Delete the old clashing records (see [Common errors to avoid](#common-errors-to-avoid)) and import the file again. If the records from your verification page are already in your list, nothing else needs doing.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
If you want `www.yourdomain.com` to load your site too, follow [Ensure www. Loads Your Site](https://docs.rafflex.io/getting-started/add-your-domain-to-rafflex/ensure-www.-loads-your-site.md) once your domain is connected.
{% endhint %}

***

### Verification and completion

1. Allow around 15 minutes for the DNS records to be checked. It can occasionally take longer.
2. Go back to your verification page on rafflex.io and check that **Verify Your Domain** and **Outgoing Email** both show **Verified**.
3. Visit your domain in your browser. Your website should now load, with a padlock next to the address.

Your website is now live at your domain!

**Log in to your admin panel** by adding **/admin** to the end of your domain, for example `yourdomain.com/admin`.

{% hint style="danger" %}
Make sure you **use the correct password** for your admin panel. It is the temporary password in the email Rafflex sent you when your website was created (titled **Your (your domain) website is being set up**). This is not the same as the password for your Rafflex account on rafflex.io. If you cannot log in, see [Reset Password](https://docs.rafflex.io/managing-your-site/customers/reset-password.md).
{% endhint %}

{% hint style="success" %}
Now that your domain is verified, you can send site emails from your own address, for example `tickets@yourdomain.com`. See [Email Setup](https://docs.rafflex.io/additional-settings/email-setup.md) to change it.
{% endhint %}

{% hint style="warning" %}
If you have followed these steps and your site is still not verified after a few hours, read [Common errors to avoid](#common-errors-to-avoid) before contacting us. Most problems are one of the three below.
{% endhint %}

{% hint style="info" %}
**Verified, but some devices still show your old website or an error?** Phones, browsers, home routers and internet providers keep a saved copy of where your domain used to point, and it can take a few hours (occasionally a day or two) to clear. Open your site in a private or incognito window, or on mobile data instead of Wi-Fi. If it loads there, your setup is working and everyone else will catch up on their own. If it fails everywhere after a few hours, check [Ensure www. Loads Your Site](https://docs.rafflex.io/getting-started/add-your-domain-to-rafflex/ensure-www.-loads-your-site.md) and then contact us with a screenshot of your Cloudflare DNS records.
{% endhint %}

***

### Switch from a temporary domain to your own domain

If you started on a temporary `.rafflex.uk` address, you can move to your own domain yourself from your Rafflex dashboard.

{% hint style="warning" %}
**Take your time with this step.** You can only change your domain once from the dashboard, so double check the spelling before you confirm. If something goes wrong, contact Rafflex support.
{% endhint %}

{% hint style="danger" %}
**Your site moves as soon as you click Update Domain.** Your temporary `.rafflex.uk` address stops working straight away, and your website (including your admin panel) will not load on your new domain until its DNS records are in place and verified. Get your Cloudflare account and nameservers ready first, and pick a quiet time to make the switch, ideally before you have started selling tickets.
{% endhint %}

{% stepper %}
{% step %}

### Set up Cloudflare first

Make sure you have completed [Create a Cloudflare account](#create-a-cloudflare-account), [Add your domain to Cloudflare](#add-your-domain-to-cloudflare) and, if needed, [Update your nameservers](#update-your-nameservers).
{% endstep %}

{% step %}

### Open your Rafflex dashboard

Go to [rafflex.io](https://rafflex.io), sign in, and open your **Dashboard**.
{% endstep %}

{% step %}

### Change your domain

Find the **Domain Settings** box (it says you are using a `.rafflex.uk` domain) and click **Change Domain**.
{% endstep %}

{% step %}

### Enter your new domain

In **New Domain**, type your domain without `https://`, for example `yourdomain.com`. Then click **Update Domain**.
{% endstep %}

{% step %}

### Open the verification link

You will see the message **Domain has been successfully updated to** followed by your new domain, and you will receive an email titled **Your RaffleX Domain Has Been Updated!** It contains a link to your new domain's verification page. You can also reach it from your **Dashboard** by clicking **Verify your domain!**
{% endstep %}

{% step %}

### Import your records

Follow [Import DNS records to Cloudflare](#import-dns-records-to-cloudflare) and then [Verification and completion](#verification-and-completion) above.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
After switching, have a look through your competitions. If any images are no longer showing, upload them again or let Rafflex support know.
{% endhint %}

{% hint style="info" %}
**Already on your own domain and need a different one?** For example you mistyped it, signed up with `www.` in front, or you are renaming your business. There is no setting for this, so contact Rafflex support with your current domain and the new one. You do not need to cancel your website or start again. The same applies if you have already used your one change from the dashboard.

Once support has switched it:

1. You receive an email titled **Your RaffleX Domain Has Been Updated!** with a link to your new domain's verification page.
2. Your site does not load on the new domain until you finish the Cloudflare steps on this page for it, so set up Cloudflare for the new domain first and agree a quiet time for the switch.
3. You log in with the same email address and password, at your new domain followed by **/admin**.
   {% endhint %}

***

### Common errors to avoid

#### 1. ❌ Old A records still present

**Fix:** Delete any existing **A** records for your domain from your DNS settings in Cloudflare. These are often left behind by your old domain provider (for example, a "parked" page), and they conflict with the record that points your domain to Rafflex. Your Rafflex site does not use an A record or an IP address at all, so if Cloudflare or your domain provider asks you to add one, you can ignore it.

#### 2. ❌ Incorrect CNAME for www

**Fix:** If you have a **www** CNAME record pointing to `yourdomain.com`, delete it. Instead, create a new CNAME record with the name **www** that points to:

`customers.rafflex.io`

The full steps are in [Ensure www. Loads Your Site](https://docs.rafflex.io/getting-started/add-your-domain-to-rafflex/ensure-www.-loads-your-site.md).

#### 3. ⚠️ Missing \_acme-challenge TXT record

**Fix:** Sometimes the `_acme-challenge` record (one of the records that sets up your padlock) does not import correctly. This record is required to generate your SSL certificate and make your site secure, so add it by hand:

1. Open your verification page on rafflex.io (Dashboard, then **Verify your domain!**).
2. Under **Verify Your Domain**, find the TXT record whose **Host** begins with `_acme-challenge`.
3. In Cloudflare, go to **DNS**, then **Records**, and click **Add record**.
4. Choose **TXT** as the **Type**.
5. Use the copy buttons on the Rafflex page to paste the **Host** into the **Name** box and the **Value** into the **Content** box, exactly as shown.
6. Click **Save**.

***

{% hint style="warning" %}
If you are stuck or unsure, [drop us a message](https://rafflex.io/contact-us) and our team will help you get sorted fast. **Please send a screenshot of your current Cloudflare DNS settings** so we can resolve your issue quickly.
{% endhint %}
