Rename a theme with theme rename

theme rename changes the local display name, folder key, theme metadata and saved connection identity together.

Command

upstorr theme rename my-brand-theme "My New Theme Name"

Run it from the workspace that contains the theme. The new normalized key must not collide with another theme in that workspace.

Use this command instead of renaming the folder manually. A manual rename can leave theme.json, storefront.json, generated metadata and connection records disagreeing about which theme they belong to.

Renaming local source does not silently rename an already installed merchant theme. Upload a later version and let the merchant review the resulting theme or update normally.

Common problems

• Theme not found: use the folder key shown under themes/ or the current display name.
• Name is ambiguous: use the exact theme key.
• Destination already exists: choose a unique name; the CLI does not overwrite another directory.