Add your first domain
Add and configure your first domain on vanity.domains, exploring middleware, DNS, and settings to customize its functionality.
This guide will show you how to add your first domain and configure its settings in the dashboard. Let's get started!
Adding a new domain
- Log in to your vanity.domains account and access the dashboard.
- Click the "+ Add domain" button.

- In the "New domain" modal, fill out the form with the following information:
- Domain: Enter your domain name (e.g., example.com).
- Custom metadata: add key-value metadata for the domain.
- Group: Select a group from the list (a "default group" is created automatically on signup).
- Create a preview domain: Check this box if you want to test the domain before it's fully configured (DNS propagated and SSL certificate provisioned).
- Click the "Create" button.
After clicking "Create," you'll be redirected to the domain details page, which has several tabs:

Middleware
This tab lists available middleware that can be used to perform logic on the edge (between the visitor and the origin server). Enable middleware by checking the corresponding checkbox, and configure settings by clicking the middleware name to expand its variables.

DNS
Here, you'll find the DNS configuration needed to set up the domain correctly. Add the provided CNAME records to your DNS provider. The DNS status will show as "Pending" until the records are set up, after which it will change to "Active."

Settings
In this tab, you can configure vanity.domains settings for your domain, such as:
- Origin URL
- Custom metadata
- Assigned group
- Enabling/disabling the testing domain
- Setting up a URL

If you enabled the testing domain, you can visit it to preview how your domain will look once it's active and configured. Feel free to experiment with different settings and middleware to achieve your desired results.
πΒ Congratulations! You've added and configured your first domain on vanity.domains. Enjoy exploring the platform and managing your domains.
Last updated on August 4, 2021