Settings and account access
In the Mapbox Console, the Settings page contains your profile information, password settings, security settings, connected accounts, billing information, and a list of third-party connected applications linked to your account.
To access your account settings, log into your account and navigate to the settings section of your account by clicking the gear icon in the bottom left corner of the page.
For accounts using SAML Single Sign-On authentication, only users with the Root role assigned in their identity provider can access and update settings.
This guide will cover each section of the settings page and discuss topics such as deleting an account or resetting your password.
Profile
The Profile page contains your account information:
- name
- organization name
- avatar photo
You also have the ability to delete your account from this page. Learn more in the Delete your account section of this page.
You can adjust each of these on this page. To learn more, review the sections below.
Change or verify your email
This section covers the actions you can take with your account's email address.
Verify an account's email address
To be sure that you can receive important notifications about your account, all accounts must have a verified email address. If you sign up with an email address and password, verify it 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.
If you sign up with an authentication provider, such as Google or GitHub, Mapbox uses the email address that the provider has already verified, and you don't receive a verification link.
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
Profiletab. - 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, change the registered email address on the account from your own to one they have access to, to make sure important notifications are not missed.
Change account names
Make adjustments to your account names in this section.
Change an account holder's name or organization name
To change the account holder's name, follow these steps:
- Log in and navigate to your Account settings page, and click the
Profiletab. - 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.
Change an account's username (not possible)
It is not possible to change an account's ID (username). Your user ID is used in the path name to all tilesets and styles you create and changing this value would break any links to maps tied to that account and cause other unanticipated problems with implementations.
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.
Delete your account
You can delete an account by logging into your account, scrolling to the bottom of the Account settings, and clicking the Delete account button:
Account deletion is a permanent action that cannot be undone. We will not be able to recover your account, and the same account ID (username) cannot be re-used to create another account.
After clicking the button to delete an account, there will be a modal that requires additional confirmation that you do intend to fully delete the account. When an account is deleted, the following are effective immediately:
- All styles, projects, and data associated with the account are no longer available.
- The account cannot be logged into
- Access tokens tied to that account will be immediately terminated, and map implementations using them will no longer be able to effectively access Mapbox services.
- Authentication providers connected to the account are disconnected.
Mapbox will not automatically prorate for any unused services or subscriptions, contact our team for help.
Change or set a password
You can make adjustments to your password on the Change Password page. If your account doesn't have a password yet, this page is called Set a 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.
Set a password
An account that you create with an authentication provider doesn't have a password. Setting one gives you another way to sign in, and a way back into your account if you lose access to your provider account.
- Sign in and go to the Set a password page in your Account settings.
- Click Email me a link. Mapbox sends a link to your account's registered email address.
- Open the link and choose your password.
You can also start from the Set a password link on the Sign in page.
The link is valid for 24 hours. Signing in or out before you use the link cancels it. After you set a password, Mapbox signs you out of all sessions. You can then sign in with your password or with any connected provider.
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. If the account doesn't have a password yet, the same email lets you set one.
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 goes to significant lengths to protect the security of your account, your data, and your users.
On the Security page, you can enable or edit SAML Single Sign-On, change two-factor authentication, and generate recovery codes for your account. Learn more about these features in this section.
To learn more about security in general at Mapbox, visit the Security page for more information on how we process payments, store data, and conduct regular audits.
Single Sign-on authentication (SSO)
You can add or edit single sign-on authentication on this page. To learn more about how to make these changes, see the SSO authentication guide.
Two-factor authentication
Two-factor authentication (2FA), also known as multi-factor authentication (MFA) or two-step authentication, provides an optional, but recommended, layer of security for Mapbox accounts. Once enabled, all users will be prompted to enter a security code generated on registered mobile devices whenever they log in to the account, whether they log in with the account's password or with a connected authentication provider.
Enable two-factor authentication
When logged in to an account, you can enable two-factor authentication from the Security page. The Security page will include a barcode which you'll be prompted to scan with your mobile device, or a code that can be typed into password management services like 1Password.
Scan the generated barcode using an authenticator app on your mobile device. We recommend using Google Authenticator - it's free and available for iOS and Android.
Your mobile device will display a 6-digit code. Type this code into the field below the barcode to complete the process.
Save your recovery code in a safe place so you can access the account if you lose your device
Note that enabling 2FA for an account raises the likelihood that you or other users of the account may have trouble logging into the account in the future. Mapbox verifies ownership of an account by asking users to confirm the payment method on file for that account (such as the last 4 digits of a card or bank account, or the last 4 characters of a stablecoin wallet address). When 2FA is enabled on an account without a payment method on file, there is no way that the Support team can help users regain access to that account. Exercise care by storing 2FA recovery codes in a safe place and distributing them to new account owners when transferring ownership of an account. Consider enabling SAML SSO for team accounts or accounts with multiple users, since many SSO providers require 2FA for logging into the IdP.
Use a recovery code to access an account without the registered two-factor device
After you've set up two-factor authentication on an account, you will be redirected to a page with a recovery code. A recovery code is a single-use code that lets you sign in without your two-factor device.
Write down this code and keep it in a safe place. Treat your recovery code like a password to your account. If you lose your mobile device, you will need this code to log in to your account.
If you have already set up two-factor authentication on your account and do not have a recovery code, but can access the account with your 2FA device, go to your Security page to generate and retrieve a new recovery code for the account. Immediately store this code in a safe place, like a 1Password vault for individuals or teams.
To use the recovery code to log in to an account, you'll need the account ID (username) or email and the account's password, or access to a connected authentication provider. Follow the steps below to use your recovery code:
- Navigate to the Sign in page.
- Sign in with your preferred method: your account ID (username) and password, or your authentication provider.
- When Mapbox asks for your two-factor code, click the Lost your mobile device? link. A new field for the recovery code will appear.
- Enter your recovery code in the new field to finish signing in.
Using the account's recovery code will temporarily deactivate two-factor authentication. This gives you a chance to configure a new two-factor authentication device, enable SAML SSO authentication for teams, or decide not to reactivate 2FA for the account.
Questions about enabling MFA or accessing an account with a recovery code? Visit the troubleshooting section for recommendations and next steps to contact support.
Connected accounts
On the Connected accounts page, you can connect authentication providers, such as Google or GitHub, to your Mapbox account and disconnect them. Each connected provider is a way to sign in to your account, alongside your password if you have one.
Sign in with an authentication provider
On the Sign in page, click the Continue with button for your provider and approve the request on the provider's page. If the provider account is connected to a Mapbox account, you are signed in to that account. If two-factor authentication is enabled, Mapbox asks for your security code.
If the provider account isn't connected to a Mapbox account yet:
- If no Mapbox account uses the provider account's email address, you continue to the sign-up form to create an account.
- If a Mapbox account already uses that email address, Mapbox doesn't connect the provider to it automatically. Sign in to that account with your password or with a provider that's already connected, then connect the provider.
Connect an authentication provider
- Sign in and go to the Connected accounts page in your Account settings.
- Click Connect next to the provider. If you haven't signed in recently, Mapbox asks you to confirm it's you first.
- Sign in to the provider and approve the request. You return to the Connected accounts page, which shows the provider as connected.
Keep the following in mind:
- You can connect one account from each provider.
- A provider account can be connected to only one Mapbox account. To connect it to a different Mapbox account, disconnect it from the first one.
- The provider account's email address doesn't need to match your Mapbox account's email address.
Disconnect an authentication provider
- Sign in and go to the Connected accounts page in your Account settings.
- Click Disconnect next to the provider. If you haven't signed in recently, Mapbox asks you to confirm it's you first.
- Click Disconnect in the confirmation dialog.
After you disconnect a provider, you can no longer use it to sign in. You can connect it again later, to this account or to another Mapbox account.
Your account must keep at least one way to sign in. If a provider is the only way to sign in to your account, you can't disconnect it until you set a password or connect another provider.
Confirm it's you
Before some sensitive actions, such as connecting or disconnecting a provider or deleting your account, Mapbox asks you to confirm your identity if you haven't signed in recently. If you signed in with an authentication provider, the Confirm it's you dialog asks you to do one of the following:
- If two-factor authentication is enabled on your account, enter your 2FA code.
- Otherwise, sign in again with the same provider account. The provider opens in a new tab. After you sign in, close the tab and return to Mapbox, which continues automatically.
Billing
On the Billing page, you can manage your subscriptions, update billing information, payment information and apply credits or coupons to your invoices.
Adding subscriptions
The subscriptions section allows you to add Essential Support or Business Support. These plans give you access to the Mapbox support team and allow you to ask questions directly to Mapbox.
The Essential Support plan/Individual plan allows you to seek tailored guidance from a product expert via email, with a 3-day response time from support.
The Business Support plan allows for a more tailored support experience for you and your teammates, along with a 1-3 day response time from support.
For access to the Premium support plan, or access to the Business Support plan as a company with an annual spend of greater than $60K, contact sales for more details.
To learn more details about these plans, see the Support Plans page.
Cancel a subscription
With the Essential Support and Business Support plans you can unsubscribe at anytime through the console.
The Essential Support plan renews on a monthly basis and by canceling you will prevent renewal for the following month.
The Business Support plan renews yearly and by canceling you will prevent renewal for the following year.
To cancel these subscriptions,
You may cancel at anytime, but note that purchases are non-refundable. Once you have subscribed to a plan, your initial payment will be non-refundable.
Change billing or payment information
You can update your billing information, such as your billing address, Tax ID and Tax ID value, and your payment method or invoice information from this page in the Settings menu of the Mapbox Console.
For more in-depth information about billing, see the Invoices and billing page of the documentation.
Credit and coupons
If you have received a credit or coupon, you can apply the value/discount to an invoice by scrolling to the bottom of the Billing page in the settings and using the buttons.
Troubleshooting
Are you having trouble updating account settings, enabling SAML SSO, or logging into your account? Start here for some common troubleshooting tips for regaining account access or updating account settings. If you still cannot access your account after reviewing this documentation, include the details listed below in a support request. Our support team is standing by to help.
I'm not receiving the email to verify my account's email address. What can I do?
First, check that the email address registered to your account is a valid email address that has been spelled correctly, and that both the email address and email domain are configured to receive vendor email.
-
Invalid email addresses. Emails cannot be delivered if the address contains a spelling error, the mailbox is full, the inbox does not exist, or one of many other reasons why an email address is unable to receive messages. If the address is invalid, follow the prompts on the email confirmation page to update spelling errors or change the account's registered email. This begins the verification process again with the new address.
-
Valid email addresses. If you confirm that the email address is spelled properly and that the emails are not in your Spam folder or Promotions tab, allow for up to 60 minutes of latency throughout your email system. It's possible that your IT team maintains a filter above your inbox that requires additional processing and is delaying the email's arrival. Consider opening an internal ticket letting your IT team know about the problem, recommending they run a global search for emails from
no-reply@mapbox.comor with the subject "verify your email address".
If the email address has not received an email after 60 minutes and is configured for receiving vendor email, contact our team so we can troubleshoot with you based on the specific error codes being surfaced by your email provider.
I'm not receiving the password reset email. What can I try next?
First, check your spam folder to make sure our email hasn't been routed there. Not seeing it there, either? Sometimes password reset emails are undeliverable - maybe emails from Mapbox to your email address have bounced in the past or there have been other problems preventing the email from being delivered (especially for inactive email addresses).
If you are not receiving the password reset email, let us know by submitting the support form.
I am locked out of a Mapbox account and need to regain access. What steps can I try?
If you need to gain access to a Mapbox account, read the account lockout troubleshooting guide which provides recommendations for common scenarios. Still have questions? Submit a support request including these details to get in touch with our team.
I do not have my two-factor (2FA) authentication recovery code. What are my options?
If you do not have a 2FA recovery code for an account with 2FA enabled, the account must have a payment method on file for the Mapbox team to verify ownership of the account and remove two-factor authentication. Contact our support team to get started.
If an account does not have a payment method on file, we will not be able to verify account ownership. In this case, the only next step will be to create a new Mapbox account and add access tokens from your new account into your map implementations.
I signed up with an authentication provider and can't access my provider account anymore. How do I sign in?
Set a password for your Mapbox account. Enter your account's registered email address on the password reset page and follow the link in the email. You can then sign in with your account ID (username) or email address and the new password. If you can't access the registered email address either, read the account lockout troubleshooting guide.
When I sign in with an authentication provider, Mapbox says I already have an account with this email. What should I do?
A Mapbox account already uses the email address of your provider account, and Mapbox doesn't connect providers to existing accounts automatically. Sign in to the existing account with one of the sign-in methods in the message, then connect the provider. If you don't know the account's password, reset it.
Mapbox says my provider account is already connected to another Mapbox account. What can I do?
A provider account can be connected to only one Mapbox account. Sign in to the other Mapbox account, disconnect the provider, then connect it to this account.
I'm having trouble setting up and/or configuring SAML Single Sign-on (SSO). Can you help?
If you're having issues setting up SSO after following the steps in our documentation, submit a support request to get in touch with our team. As we troubleshoot with you, the more information about error codes and screenshots from your identity provider that you can include with your support request, the better!
It's possible that your question will be specific enough to your identity provider (IdP) that our team is unable to replicate your issue. In those cases, we may recommend that you contact your IdP's support resources directly with your configuration question.
If I cannot resolve my issue, what information should I include in my support request?
We're happy to help with your questions - contact our support team with this form. To help our team provide the most prompt resolution, include as much of the following information with your request:
For account access issues:
- Account ID (username)
- Account's registered email address
- How you sign in: with a password, or with an authentication provider (and which one)
- Access token (if applicable)
For failed login issues (with supported browsers):
- Web browser(s) and versions
- Any enabled web browser extensions you're using
- Any enabled experimental flags (chrome://flags/) if using Google Chrome
- Computer operating system and versions
- Whether you have tested this issue while in incognito mode (if applicable)
- Whether you have tested this issue with no browser extensions (if applicable)
If you do not know your browser information, you can go to the browser settings or the About page to find these details.
With the information you provide, we'll try to diagnose the issue and provide tips that help you produce the desired behavior. Thanks in advance for providing as much information as you can!