Engines

Rename an engine

All help topics

Owners and admins rename an engine on its Settings page; the engine ID stays the same, and its address follows the new name.

  1. Open the engine and click Settings in the engine sidebar, under Manage.
  2. In the card with the engine's name, click Rename.
  3. Type the new Engine name, 3 to 64 characters.
  4. Click Save. Saved appears next to the name. Cancel, or Escape, keeps the old name.

Good to know

  • Only the engine's Owner or an Admin can rename it. Developers see no Rename button, and read "Only the engine owner or an admin can rename the engine."
  • The engine address and every app address under it change to follow the new name. The old addresses keep working until the new ones are ready, usually within a few minutes. The Domain section tracks it: Name saved, Issuing the new address, Setting up DNS and a certificate, Moving apps and retiring the old address.
  • An engine gets at most 3 new addresses in 24 hours. After that, the name still changes but the new address waits until the limit allows another one.
  • Internet Identity gives each address its own accounts: people who sign in to an app under the engine's domain become new users after a rename, unless the app pins its derivation origin to its canister address and lists the new address in its alternative origins.
  • The name's DNS-safe form (letters and digits, everything between them turned into single dashes) must fit in 58 characters. A name the engine refuses reads "The engine refused this name. Choose a different one."
  • The engine ID never changes, so anything that uses the ID keeps working.

More about the same page

Still stuck? Contact support