Domains

Give an app a subdomain of your engine's domain

All help topics

On the app's Domain names page, click Add domain name, pick the subdomain option, type a name and click Add subdomain: it is live at once, with no DNS to set up.

  1. On Your apps and services, click the app, then its Domain names tile (or Manage domain names).
  2. Under Custom domains, click Add domain name.
  3. Pick Subdomain of your engine's domain and type the subdomain: lowercase letters, numbers and hyphens, with no hyphen at the start or end.
  4. Under Routes to, keep the app's main canister (tagged Main) unless you are exposing another canister as a service endpoint.
  5. Click Add subdomain. "Subdomain saved." appears and the new address is listed, with edit and Remove next to it.
Good to know
  • Only the engine's owner and admins can add, edit or remove subdomains. Others see "Only an engine owner or admin can add subdomains."
  • Each canister of an app can hold one subdomain. When every canister has one, edit or remove one to add another.
  • No subdomain is possible while the engine has no domain yet, and they don't resolve while the engine's domain is still being set up.
  • Domain changes are limited to about 3 per hour.
  • The app keeps its Canister address whatever you add or remove; it can't be renamed or removed, so point anything you can't easily update at it.
  • Internet Identity gives every address its own accounts: people who sign in at the subdomain aren't the same users as at the canister address, unless the app sets the canister address as its derivation origin and lists the subdomain in its alternative origins.
  • A Caffeine app's domain is managed in Caffeine: use Edit in Caffeine.

More about the same page

Still stuck? Contact support