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

> Publish your project on a custom domain.

# Custom Domain

Lumi simplifies publishing your project online, whether you use a free staging URL (e.g., `yourdomain.com`) or connect your own custom domain. This guide covers the entire process, from connecting your domain and troubleshooting common issues to navigating the options.

## Why use a custom domain

A custom domain (e.g., `yourdomain.com`) significantly improves your site in some key areas:

* **Brand Identity:** It establishes a more professional and credible online presence.
* **Search Engine Visibility:** It enhances your SEO, helping you rank higher in search results.
* **Memorability:** It creates a unique address that is easier to share and remember.

## Requirements to use a custom domain

Before you begin:

* You must be on a Lumi Pro plan.
* You need to own a domain name.

## How to configure a domain

### Before You Start

* Make sure you have already owned a domain name. Or purchase one first.
* Make sure you have published the project first.

<img src="https://mintcdn.com/blockdance/ynWgEA-zeP9dMZPg/images/image(35).png?fit=max&auto=format&n=ynWgEA-zeP9dMZPg&q=85&s=f676dfa71aff0d571eecf66e613beb85" alt="Image(35) Pn" width="3840" height="1984" data-path="images/image(35).png" />

### Step 1: Enter your Domain

<Steps>
  <Step title="Navigate to Domains and Add">
    Go to "Project Page -> Workspace -> Domains" and click the "Add domain" button.
  </Step>

  <Step title="Enter Your Domain">
    Enter your domain and click "Continue".

    <img src="https://mintcdn.com/blockdance/OpoGC4IlWh_CkUTn/images/image(1).png?fit=max&auto=format&n=OpoGC4IlWh_CkUTn&q=85&s=0548102368d5a2c45b4db4bf9c000c26" alt="Image(1) Pn" width="3840" height="1916" data-path="images/image(1).png" />
  </Step>
</Steps>

### Step 2: Add New Host Record

Create a new host record in your DNS Provider and enter the following information ——

* If your domain is similar to "[example.com](http://example.com)", please add as follows ——

| **Type** | **Host** | **Value**                           | **TTL**   |
| :------- | :------- | :---------------------------------- | :-------- |
| CNAME    | @        | [www.lumi.ing](http://www.lumi.ing) | Automatic |

* If your domain is similar to "[www.example.com](http://www.example.com)", please add as follows ——

| **Type** | **Host** | **Value**                           | **TTL**   |
| :------- | :------- | :---------------------------------- | :-------- |
| CNAME    | www      | [www.lumi.ing](http://www.lumi.ing) | Automatic |

* If your domain is similar to "[image.example.com](http://image.example.com)", please add as follows ——

| **Type** | **Host** | **Value**                           | **TTL**   |
| :------- | :------- | :---------------------------------- | :-------- |
| CNAME    | image    | [www.lumi.ing](http://www.lumi.ing) | Automatic |

After completing adding the host record, click the "Continue" button.

<img src="https://mintcdn.com/blockdance/OpoGC4IlWh_CkUTn/images/image(2).png?fit=max&auto=format&n=OpoGC4IlWh_CkUTn&q=85&s=3d67b5a71204654f072471242bd23389" alt="Image(2) Pn" width="3840" height="1916" data-path="images/image(2).png" />

#### A Simple Step-by-Step Example on Namecheap

<Tip>
  You can freely choose a service provider or seller to purchase and configure a domain. The configuration process is similar to the following example.
</Tip>

<Steps>
  <Step title="Find the Domain to be Configured">
    1. Go to the Namecheap official website: [**www.namecheap.com**](http://www.namecheap.com)
    2. From the upper right corner of the page, enter "Account -> Domain list"
    3. In the Domain list, find the domain to be configured, and click the "manage" button on the right.

           <img src="https://mintcdn.com/blockdance/OpoGC4IlWh_CkUTn/images/image(3).png?fit=max&auto=format&n=OpoGC4IlWh_CkUTn&q=85&s=2c348327b32208bc53c45c93e1210ff6" alt="Image(3) Pn" width="3840" height="1984" data-path="images/image(3).png" />

           <img src="https://mintcdn.com/blockdance/OpoGC4IlWh_CkUTn/images/image(4).png?fit=max&auto=format&n=OpoGC4IlWh_CkUTn&q=85&s=e65fe2e7b57fdb0066f77c805a7a12c7" alt="Image(4) Pn" width="3840" height="1984" data-path="images/image(4).png" />
  </Step>

  <Step title="Add a New CNAME Record">
    1. Click the Tab "Advanced DNS"
    2. Click the red "ADD NEW RECORD" button
    3. Submit the corresponding information

           <img src="https://mintcdn.com/blockdance/ynWgEA-zeP9dMZPg/images/image(39).png?fit=max&auto=format&n=ynWgEA-zeP9dMZPg&q=85&s=592b8118c1421932049970ac249be2ba" alt="Image(39) Pn" width="3840" height="1984" data-path="images/image(39).png" />
  </Step>
</Steps>

### Step 3: Verify the Domain

<Steps>
  <Step title="Check Status Until 'Ready'">
    Click the "Check Status" button to refresh the status until it shows "Ready". This process can take up to 48 hours, so you may need to retry.

    <img src="https://mintcdn.com/blockdance/F5n4c_dGD_QS-2Y0/images/image(5).png?fit=max&auto=format&n=F5n4c_dGD_QS-2Y0&q=85&s=b2c7f48960b72fd00b0bed0e02fe4e99" alt="Image(5) Pn" width="3840" height="1916" data-path="images/image(5).png" />
  </Step>

  <Step title="Verify the Domain">
    Once the status shows "Ready", click the "Verify Domain" button.

    <img src="https://mintcdn.com/blockdance/F5n4c_dGD_QS-2Y0/images/image(6).png?fit=max&auto=format&n=F5n4c_dGD_QS-2Y0&q=85&s=a7d2dd6a7fdf443a59a7ad545739afc4" alt="Image(6) Pn" width="2940" height="1602" data-path="images/image(6).png" />
  </Step>

  <Step title="Confirm Verification">
    If the verification is successful, the button will change to "Verified" and a green icon will appear next to the domain.

    <img src="https://mintcdn.com/blockdance/F5n4c_dGD_QS-2Y0/images/image(7).png?fit=max&auto=format&n=F5n4c_dGD_QS-2Y0&q=85&s=19e4e0af3b254119b569b9dad5eecadf" alt="Image(7) Pn" width="2940" height="1602" data-path="images/image(7).png" />
  </Step>
</Steps>

## How to Buy a Domain

### Suggested Websites

<Note>
  Lumi doesn't directly sell domain to users and has no subordination or cooperation relationship with the recommended websites below. You are free to choose the seller or service provider to purchase domain. Please pay attention to protecting your personal privacy and financial security during the transaction.
</Note>

* [https://www.namecheap.com](https://www.namecheap.com)
* [https://www.ovhcloud.com/en-sg/web-cloud](https://www.ovhcloud.com/en-sg/web-cloud)
* [https://www.spaceship.com](https://www.spaceship.com)
* [https://www.enom.com](https://www.enom.com)
* [https://www.hostinger.com](https://www.hostinger.com)

### A Simple Step-by-Step Example on Namecheap

Namecheap is a popular domain registrar and web hosting company known for its competitive pricing, user-friendly interface, and **free lifetime Domain Privacy protection**. This guide will walk you through the purchasing process.

#### Before You Start

Make sure you have these three things ready:

1. **A domain name idea**: e.g., `my-awesome-blog.com`.
2. **A valid email address**: For account registration and important notifications.
3. **A payment method**: Credit Card (Visa/Mastercard), PayPal, or Cryptocurrency.

#### Step 1: Search for Your Domain

<Steps>
  <Step title="Go to the Namecheap website">
    Go to the Namecheap official website: [www.namecheap.com](http://www.namecheap.com)
  </Step>

  <Step title="Search for your domain">
    In the main search bar on the homepage, type your desired domain name and click the "Search" button.

    <img src="https://mintcdn.com/blockdance/ynWgEA-zeP9dMZPg/images/image(26).png?fit=max&auto=format&n=ynWgEA-zeP9dMZPg&q=85&s=fc48e8b5e596719345cccba0c4088be9" alt="Image(26) Pn" width="3840" height="1984" data-path="images/image(26).png" />
  </Step>
</Steps>

#### Step 2: Choose Your Domain and Add to Cart

<Steps>
  <Step title="Check Availability and Add to Cart">
    The search results will show if your domain is available.

    * If it is, you'll see a green checkmark and the price; click the "Add to cart" button.

          <img src="https://mintcdn.com/blockdance/ynWgEA-zeP9dMZPg/images/image(27).png?fit=max&auto=format&n=ynWgEA-zeP9dMZPg&q=85&s=ce16e621d7d300460cbf9b0e71c76b1a" alt="Image(27) Pn" width="3840" height="1984" data-path="images/image(27).png" />

    * If it's taken, the system will say "TAKEN" and suggest alternatives with different extensions (like .net, .org, .io). You can choose an alternative or go back and search for a new name.

          <img src="https://mintcdn.com/blockdance/ynWgEA-zeP9dMZPg/images/image(28).png?fit=max&auto=format&n=ynWgEA-zeP9dMZPg&q=85&s=c086b558814df09b77f3ba1cf45757d6" alt="Image(28) Pn" width="3840" height="1984" data-path="images/image(28).png" />
  </Step>

  <Step title="Checkout">
    After adding it to your cart, click the "Checkout" button, which usually appears in the bottom-right corner or at the top of the page.

    <img src="https://mintcdn.com/blockdance/ynWgEA-zeP9dMZPg/images/image(29).png?fit=max&auto=format&n=ynWgEA-zeP9dMZPg&q=85&s=a9d51fdf1a1471f285d9377236b76efd" alt="Image(29) Pn" width="3840" height="1984" data-path="images/image(29).png" />
  </Step>
</Steps>

#### Step 3: Configure Your Cart Options (Crucial Step)

On the checkout page, you'll see several options. Review them carefully.

<Card title="Domain Registration" img="https://mintcdn.com/blockdance/ynWgEA-zeP9dMZPg/images/image(30).png?fit=max&auto=format&n=ynWgEA-zeP9dMZPg&q=85&s=d837e56d2e9dc2362544794e47eca543" width="3840" height="1984" data-path="images/image(30).png">
  * **Term**: Defaults to `1 Year`. This is recommended for beginners. You can choose a longer term for a better price if you're sure about the domain.
  * **Auto-Renew**: If you want to avoid your domain expiring accidentally, leave it on. If you're on a tight budget or just testing, you can turn it off.
</Card>

<Card title="Domain Privacy" img="https://mintcdn.com/blockdance/ynWgEA-zeP9dMZPg/images/image(31).png?fit=max&auto=format&n=ynWgEA-zeP9dMZPg&q=85&s=5abe9eb71254183bb496a2dcb2a1bfef" width="3840" height="1984" data-path="images/image(31).png">
  * **This is one of Namecheap's best features!** It hides your personal registration details (name, address, email) from the public.
  * It is **FREE forever** with Namecheap. Ensure this is turned `ON`.
</Card>

<Card title="Other Add-ons (Upsells)" img="https://mintcdn.com/blockdance/ynWgEA-zeP9dMZPg/images/image(32).png?fit=max&auto=format&n=ynWgEA-zeP9dMZPg&q=85&s=f0b75e954a8fa31622ff297b2e34219a" width="3840" height="1984" data-path="images/image(32).png">
  * Namecheap will offer other products like `PremiumDNS`, `Web Hosting`, `VPN`, etc.
  * For a beginner just buying a domain, **none of these are necessary**. You can ignore them completely and purchase them later if needed. **Do not** add anything you don't need.
</Card>

Once you've confirmed your settings, click "**Confirm Order**".

<img src="https://mintcdn.com/blockdance/ynWgEA-zeP9dMZPg/images/image(33).png?fit=max&auto=format&n=ynWgEA-zeP9dMZPg&q=85&s=01b4e8f1703bc8c7fde6ec59d35b52e3" alt="Image(33) Pn" width="3840" height="1984" data-path="images/image(33).png" />

#### Step 4: Create a Namecheap Account or Log In

If you are a new user, you'll need to create an account.

<Steps>
  <Step title="Fill in Your Account Information">
    On the right side of the page, fill in the fields to create your account: Username, Password, First Name, Last Name, and Email Address.

    <img src="https://mintcdn.com/blockdance/ynWgEA-zeP9dMZPg/images/image(34).png?fit=max&auto=format&n=ynWgEA-zeP9dMZPg&q=85&s=093c2a2c84c61349962f0b1ee859b833" alt="Image(34) Pn" width="3840" height="1984" data-path="images/image(34).png" />
  </Step>

  <Step title="Create Your Account">
    Click "Create Account and Continue".
  </Step>
</Steps>

If you already have an account, simply log in on the left.

#### Step 5: Enter Your Contact Information

You are required by ICANN (the organization that governs domains) to provide valid contact information.

* Fill out the form with your real name, address, phone, and email.
* **Don't worry about privacy**—as long as you enabled WhoisGuard in Step 3, this information will be hidden from the public.

Click "**Continue**" when you're done.

#### Step 6: Finalize Payment

<Steps>
  <Step title="Add Payment Information">
    Choose your preferred payment method (like Credit Card or PayPal) and enter your payment details.
  </Step>

  <Step title="Confirm and Pay">
    Review all the details one last time and click "Pay Now" or "Continue" to complete the purchase.
  </Step>
</Steps>

#### Step 7: Purchase Complete & What's Next

After your payment is processed, you'll see a confirmation screen. You will also receive a few emails from Namecheap.

<Steps>
  <Step title="Receive Your Order Receipt">
    You will get a confirmation of your purchase.
  </Step>

  <Step title="Verify Your Email Address (Extremely Important)">
    Look for an email with a subject like "IMMEDIATE VERIFICATION required." You MUST click the link inside to verify your email address. If you don't do this within 15 days, ICANN will temporarily suspend your domain.
  </Step>
</Steps>

#### What to Do After Buying

Congratulations! You are now the owner of a new domain.

* Log in to your Namecheap account and go to your **Dashboard**.
* Click on **Domain List** in the left sidebar. You will see your newly purchased domain here.
* Click the "**Manage**" button next to your domain. This is where you will go in the future to manage your domain's settings, such as pointing it to a web host via the "**Advanced DNS**" tab.
* Next, you can add this newly purchased domain to your Lumi project.

#### FAQs of Buying Domains

<Accordion title="What's the difference between a domain and web hosting?">
  Think of it this way: a domain is your website's address (like a street address), and hosting is the actual house where your website files live. You need both to have a live website. You've just bought the address.
</Accordion>

<Accordion title="Do I really need Domain Privacy?">
  Yes, absolutely. It's free and protects your personal information from spammers and marketers. There's no reason to turn it off.
</Accordion>

<Accordion title="The .com domain I want is already taken. What should I do?">
  Try a different extension like .net or .io, add a verb to your name (e.g., getmywebsite.com), use hyphens, or think of a completely new name.
</Accordion>

## FAQs

<Accordion title="My custom domain is connected, but my site isn't live. What should I do?">
  First, use a tool like dnschecker.org to verify your DNS settings. DNS changes can take up to 48 hours to fully propagate worldwide. If the settings are correct, try clearing your browser cache or opening your site in an incognito/private window. As a last resort, try removing and re-adding the domain in Project > Settings > Domains.
</Accordion>

<Accordion title="Can I buy a domain through Lumi?">
  Lumi doesn't directly sell domain to users and has no subordination or cooperation relationship with the recommended websites below. You are free to choose the seller or service provider to purchase domain. Please pay attention to protecting your personal privacy and financial security during the transaction.
</Accordion>

<Accordion title="Does Lumi provide an SSL certificate for my custom domain?">
  Yes. When you connect a custom domain, Lumi automatically generates and installs a free SSL certificate for you. This ensures your site is served over HTTPS, securing visitor data and boosting your SEO ranking. If the SSL certificate isn't active within 48 hours, please contact our support team for assistance.
</Accordion>

<Accordion title="How do I remove a custom domain?">
  1. Navigate to Project > Workspace > Domains.
  2. Click the delete button next to the domain you wish to remove.
  3. This will disconnect the domain from your project. To complete the process, be sure to also remove the corresponding DNS records from your domain provider's settings.
</Accordion>

<Accordion title="Can I remove the .lumi.ing subdomain?">
  The default .Lumi.ing subdomain cannot be removed from your project at this time. It will remain active even after you connect a custom domain.
</Accordion>
