> ## Documentation Index > Fetch the complete documentation index at: https://docs.lovable.dev/llms.txt > Use this file to discover all available pages before exploring further. # Set up a custom domain > Learn how to buy, connect, verify, troubleshoot, and manage custom domains in Lovable. A **custom domain** lets you use your own domain or subdomain for your Lovable project instead of the default `xxx.lovable.app` URL. Connecting a custom domain improves your site's: * **Brand identity**: look more trustworthy and professional * **Search engine visibility**: better SEO and discoverability * **Memorability**: easier for users to share and remember Custom domains are available on **paid plans**. ## Choose how to set up your domain You can set up a domain at any time, but you need to **publish your project** before your domain can start serving your site. You can access the domain setup from: * **Project → Settings → Domains** * **Publish modal → Custom domain** * **Workspace settings → Workspace domains**: buy and manage all domains bought through Lovable You'll see two options on the **Domains** page: * **Buy a new domain** \ Register and set up a domain in Lovable. All domains bought through Lovable belong to your **workspace**, not a single project. * **Connect existing domain**\ Connect an existing domain from your workspace or a domain from another provider. ## Buy a domain through Lovable Buy a domain in Lovable and connect it to your project automatically. You do not need to configure anything manually. You need to be a workspace **admin** or **owner** to buy and connect a domain through Lovable. Follow the steps below: You can access the domain setup from: * **Project → Settings → Domains** * **Publish modal → Custom domain** * **Workspace settings → Workspace domains** Click **Buy new domain.** Search for a domain name or choose one of the suggested options. * Prices are shown in USD. * Premium domains cost more than standard domains. * We support most major generic top-level domains and a limited set of country code top-level domains. Review and adjust the details of your purchase before checkout. You can edit: * **Term length**\ Choose how long to register the domain, from 1 to 10 years. Multi-year registration may offer cost savings. * **Auto-renew**\ Enabled by default and recommended. When enabled, your domain renews automatically before it expires using your saved payment method. You'll be charged the renewal price shown at the time of purchase (subject to change based on registrar pricing). * **Registration details**\ Required contact information for domain registration, see next step. * Enter your registration details required by [ICANN](https://www.icann.org/) (the organization that manages domain registration worldwide). Registration details cannot be changed after purchase. * Click **Save**. ICANN requires you to verify your registrant email address. * If the email you provided matches your verified Lovable account email, verification is handled automatically. * Otherwise, you receive a verification email and must click the link before the deadline to confirm ownership and avoid suspension. [WHOIS privacy protection](https://en.wikipedia.org/wiki/Domain_privacy) is enabled automatically for domain extensions that support it. Click **Confirm purchase** and complete the Stripe checkout flow. * The purchase price and renewal price may differ. * The renewal price is shown during checkout and in your domain settings. When your payment is confirmed, you're redirected back to Lovable. Lovable automatically: * **Registers the domain on your behalf**\ You see **Registered on Lovable** next to your domain. * **Configures DNS records** \ `A` records and verification `TXT` records are created automatically. * **Sets up SSL/HTTPS** \ Your domain gets a free SSL certificate, so your site is served securely. * **Connects the domain to your project** \ Both `yourdomain.com` and `www.yourdomain.com` are set up automatically and listed separately. To use a subdomain instead of the root domain (for example, `blog.yourdomain.com` or `app.yourdomain.com`), go to **Connect domain → Your domains**, click **Connect** next to the root domain, then select **Use a subdomain**. Domain setup typically completes within a few minutes, but can take up to several hours. You can follow the progress in the UI. After your domain becomes **Live**, run an [SEO review](/features/seo-aeo) and verify the domain in Google Search Console. This helps Lovable check indexing, canonical URLs, sitemap status, metadata, and other live-site SEO signals for the correct host. ### Domain statuses Your domain bought through Lovable may show one of these statuses: | **Status** | **Description** | User action | | :---------- | :----------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Pending** | Your domain is being registered and configured. DNS records and SSL are being set up.
If the setup takes longer than expected, you see a warning. | No action required. Wait for setup to complete.
If you see the warning, click **Check status** to refresh. Contact support if it doesn't complete within a few hours. | | **Live** | Domain is fully configured and serving your project. SSL is active. | No action required. | | **Ready** | Domain is correctly configured, but your project isn't published yet. Domain will start serving automatically when you publish. | Publish the project. | | **Removed** | The domain is no longer connected to this project, for example because registration expired. | Reconnect it from your workspace domains if needed. | You can disconnect a domain at any point regardless of its status. ### Manage workspace domains bought through Lovable All domains bought through Lovable belong to your **workspace**, not a single project. This means you can view them in one place and connect them to any project in the workspace. To buy, view, and manage all domains that belong to your workspace, go to **Workspace settings → Workspace domains**. You can: * **View all domains**\ See all domains in your workspace, including their name and expiry. * **Search and filter**\ Find domains by name. * **Configure specific domains (click Configure):** * View registration details and alerts * View expiration and renewal details and alerts * Enable or disable auto-renew * Renew the domain manually to extend your domain registration for another year * See which projects the domain is connected to, including a link to each project * Disconnect from project (project editor or higher)\ This does not cancel your registration. The domain remains in your workspace and can be reconnected. * See and modify details on your domain (DNS records) * Move domain to another workspace\ Click on the three dots menu in upper right corner and choose **Move domain** to transfer a domain to a different workspace. The destination workspace must be on a Pro plan or above, and you must be an admin or owner of that workspace. When the move completes, the domain leaves the source workspace and becomes available in the destination workspace, where you can connect it to any project there. Existing project connections in the source workspace are disconnected as part of the move. ### Manage project domains bought through Lovable To manage a **specific project domain** bought through Lovable, go to **Project → Settings → Domains** and click the three dots menu next to the domain. You can: * **Configure domain details**\ Opens the **Configure** page, where you can view registration, renewal, and connection details. * **Set or unset as primary**\ Choose which domain should be the main domain for your project. * **Disconnect from project** (project editor or higher)\ Remove the domain from your project. This does not cancel your registration. The domain remains in your workspace and can be reconnected. ## Connect a domain from another provider You can connect a domain you already own using **automatic** setup (powered by Entri) or **manual** DNS configuration. Both methods require verifying ownership of your domain. ### Prerequisites * You have project editor permissions or higher to connect and disconnect domains. * You have access to the DNS settings for the domain or subdomain you want to connect. **Ownership verification** requires adding DNS `A` and `TXT` records provided by Lovable during setup. * There are no `AAAA` records set for the domain you are connecting. Having an `AAAA` record can interfere with domain setup and cause traffic to be routed incorrectly. ### Connect your domain Follow the steps below to connect the domain: Click **Connect domain**. * Enter your domain or subdomain (for example, `yourdomain.com` or `blog.yourdomain.com`). * Click **Connect domain**. This opens the Entri modal. * Click **Continue.** When adding a domain purchased outside Lovable, the `www` subdomain is not automatically added. You can add it separately if you want both. Connect your domain in one of two ways: * **Automatic setup with Entri**\ Your domain provider is detected automatically. Log in and authorize Entri to update your DNS records. * **Manual setup**\ Select your domain provider from the list. If your provider is not listed, scroll to the bottom of the **Select your domain provider** modal and choose **Go to our manual setup**. Copy the `A` record and `TXT` record and input them directly into your domain registrar or DNS provider. When connecting a domain, we suggest a default host name for the `A` record. Depending on your provider, the host name may need to be: * `@` * left blank * or set to your domain name (for example, `example.com`) For example, Amazon Route 53 requires the host name to be left blank or set to the domain name. Click **Done**. Wait for verification and SSL certificate to be issued. When complete, the domain will become **Live** and your Lovable app will be live at your custom domain. DNS changes may take up to 72 hours to propagate, though most updates are live within a few hours. After your domain becomes **Live**, run an [SEO review](/features/seo-aeo) and verify the domain in Google Search Console. This helps Lovable check indexing, canonical URLs, sitemap status, metadata, and other live-site SEO signals for the correct host. ### Advanced: Use a CDN or reverse proxy Lovable can be used behind your own CDN or reverse proxy, such as Cloudflare, CloudFront, or Fastly. To do this, enable the advanced **Domain uses Cloudflare or a similar proxy** option when connecting a domain from another provider. When this option is enabled: * You are responsible for configuring and maintaining your CDN or proxy * Lovable does not configure, validate, or monitor your CDN or proxy setup Follow these steps: Lovable will provide a `CNAME` record. Add the `CNAME` record to your domain’s DNS settings at your DNS provider. Wait for the domain status to become **Live**. When the `CNAME` recorded is pointed correctly, Lovable issues the SSL certificates. Traffic will then flow through your CDN or proxy before reaching Lovable. ### Domain statuses When you connect domains purchased outside Lovable, you see clear statuses that reflect verification progress, DNS propagation, SSL certificate readiness, and required user action. | Status | Description | User action | | :------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Unpublished** | Shown only for your `xxx.lovable.app` project URL when the project is not yet published. | Publish the project. | | **Ready** | The domain is ready but the project was unpublished. When published again, the status automatically becomes **Live**. | Publish the project. | | **Action required** | The custom domain setup was not completed. | Click **Complete setup** to finish connecting. | | **Verifying** | Waiting for DNS records to propagate. | Click **Check status** to check the latest status and verify the DNS records.

Check that your `A` and `TXT` records are added correctly **at your DNS provider**, especially the full TXT value. | | **Unable to verify** | DNS verification did not complete within one hour. This usually means your DNS records are incorrect or still propagating.

**Note**: *DNS propagation can take up to 72 hours, although most updates are applied within a few hours.* | Click **Check status** to refresh the status and re-verify your DNS records.

Check that your `A` and `TXT` records are added correctly **at your DNS provider**, especially the full TXT value. | | **Setting up** | Verification complete; SSL certificates are being issued. | No action required; domain will automatically move to **Live** or **Failed.** | | **Stalled** | SSL certificate provisioning is taking longer than expected. | Click **Retry** to attempt setup again. You do not need to remove and re-add the domain. | | **Failed** | Ownership verified, but SSL certificate could not be provisioned. | Click **Retry** to attempt again. | | **Live** | Domain is live and serving your project. | No action required. | | **Offline** | Domain was **Live** but DNS records are no longer valid. Your domain is no longer pointing to your project. | Click **Recover**. Review displayed DNS records and update them **at your DNS provider** to reconnect your domain. | | **Removed** | This domain was removed because it was added to another project or DNS verification never completed (DNS records weren't added correctly or didn't finish propagating). | Click **Reconnect** to connect the domain again. | ### Manage project domains from other providers To manage a **specific project domain** bought from another provider, go to **Project → Settings → Domains** and click the three dots menu next to the domain. You can: * **Set or unset as primary**\ Choose which domain should be the main domain for your project. * **Disconnect from project**\ Remove the domain from your project. This does not cancel your registration with your domain provider. Make sure to clear DNS settings in your domain provider to completely clear the connection. ## Primary domain Lovable allows you to set **one domain as the primary domain**. * The domain status must be **Live** in order to mark it as primary. Click the three dots menu next to your domain and click **Set as primary**. * The first custom domain you add to a project automatically becomes the primary domain (for domains added after October 29, 2025). * If a domain is primary, all other domains redirect to it. * Only one domain can be primary at a time. * You can unset the primary domain; in that case, all connected domains serve the project equally. Click the three dots menu next to your primary domain and click **Unset as primary**. ## FAQ These terms come up when connecting a custom domain from another provider: * **DNS** determines where your domain points on the internet. * A **DNS provider** is the service where you manage DNS records for your domain, such as `A`, `TXT`, or `AAAA` records. * An **A record** points a domain or subdomain to an IP address. * A **TXT record** is used to verify domain ownership. * An **AAAA record** points a domain to an IPv6 address and can interfere with domain setup if present. * An **SSL certificate** enables HTTPS and allows browsers to securely connect to your site. Yes. When you connect a custom domain to your Lovable app, we automatically generate and install an SSL certificate for it. This ensures your site is served over HTTPS, keeping your visitors' data secure and improving your site's SEO ranking. If it hasn't been issued after 72 hours, please reach out to [Lovable Support](https://lovable.dev/support). Yes, you can buy and set up a domain at any time. However, your custom domain won't serve any content until you publish your project. Yes. A custom domain helps consolidate your brand, backlinks, canonical URLs, and search visibility under a domain you control. After your domain becomes **Live**: * Run an [SEO review](/features/seo-aeo) to check indexing, metadata, canonical URLs, sitemap status, performance, and other live-site SEO signals. * Verify the domain in Google Search Console. * Submit your sitemap through the [Google Search Console connector](/integrations/google-search-console) or directly in Google Search Console. * If you changed your primary domain, rerun the SEO review so Lovable can re-check the new host. Lovable supports both custom domains and subdomains, and lets you choose one primary domain so all other connected domains redirect to it automatically. * For domains purchased through Lovable, both the root domain and `www` subdomain (`yourdomain.com` and `www.yourdomain.com`) are set up automatically and listed separately. * For domains purchased outside Lovable, the `www` subdomain is not included when you set up your domain. You need to add it separately, and it will be listed separately. Yes. You can connect a subdomain (for example, `blog.yourdomain.com` or `app.yourdomain.com`) instead of the root domain. When connecting your domain, include the subdomain you want to use. Yes. You can connect multiple subdomains, but each one must be added and configured individually in **Project → Settings → Domains**. For example, you can connect `blog.yourdomain.com`, `shop.yourdomain.com`, and `app.yourdomain.com`. Not the same exact domain, but you can connect different subdomains of the same domain to different projects (for example, `yourdomain.com` to project A, `blog.yourdomain.com` to project B). Yes. As long as you can verify ownership, you can connect a domain or subdomain used by another project, even if the project has been deleted. You can see your connected domains in the following locations: * **Project → Settings → Domains**: all domains connected to a project * **Publish modal**: all **Live** domains connected to a project * **Workspace settings → Workspace domains**: all domains bought through Lovable The domain status must be **Live** in order to set it as primary. Go to **Project → Settings → Domains**, click the three dots menu next to a **Live** domain, and click **Set as primary**. Go to **Project → Settings → Domains**, click the three dots menu next to your primary domain, and click **Unset as primary**. You can disconnect a domain at any time regardless of its status. 1. Go to **Project → Settings → Domains.** 2. Click the three dots menu next to your domain, click **Disconnect**, then click **Disconnect** again to confirm. This will disconnect the domain from the project. * For **domains bought through Lovable**, this only disconnects the domain from the project. It does not cancel your registration. The domain remains in your workspace and can be reconnected. * For **domains purchased outside Lovable**, this only disconnects the domain from the project. It does not cancel your registration with the external provider. The domain is just removed from Lovable. Make sure to clear DNS settings in your domain provider to completely clear the connection. Currently, there is no way to remove the `xxx.lovable.app` project URL from your project. However, you can add a custom domain and set it as your primary domain. This allows visitors to access your app from a branded URL instead of the default `xxx.lovable.app` project URL. We support most major generic top-level domains (gTLDs) and a limited set of country code top-level domains (ccTLDs). Supported ccTLDs: ```text wrap theme={null} "ai", "io", "ag", "bz", "cc", "co", "fm", "im", "la", "me", "sc", "tv", "vc", "ws" ``` Availability and pricing vary by extension. If registration fails after payment, the system automatically retries three times. If it still can't be completed, your payment will be refunded automatically. Your domain stops serving traffic, but it is in the registrar's redemption grace period (around 30 days), where it can still be recovered with support help. After that, it's released and may become available to anyone. No. Registration details are entered during purchase and cannot currently be changed afterward. Yes. Domains bought through Lovable can be moved between workspaces. Go to **Workspace settings → Workspace domains**, click **Configure** next to the domain you want to move, and select **Move domain** from the three dots menu in upper right corner. The destination workspace must be on a Pro plan or above, and you must be an admin or owner of that workspace. Domains connected from external providers cannot be moved. ## Troubleshooting domains from other providers This usually means Lovable is still waiting for the correct DNS configuration or for changes to fully propagate. Try the following: * Use a DNS lookup tool like [dnschecker.org](https://dnschecker.org/all-dns-records-of-domain.php) to confirm that your domain resolves to the expected records. DNS changes can take up to **72 hours** to propagate. * Go to **Project → Settings → Domains** and confirm the DNS records Lovable expects. * Clear your browser cache or test the site in an incognito window. * Try removing and re-adding the domain in **Project → Settings → Domains**. This often happens when traffic is being routed incorrectly due to an IPv6 (`AAAA`) record. Check whether your domain has any `AAAA` records configured. An `AAAA` record can interfere with domain routing and cause traffic to bypass the expected destination. To resolve this: * Review your DNS settings at your DNS provider. * Remove any `AAAA` records for the domain. * Retry connecting the domain after the change has propagated. When connecting a custom domain in Lovable using manual setup, Lovable provides the exact DNS records required for verification. These records must remain unchanged until verification is complete. If the provided `A` record is modified before verification finishes, Lovable cannot verify the domain or issue SSL certificates. **While verification is in progress:** * Do not enable proxying on the `A` record. * Do not point the `A` record to a CDN or reverse proxy. If either of these happens, the domain remains in the **Verifying** state. **To fix this:** 1. Disable proxying (DNS-only) on the provided `A` record. 2. Ensure the `A` record points directly to **Lovable's IP address.** 3. Wait for the domain status to change to **Live.**