Platform Admin Access

A Platform Admin is a Equity Analytics support team member who needs access to specific districts in order to help configure, troubleshoot, or operate the platform on a district's behalf.

This page covers how Platform Admin access is scoped, how to request changes to access, and what to do if a Platform Admin ends up in an unexpected state.

How Access Is Scoped

A user is a Platform Admin when both of the following are true:

  1. The user's Platform Admin flag is checked.
  2. The user has at least one supported district.

A user with the Platform Admin flag set but zero supported districts cannot be saved. The application rejects the change. This guardrail prevents a Platform Admin from accidentally being left in a "logged in but locked out of every district" state.

Platform Admin vs. Admin

A regular Admin sees and operates in every district in the system. The supported-districts rule only applies to Platform Admins. Admins are reserved for the engineering team; Platform Admins are the right role for almost all support work.

What a Platform Admin Sees

Inside the app, a Platform Admin only sees the districts in their supported list:

Switching Between Districts

A Platform Admin who supports more than one district can switch between them at any time:

  1. Click your user avatar in the top right of the navigation bar.
  2. Click Accounts in the dropdown.
  3. On the Accounts page, click the Switch button next to the district you want to use.

The Accounts page only lists districts you support, so you cannot accidentally switch into one you don't have access to.

After switching, every page, report, and upload is scoped to the newly selected district until you switch again or sign out.

If a stale link or bookmark sends you to a district you don't support, the app moves you back to one of your supported districts on the next page load. To gain access to a new district, request the change through a Helpdesk Ticket.

Requesting a Change to Platform Admin Access

Platform Admin assignments are managed by the Equity Analytics engineering team. If you need a user added or removed as a Platform Admin, or you need to change which districts a Platform Admin supports, open a Helpdesk Ticket with the following information:

The engineering team will apply the change and confirm by replying on the ticket.

A Platform Admin must support at least one district. To fully revoke a user's Platform Admin status, request that the Platform Admin flag be removed entirely. Asking for a Platform Admin to keep the flag but lose all districts is not a valid state and will be rejected.

Troubleshooting

A Platform Admin reports they "lost access" to a district. Open a Helpdesk Ticket with the user's name and the district they expected to see. The engineering team will check whether the district is in their supported list and re-add it if appropriate.

A Platform Admin can't sign in to any district. Open a Helpdesk Ticket. The engineering team will confirm whether the Platform Admin flag and supported districts are set correctly on the account.

A Platform Admin tried to switch to a district they don't support and ended up on a different one. This is intentional. The application bounces them to a supported district rather than letting them sit on a district with no access. If they should have access to the district they tried to switch to, request the change as described in the section above.

Need Help?