• Product Introduction
  • Quick Start
    • Importing a Git Repository
    • Starting From a Template
    • Direct Upload
    • Start with AI
  • Framework Guide
    • Frontends
      • Vite
      • React
      • Vue
      • Hugo
      • Other Frameworks
    • Backends
    • Full-stack
      • Next.js
      • Nuxt
      • Astro
      • React Router
      • SvelteKit
      • TanStack Start
      • Vike
    • Custom 404 Page
  • Project Guide
    • Project Management
    • edgeone.json
    • Configuring Cache
    • Building Output Configuration
    • Error Codes
  • Build Guide
  • Deployment Guide
    • Overview
    • Create Deploys
    • Manage Deploys
    • Deploy Button
    • Using Github Actions
    • Using Gitlab CI/CD
    • Using CNB Plugin
    • Using IDE PlugIn
    • Using CodeBuddy IDE
  • Domain Management
    • Overview
    • Custom Domain
    • HTTPS Configuration
      • Overview
      • Apply for Free Certificate
      • Using Managed SSL Certificate
    • Configure DNS CNAME Record
  • Observability
    • Overview
    • Metric Analysis
    • Log Analysis
  • Pages Functions
    • Overview
    • Edge Functions
    • Cloud Functions
      • Overview
      • Node.js
      • Python
      • Go
  • Middleware
  • KV Storage
  • Edge AI
  • API Token
  • EdgeOne CLI
  • Copilot
    • Overview
    • Quick Start
  • Pages MCP
  • Pages Skills
  • Message Notification
  • Integration Guide
    • AI
      • Dialogue Large Models Integration
      • Large Models for Images Integration
    • Database
      • Supabase Integration
      • Pages KV Integration
    • Ecommerce
      • Shopify Integration
      • WooCommerce Integration
    • Payment
      • Stripe Integration
      • Integrating Paddle
    • CMS
      • WordPress Integration
      • Contentful Integration
      • Sanity Integration
      • Payload Integration
    • Authentication
      • Supabase Integration
      • Clerk Integration
  • Best Practices
    • AI Dialogue Deployment: Deploy Project with One Sentence Using Skill
    • Using General Large Model to Quickly Build AI Application
    • Use the DeepSeek model to quickly build a conversational AI site
    • Building an Ecommerce Platform with Shopify
    • Building a SaaS Site Using Supabase and Stripe
    • Building a Company Brand Site Quickly
    • How to Quickly Build a Blog Site
  • Migration Guides
    • Migrating from Vercel to EdgeOne Pages
    • Migrating from Cloudflare Pages to EdgeOne Pages
    • Migrating from Netlify to EdgeOne Pages
  • Troubleshooting
  • FAQs
  • Contact Us
  • Release Notes

Custom Domain

Custom domain names have the following advantages:
Brand show: Use your own domain name to enhance professional image.
SEO optimization: It is conducive to search engine indexing and ranking.
Better control: Full control of the domain DNS record.
Flexibility: Configure multiple custom domain names to facilitate management for different markets or purposes.

Add Custom Domain

When the acceleration region of a project is "Chinese mainland availability zone" or "global availability zone (including Chinese mainland)", the added domain must first complete registration with the ICP.
To add a custom domain to your project, follow the steps below:
1. Log in to the console: Enter the project description and switch to the "Domain Name Management" page.
2. Add domain: Click add custom domain.



3. Input domain: Input your root domain (for example: example.com) or subdomain (for example: www.example.com) in the popup.
4. Verify ownership: Add resolution record at the domain location registrar according to the guide in the pop-up window.



5. Add CNAME: Configure the CNAME record at the domain location registrar.




HTTP/2

EdgeOne Pages supports clients to initiate requests using the HTTP/2 protocol. HTTP/2 (HTTP 2.0, hypertext transfer protocol version 2) is the second major version of the HTTP protocol, which can effectively reduce network delay and improve site page loading speed.

Note:
1.If client requests do not use HTTP/2, EdgeOne Pages is compatible with HTTP 1.x protocol access.
2.The current custom domain must have an SSL certificate configured. For how to configure an SSL certificate, see HTTPS configuration.

Enable IPv6 Access

EdgeOne Pages supports one-click activation of IPv6 access. Enabled, your project will have dual-stack access capability, ensuring stable access in IPv6-only environments and effectively improving loading performance in emerging network environments. This not only helps you meet sector-specific regulatory compliance for IPv6 but also ensures your acceleration services remain continuously compatible in future network evolution.


Associating with Environment

EdgeOne Pages supports associating a custom domain name with a specific project environment (production or preview). You can configure independent access entrances for different business stages (for example, official launch, Internal Testing).
Environment mapping rule:
Production environment: Associated with the project's production branch (for example, main).
Preview environment: Associated with other development or test branches except the production branch.
Dynamic pointing: Regardless of the associated environment, the custom domain name will always automatically direct to the latest successful deployment in that environment, ensuring visitors always access the latest content.
Flexibly adjust: On the edit interface of the domain, you can change the environment associated with the domain at any time to implement rapid switching of access traffic between different versions.

Note:
Please ensure an effective deployment record already exists in the selected associated environment. If ALL deployments in the domain-associated environment are deleted, accessing that domain name will return 404.

ai-agent
You can ask me like
How to Get Started with EdgeOne Pages?