Account FAQ


How do I change my email address?

  1. Log in and navigate to the Account page page.
  2. Enter your new email address and click Update.

How do I change my password?

  1. Log in and navigate to your Account page.
  2. Click the Change password link below the email address field.
  3. Enter your new password, enter it again to confirm it, then click Update your password.

How do I reset my password?

If you’re having trouble logging in, try resetting your password by providing the email address that’s associated with your Mapbox account. We’ll send you an email with further instructions.

If you don’t remember your email address or you’re having other access problems, contact our support team and we’ll look into it.

How do I change my username?

It’s not possible to change your username. Doing so would break links to your maps and could cause unanticipated problems.

Instead, you can create a new account, recreate your maps, and update your web and mobile applications to reference the new account and maps. Once this transition is complete, you can cancel the old account without breaking any links to your maps.

See our Recreate and reference maps guide to learn more about recreating your map in your new account.

How do I delete my account?

You can downgrade your plan to Starter at any time, which has no up-front monthly cost besides any charges incurred if you exceed the limits of that plan. If you wish to completely delete your account from our system, you may do so from the Billing page.

delete account

When you delete an account, the change is effective immediately and all maps and data are removed:

  • Projects and data associated with your account will no longer be available.
  • You will not be able to use the account to log in to Mapbox.
  • We won’t automatically prorate for unused time or map views on your current subscription. If you are changing plans in the middle of your billing cycle and expect a prorated invoice, send an email to so we can review your account.


How do I change my plan?

Looking for our Pricing page that lists plan types and what they offer?

Changes to your plan, including upgrades and downgrades, are effective immediately:

  • You will be charged the price of the new plan right away.
  • We won’t automatically prorate for unused time or map views on your current subscription. If you are changing plans in the middle of your billing cycle and expect a prorated invoice, send an email to so we can review your account.
  • If you have exceeded the capacity of your current plan, we will add an overage charge to your next invoice.

How do I apply a coupon to my account?

If you’ve received a coupon code, you can use it when you sign up or upgrade your account on your billing page after you’ve filled in your payment details. If you have any issues, contact for further assistance.

apply a coupon to your account

What do I do if my credit card was declined?

Unfortunately, banks don’t usually offer us detailed information when a credit card is declined. If the card information seems correct, contact your bank, inquire for more information, and ask for future charges to be accepted.

If that doesn’t work, get in touch with

What happens if I exceed my plan limits?

If you have a Starter plan or any paid plan, additional map views are automatically served at $0.50 per 1,000 map views. As long as you make sure your payment information is valid, we will invoice you automatically. We will contact you via email as soon as you exceed your plan so you can take action if necessary.

If you have a free account, you can upgrade your plan to keep your maps online. If your quota is exceeded and overage charges have been applied to your account, you must pay or otherwise resolve those overage charges to unlock your account. We will not automatically unlock the account if you fall back below the limits of the free plan.

Do you offer a non-profit or educational discount?

The features included in the non-profit and education plan we offered in the past are now available through the free Starter plan. We no longer offer a specific plan for non-profit or student users.

Can I pay prepay for my Mapbox plan?

Yes! You can add prepaid credit to your account at any time. Account credit will be applied to future invoices on a monthly basis. We won’t charge your primary payment method until you run out of credit.

  1. Navigate to the Billing page.
  2. Click Add or edit payment details and enter your credit card information.
  3. Once you have added a payment method, a link to Add credit will appear below your payment details.
  4. Click Add credit and enter the amount of credit you want to purchase.
  5. Your credit card will be charged immediately. If you don’t have a card on file you will be asked to supply one.
  6. After you purchase credit, a record of the purchase will be available on your Upcoming invoice.

What payment methods are accepted?

You can pay for your Mapbox account with the following credit, debit, prepaid, and gift cards: Visa, MasterCard, American Express, JCB, Discover, and Diners Club. We only accept payment by check or ACH debit if you choose to be invoiced, which is offered for Mapbox Enterprise plans and pre-paid credit transactions for Premium accounts.

If you do not have access to one of these cards, please consider using a prepaid card instead. Prepaid cards are available from several vendors, including:

Can I add custom information to my billing statements?

You can provide optional contact information to display on your statements.

  1. Log in and navigate to the Billing page.
  2. Open any invoice on your account’s billing page.
  3. Click the Edit contact info link in the Statements section at the top of the page.
  4. Enter the contact information you would like to add in the text field and click Update contact info.
  5. Your additional Contact information will now appear on your statements.

billing contact info

How will I receive bills from Mapbox?

We send you a notification via email each time we charge your credit card on file. You can for your account at any time at any time by visiting your billing page.

How can I update my payment information?

Log in into your Mapbox account and visit the update payment page.

Mapbox plans

What are the features of the Premium plan?

Guaranteed uptime

Our services are guaranteed to be available and responsive 99.9% of the time. If we don’t meet this guarantee, we’ll issue a service credit. Check out our Status page to sign up for service alerts delivered by text or email.


Mapbox is built for scale: our web service traffic accommodates thousands of requests per second. We can handle these requests because each regional origin scales independently based on real time traffic. Our global network runs in over 60 locations around the world, which is important for low latency delivery of cached maps and protects us from failure scenarios, like natural disasters.

Dedicated support

Our Premium plan offers dedicated support from the whole Mapbox team. We guarantee a response within two business days for product questions, bug reports, feature requests, and development issues that you send to us. We guarantee a response within 24 hours for a complete loss of service.

Commercial use

We want to make it easy to use Mapbox in commercial applications. A commercial application is any web application that is not free and publicly available. A Premium plan covers your commercial use of Mapbox for up to 250 unique end-users and 1,000 tracked assets.

The nitty-gritty

How many styles are allowed with each plan?

All plan levels are allotted a set maximum number of styles.

Mapbox Studio Classic style limits are as follows:

  • Starter: 10
  • Premium: 30

Mapbox Studio style limits are as follows:

  • Starter: 20
  • Premium: 30

For higher limits, contact us for details on our Enterprise plans.

How can I upgrade or downgrade my plan?

  1. Log in and navigate to our Pricing page.
  2. Select the plan you need from the list and then click Upgrade or Downgrade to adjust your plan. Some plans may be disabled if your current usage is greater than the plan allows.

See also: Change your plan

Which plan is required for a commercial application?

Commercial applications require a commercial plan, except when the application is built exclusively for use with Mapbox Mobile SDKs for Android or iOS.

Commercial applications include those that:

  • Require payment to access.
  • Are behind a firewall.
  • Are for internal business use by employees, contractors, or agents of the business.
  • Are not accessible or functional for members of the general public.

A Premium plan includes up to 250 commercial users and 1,000 tracked assets, and Enterprise plans can scale to any size. Please contact us for Enterprise pricing.

Which plan is required for asset tracking applications?

Asset tracking applications require a commercial plan. A commercial asset is defined as one item that is tracked or monitored on the map via GPS or similar means. A Premium plan includes up to 1,000 tracked assets and 250 commercial users, and Enterprise plans can scale to any size. Please contact us for Enterprise pricing.

Asset tracking applications built exclusively for use with Mapbox Mobile SDKs for Android or iOS are exempt from this categorization and are priced according to our standard mobile pricing, which is based on monthly active users (MAU).

Which plan is required for using maps in broadcast or film?

If you are interested in using Mapbox maps in a broadcast, you must be on an Enterprise account. For enterprise inquiries, please contact

Which plan is required for hybrid apps?

Apps built with the native Mapbox iOS and Android SDKs are billed based on monthly active users instead of map views. However, not all third-party frameworks track usage the same way.

Third-party frameworks built from the native Mapbox Mobile SDKs are typically billed based on monthly active users. Apps built with other third-party frameworks are billed based on map views.

See our Pricing page to see how many mobile users and map views are included in your plan.

Here are examples of SDKs and frameworks and whether Mapbox tracks usage through mobile users or map views.

SDK or framework mobile users map views
Mapbox iOS SDK (native) x  
Mapbox Android SDK (native) x  
React Native Mapbox GL x  
Cordova + native SDK x  
Xamarin + native SDK x  
Phonegap + Mapbox.js   x
Cordova + Mapbox.js   x
Mapbox GL JS-based hybrid SDKs   x

See our documentation on hybrid frameworks and Mapbox for more information about building hybrid apps with Mapbox.

Do you offer custom plans?

Mapbox Enterprise offers high-volume plans, large storage, extended custom maps, dedicated support, and more. It also offers custom offline solutions and access to Atlas Server. Atlas Server is the best of Mapbox running on your private infrastructure. Run it in your cloud, on your servers, behind a firewall, or completely offline.

For details on all other plans, see our Pricing page.

Account security

Two-factor authentication, also known as multi-factor authentication (MFA) or two-step authentication, provides an optional, but recommended, layer of security to your account. Once enabled, you’ll be prompted to enter your password as well as a security code generated on your mobile device whenever you log in.

Two-factor login

How do I enable it?

When you’re logged in to your account, you can enable two-factor authentication under the Security tab in your account page.

two-factor authentication location

After clicking on the security tab, a barcode will appear on your screen and you’ll be prompted to scan scan it with your mobile device.

two-factor authentication enable

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. For Windows phone, use the Authenticator app.

Your mobile device will display a 6-digit code. Type this code into field below the barcode to complete the process.

What if I lose my mobile device?

After you’ve set up two-factor verification on your account, you will be redirected to a page with a recovery code.

two-factor authentication recovery code

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 into your account.

If you have previously set up two-factor authentication on your account and do not have a recovery code, go to the Security tab in your Account page to generate and retrieve your recovery code.

How do I use a recovery code?

A recovery code is a single-use code that lets you sign in without your two-factor device. To use the code, you’ll still need your username or email, and your password. To use your recovery code:

  1. Navigate to the Sign in page.
  2. Enter your username and password and click Sign in.
  3. Click the Lost your mobile device? link below the Sign in button. A new field will appear.
  4. Enter your recovery code in the new field and click Sign in.

Using your recovery code will temporarily disable two-factor authentication and give you a chance to configure a new two-factor device.