Organization Settings

Rename your Superwall organization and manage the App Store Connect keys it keeps for each Apple team: replace or remove keys and see who can view them.

Your organization's settings are shared by every app in it: its name, and the App Store Connect keys Superwall keeps for each of your Apple teams. You'll find both on any app's Settings → General page, and on the General tab of Organization settings.

Rename an organization

Organization Owners and Admins can change the organization name:

Select an app in the organization you want to rename.
In the dashboard sidebar, click Settings, then General.
Enter the new Organization name.
Click the Save changes button under it.

The updated name appears throughout the dashboard. Renaming an organization doesn't change the names of its projects or apps.

Other organization roles can view the name, but only Owners and Admins can change it.

App Store Connect keys

The App Store Connect section lists the App Store Connect API key Superwall keeps for each Apple team. The Superwall CLI and API use these keys. They're separate from the keys saved on each app, which you set up on Revenue Tracking.

The App Store Connect section listing a team key with Remove and Replace

There's no button to add a key here. When you save an App Store Connect API key on one of your iOS apps in the new dashboard, Superwall keeps a copy here if the organization doesn't have a key for that Apple team yet. It can only do that once the team has at least one app or bundle ID in App Store Connect, so Superwall can tell which team the key belongs to. Keys saved in the legacy dashboard, or before this section was added, aren't copied until they're saved again. You can also add a team key with the Superwall CLI. With no key, the section says No key saved for the team.

Each row shows a name for the key, the Apple team ID and the key ID, with Remove and Replace. The name is your Apple team's name when the key came from signing in with Apple, your organization's name when it was copied from an app, and the name given when it was added with the CLI or API.

Replace a team key

In App Store Connect, create a new App Store Connect API key under Users and Access → Integrations → App Store Connect API. Add it as a Team Key with the App Manager role, and download the .p8 file.
On the team's row, click Replace.
Enter the Key ID. The Issuer ID is already filled in.
Click Choose key file and pick the .p8 file.
Click Replace key.

Apple checks the new key before Superwall saves it. It has to be from the same Apple team: a key from a different team is refused, and the old key is kept. Once it's saved, the new key is your organization's key for that team. The old key stays active in App Store Connect, and apps that have it saved keep it.

Remove a team key

On the team's row, click Remove, then click Remove key. Requests the Superwall CLI and API send to App Store Connect on the team's behalf stop working until a key is saved for it again. Commands that use an app's own saved key, like importing keys or checking the server notification URL, keep working. The keys saved on your apps stay as they are, and the key stays active in App Store Connect.

The next App Store Connect API key saved on one of your apps for that team is kept here again.

Keys for new iOS apps

When you create an iOS app from the dashboard, Superwall tries your organization's saved keys on it. A key is imported only when Apple confirms it works for the new app's bundle ID. See Creating Projects.

Who can see it

Owners, Admins and Users (Legacy) see and manage the App Store Connect section. Editors, Readers and Analysts don't see it. See Access Controls.