Settings and account access
The Settings page is where you can delete an account or manage the account's profile information, billing and authentication methods, and connected apps. To access the Settings page, log into the account and navigate to account.mapbox.com/settings.
Note that for accounts using SAML Single-sign on authentication, only users with the Root
role assigned in their identity provider can access and update settings.
Profile
All users who login to an account with the account's password assume Root
user privileges by default, and can access and update the account's settings. Or, if the account has enabled SAML Single sign-on authentication, there are two user roles that are available: Root
and Admin
, which are assigned to users in an identity provider (like Okta). For accounts with SSO enabled, only users with the Root
role will be able to access and update settings as described below. Learn more about user roles in the SAML SSO documentation.
Verify an account's email address
To be sure that you can receive important notifications about your account, all accounts must verify the registered email address by clicking a link that we send immediately upon account creation. The verification process must be completed to gain full access to the Mapbox applications. Verification links are valid for 24 hours and can be re-requested when logged into your account. If an account's email address is updated, you will be prompted to verify the new address.
Having trouble verifying your account's email address? Visit the troubleshooting section for recommendations.
Change an account's email address
Each Mapbox account supports one registered email address. To update an account's email address, follow these steps:
- Log in and navigate to your Account settings page, and click the
Profile
tab. - Enter the new email address and click Save changes.
An account's registered email address is the primary email address to which we send important account and billing notifications. If you are inheriting an account from a team member, consultant, or client, update the primary email address to be one that multiple members of your organization have access to, like developers@mapbox.com
. Similarly, if you are transferring an account to a team, consultant, or client, changing the registered email address on the account from your own to one they have access to make sure important notifications are not missed.
Change an account's username (not possible)
It is not possible to change an account's ID (username). Doing so would break links to maps tied to that account and could cause other unanticipated problems with implementations that depend on that account ID.
Instead, you can change the account holder's name or create a new account, transfer your map styles and update your web and mobile applications to reference the new account's tokens and styles. For more information about setting up an account for collaboration or preparing for an ownership transition, see our guide for collaboration.
Once this transition is complete, you can delete the original account without breaking any links to your maps.
Change an account holder's name
To change the account holder's name, follow these steps:
- Log in and navigate to your Account settings page, and click the
Profile
tab. - Enter the updated name in the "Name" field and click Save changes.
If your account's type is "Business", you can also update your organization's name on the same Profile
tab of the Account settings page.
To update the details about your organization that are included on your invoice, see the documentation for adding custom information to an invoice.
Questions about updating the profile information for an account? Visit the troubleshooting section for recommendations and next steps to contact support.
Password
Change your password
- Log in and navigate to your Account settings.
- Enter your current password and new password in the appropriate fields.
- If you have two-factor authentication enabled, enter your two-factor authentication code.
- Click Save new password.
Reset your password
If you're having trouble logging in to an account, try resetting the account's password by providing the email address that's associated with the account. We'll send the registered email on file for that account an email with further instructions to reset the password.
The link that we send in the password reset email is only valid for 24 hours. If you receive an Invalid token
error message or have waited more than 24 hours, you'll need to request another password reset email.
Questions about changing or resetting an account's password? Not receiving the reset password email? Visit the troubleshooting section for recommendations and next steps to contact support.
Security
Mapbox is critical infrastructure for our customers. We go to significant lengths to protect the security of your account, your data, and your users. Visit our Security page for more information about how we process payments, store data, and conduct regular audits.
An account's Security Settings page is where you can enable and manage SAML Single sign-on and/or two-factor authentication for an account.
Single Sign-on authentication (SSO)
Manage your organization's access to Mapbox accounts while adding another level of security with SAML Single sign-on (SSO). SSO enables members of your organization to authenticate into a Mapbox.com account through any trusted, third-party identity provider that supports the SAML2.0 protocol.
SAML SSO capabilities
Supports:
- SAML2.0 protocol
- Identity provider (IdP) initiated login
- Shared accounts that multiple users can access
- User roles of
Root
andAdmin
Does not support:
- JIT (Just in Time) provisioning
- SCIM provisioning / de-provisioning
- Domain control or domain lockout
- Service provider (SP) initiated login
- Identity provider (IdP) initiated single logout
- OAuth, OpenID Connect, Kerberos, other protocols
- Multiple identity providers for a single account
- SAML authentication for Atlas on-premises
- Individual user accounts, a nested sub-account hierarchy, or separate, connected accounts
Setting up SAML SSO for your Mapbox account
SAML Single sign-on for Mapbox can be configured with any identity provider that supports the SAML 2.0 protocol. Integrate the Mapbox SAML applications offered by Okta, Azure AD, and OneLogin for streamlined setup and IdP specific documentation, or learn more about the general steps for setting up SSO with any identity provider below.