Forge app rename: is the new name propagated to the app users of all installed sites?

When a Forge app is renamed in the developer console, the app user that Jira created on each site at install time should be considered. This post asks how the rename is expected to behave.

Questions

  1. Is the new name propagated to the app user on every site where the app is already installed, or is the app user’s display name fixed at install time?
  2. If it is propagated, what is the expected delay between the rename in the developer console and the change being visible on installed sites? Is a trigger required (new deployment, installation upgrade, reinstall)?
  3. Does the behaviour differ between sites that installed the app before the rename and sites that install it after?
  4. Is the behaviour the same for an app installed through manual sharing (distribution link or direct install) and for the same app installed from the Marketplace? Does the Marketplace listing name, which is managed separately from the developer console name, play any role in the app user’s display name?

Context

  • Consumers that look up an app user by display name need to know whether to match only the current name or earlier names as well.
  • The same app is distributed both ways, manual sharing and Marketplace.

Observation

  • On one development site, the new name appeared on the app user after the rename.

I would like to get an official response from Atlassian instead of guessing…

Thanks ! :slight_smile:

I tested this today on a scratch app, renaming it through the GraphQL updateAppDetails mutation (the name the console settings show).

The app user is one account per environment. Dev and production each got their own accountId, and it shows the same name on a second site where the app isn’t installed.

No trigger is needed. GET /rest/api/3/user?accountId=... had the new name 30 to 90 seconds after most renames, production included. That used to be FRGE-525.

The caches lag, though: one rename took almost four minutes on the second site, and /user/search?query= still matched a name I’d replaced seven minutes earlier.

I’d match on accountId only. I didn’t test a Marketplace-listed app.