Owners and admins rename an engine on its Settings page; the engine ID stays the same, and its address follows the new name.
- Open the engine and click Settings in the engine sidebar, under Manage.
- In the card with the engine's name, click Rename.
- Type the new Engine name, 3 to 64 characters.
- 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.