Skip to main content

Domains

Connect your own custom web addresses (like shop.yourcompany.com) to Orbit.

What is this?​

By default, your workspace and public pages live on an Orbit web address (like your-workspace.optimaorbit.com). The Domains page allows you to replace these default addresses with your own professional, custom domains.

Why would I use this?​

Using your own domain builds trust. When customers visit your online store, read your documents, or ask for support, seeing your actual company web address makes the experience feel secure and fully branded.

You may need to update Domains when:

  • You purchase a new web address for a new product launch.
  • You want to set up an internal login link for your employees (like admin.mycompany.com).
  • You are moving a storefront from an old platform to Orbit.

How to get here​

  1. Open Orbit.
  2. Go to Settings in your navigation menu.
  3. Under Organization, select Domains.

Application URL: /org/settings?tab=domains

Before you begin​

To complete this process, you must have access to the website where you bought your domain (like GoDaddy, Namecheap, or Cloudflare). You will need to copy information from Orbit and paste it into your domain provider's DNS settings.

How to use this page​

You can add different domains for different parts of your business.

(Image: Domains Screen)

Domain Types​

The page lists several categories where you can attach a domain. Depending on your subscription plan, some of these may be locked.

Admin Portal Domain​

What it is: The link your internal team uses to log into Orbit. Things to know: You can only have one Admin domain for your whole company.

Papers Library Domain​

What it is: The link where your public documents and manuals are published. Things to know: This requires an active Orbit Papers subscription.

Storefront Domains​

What it is: The link where your customers shop. Things to know: If you have multiple projects (e.g., selling shoes in one project and electronics in another), you can add a separate Storefront Domain for each project.

Orbit Resolve Domains​

What it is: The link for your customer support desk. Things to know: Customers visit this link to read help articles or submit support tickets.

Orbit Pulse Domains​

What it is: The link for your marketing pages and blogs.

Adding a New Domain: Step-by-Step​

  1. Click Add: Click the Add domain button under the relevant section (e.g., Storefront).
  2. Enter the URL: Type the web address you want to use (e.g., shop.agiledigest.com).
  3. Select a Project: (For Storefronts, Resolve, and Pulse only) Choose which of your projects this domain belongs to.
  4. Choose a Landing Page: Select what the user should see if they go to the main page of that domain.
  5. Click Save.

Orbit will now give you a list of "DNS Records" (usually a TXT record and a CNAME record).

  1. Update your Provider: Log into GoDaddy/Cloudflare/etc., and paste these exact records into your DNS settings.
  2. Verify: Come back to Orbit and click Verify / refresh.

Status Meanings (What happens after I save?)​

After you add a domain and DNS records, you will see a colored status badge:

  • 🟡 Awaiting DNS: Orbit is waiting for your domain provider to publish the records. This can take anywhere from 5 minutes to an hour. Just wait!
  • 🔵 Issuing SSL: Orbit found your records! It is now automatically securing your site with a free SSL certificate. This usually takes just a few minutes.
  • 🟢 Active: Success! Your custom domain is live, secure, and ready for customers to use.
  • 🔴 Failed: Something went wrong. Check that you pasted the DNS records exactly as shown and try verifying again.

Example​

You launch a new project called "Winter Clothing" and want customers to shop at winter.agiledigest.com. You click Add storefront domain, type in winter.agiledigest.com, select the "Winter Clothing" project, and choose the home page. You take the DNS records Orbit gives you and paste them into GoDaddy. Thirty minutes later, you click Verify, the status turns green, and customers can now buy clothes securely on your custom web address!

Common questions​

What is a "Landing Page"?​

It is simply the "front door" of your domain. If someone types shop.yourcompany.com without any specific product link, the Landing Page setting tells Orbit which page to show them. You can easily change this later by clicking Edit landing page.

Why is the "Add Domain" button greyed out?​

If a button is locked and shows a yellow warning, it means your current billing plan does not include that feature. For example, you cannot add a Storefront domain if you do not have an active E-commerce subscription.

Common problems​

"Awaiting DNS" is stuck for hours​

Why you're seeing this: You likely entered the DNS records incorrectly at your provider, or (if using Cloudflare) you left the proxy turned on. How to fix it: Double-check the records. Crucial: If you use Cloudflare, ensure the cloud icon next to the CNAME record is set to DNS Only (Grey Cloud), not proxied (Orange Cloud).

Things to keep in mind​

  • Do not delete records: Even after your domain goes Active, do not delete the DNS records from your provider. If you delete them, your site will eventually go offline.
  • Root Domains (Advanced): If you are trying to use a root domain (like agiledigest.com instead of shop.agiledigest.com), standard CNAME records don't work. Follow the step-by-step guide provided in the app to learn how to use ALIAS/ANAME records or Cloudflare flattening.

Technical / Implementation Notes​

Component: DomainsTab API Endpoints:

  • GET /org/config/domains
  • POST /org/config/domains
  • POST /org/config/domains/{id}/verify
  • DELETE /org/config/domains/{id}
  • PUT /org/config/domains/{id}/landing Source files: /src/routes/org/DomainsTab.tsx Downstream usage:
  • The domains module relies on Cloudflare for SaaS integration.
  • The backend handles generating verification TXT records and tracking the cf_ssl_status and cf_hostname_status through Cloudflare's API.
  • The UI handles the validation state (DomainGate) checking if tier_not_allowed or ecom_not_active before allowing a domain to be provisioned.