Settings tab
This core reference entry is suited for beginner to intermediate-level builders.
The Settings Tab is where you perform administrative tasks. For example, controlling who can edit the app, setting app-wide appearance settings, such as a color palette or an icon, configuring the domain name, managing languages and translations, controlling SEO behavior, and configuring the API. There are a number of sub-tabs with controls over different aspects of the app.
App plan
This is where you see which Bubble app plan your current app is on. Remember that Bubble plans generally apply at the app, not the user, level. In this sub-tab, you can see some of the capabilities of your current plan and change your plan as desired.
Billing information
On the App Plan tab, you'll see information about which credit card is on file for your Bubble account; this is the payment method that will be charged for any changes. You will also see information about any active coupons / discounts on your account.
Paid plugins
The App Plan tab will also show you information about paid plugins that are attached to this app. Remember that plugins are purchased on a per-app basis.
General
This sub-tab contains a mix of different settings - some design-oriented, some privacy-oriented, some app-level management oriented.
Google API keys
See this article on how to set up your Google Maps and Geocode API Keys.
Do not send an email when the application is being rate-limited for map loads
If you have your Google keys set up, your app will use those keys when making requests from Google Maps and Geocode. Google rate-limits these requests, and by default, you (the app creator) will receive an email from us when the application is being rate-limited. Checking this box will disable that email.
Algolia
See this article on how to set up the integration between your app and Algolia.
Prevent clipping fields on rows too large to fit in Algolia (advanced)
Algolia has a default size limit for data fields that are sent to it. Bubble implements clipping correspondingly to help Bubble apps stay under that default size limit. However, advanced users may not want Bubble to do this for various reasons, and can use this setting to control that.
Optimize application
Over time, as many changes are made to your Bubble app, the application will remember information about parts of it that may no longer be relevant (e.g. a style that used to exist but no longer, or a data type that used to exist but has since been deleted).
This tool in the General tab will help you clean some of that unused content out, which could improve performance of your app overall. Note that doing so will prevent you from certain actions, such as restoring a deleted data type, if you've cleared out the history of that deleted data type.
Clean app changes history
Clearing your app history removes all saved history and cannot be undone. See the table below for details on which data is affected.
This feature removes the saved history of changes to your app. If you no longer need this history—which allows you to revert your app to a previous state—you can clear it to improve editor performance.
Undo history
❌
Revert app to custom date/time
✅
Revert app to custom save point
✅
Version Control changelog
✅
Export application
Bubble apps can be exported as a JSON file - please see this article.
Import application
If you have the JSON of a Bubble app (e.g. from exporting a Bubble app, see above), you can import it into the current app with this feature.
Domain / email
This sub-tab is where you control your app's custom domain. By default, apps come with a URL like myappname.bubbleapps.io, but if you've bought a domain that you want to use, like myappname.com, you can connect it to your app here. Along with that, you can also configure settings so that your app can send out emails at greater scale.
Languages
This sub-tab contains Bubble's feature to help you localize your app to different languages. Here, you see different "app texts" - snippets of text that appear throughout your app, some of which are built-in, others from plugins, and still others that you define. For any of these snippets, you have the opportunity to provide the translation of that snippet into any other language that Bubble supports out of our catalog of several dozen.
User manual article: Translating your app
Import and export
To facilitate changing many App Texts at once, you can import and export all the App Texts from one or more languages as a CSV. If you are planning to import, we recommend you first do an export to get the expected structure of the CSV file for the import.
User manual article: Translating your app
SEO / metatags
Bubble has various features to help you improve the SEO ranking of your app. Although the content of your app is probably the most important factor in SEO ranking, there are a variety of technical requirements for SEO that Bubble can help with, many of which live in this sub-tab.
Hosting files in the root directory
With this feature, you can upload a file and specify a file name, and Bubble will begin exposing that particular file at [yourappdomain].com/[filename]. This is necessary to accomplish certain things (e.g. to prove ownership of your domain for various other web services) and can also just provide convenient access to certain key files for your app or business.
No two files should have the same name. Also note that you must deploy your app for newly hosted files in your development version to also appear in your live version.
API
Bubble apps come with APIs, which allow your app to connect with other web services. This sub-tab is where you turn the app's APIs on or off, as well as control what's available through the APIs.
Generate a new API token
Once you've turned on at least one of your app's APIs, you have the option to generate a new API token. This is one of the ways a call to the API can be authenticated. See the API reference.
Caution: Using the API token feature allows for a lot of flexibility with inbound API connections, but it also opens up for potential security vulnerabilites as it gives the broadest possible access to your app's API.
If you are not entirely sure of the implications of this, we recommend reading the guide below to learn more about how the different authentication methods affect your app's security.
Article series: API authentication
API token label & private key
For each API token you choose to create, you are able to supply a custom label for it, which makes it easier for you to remember where each token is used, for example. Regardless, you will also see the private key itself.
Collaboration
On certain higher app plans, you can invite other Bubble users to collaborate with you on your app. This is where you can control who your collaborators are and what privileges they have on the app.
User manual article: Collaboration in Bubble Core reference: List of collaboration settings
Sub apps
This is an advanced feature that lets you connect one app with another in a parent-child relationship, and changes to the parent can be 'pushed' to the child.
User manual article: Sub-apps
Copy DB for creation
When you first create a sub app, you have the option of copying the parent app's database to the sub app with this checkbox.
Push to sub applications
This section lets you push changes from a parent app to its sub apps. Please refer to this article to understand what does vs does not get pushed.
Versions
Bubble generally rolls out updates to the platform many times a day and there is no need for you to do anything in order to receive those updates. However, on rare occasions, an update might introduce a "breaking change" that could alter your app's current functionality.
For these specific changes, you'll need to actively upgrade your Bubble version, which can be done within this section.
Last updated
Was this helpful?