Skip to main content
RapidDev - Software Development Agency
bubble-tutorial

How to manage Bubble settings

Bubble's Settings tab controls your app's core configuration including general information, custom domains, SEO metadata, API access, collaboration, and language translations. This tutorial walks you through every section of the Settings tab so you know exactly where to find and configure each setting for your app.

What you'll learn

  • How to navigate all sections of Bubble's Settings tab
  • How to configure your custom domain and SSL
  • How to set up SEO metadata, favicon, and social sharing images
  • How to manage API access, collaboration, and language settings
Book a free consultation
4.9Clutch rating
600+Happy partners
17+Countries served
190+Team members
Beginner7 min read15-20 minAll Bubble plans (some settings require paid plans)March 2026RapidDev Engineering Team
TL;DR

Bubble's Settings tab controls your app's core configuration including general information, custom domains, SEO metadata, API access, collaboration, and language translations. This tutorial walks you through every section of the Settings tab so you know exactly where to find and configure each setting for your app.

Overview: Managing App Settings in Bubble

The Settings tab is Bubble's control center for everything that is not part of your visual design or workflows. From setting your app's name and favicon to configuring custom domains, API access, and translation files, this tab houses critical configuration. This tutorial gives you a guided tour of every section.

Prerequisites

  • A Bubble account with at least one app
  • Basic familiarity with the Bubble editor layout
  • A custom domain (optional, for domain configuration section)

Step-by-step guide

1

Review the General section

Click Settings in the left sidebar, then click the General tab. Here you will find your app's name, subdomain (yourapp.bubbleapps.io), and the option to transfer or archive the app. The Application rights section lets you choose between public and private app modes. You can also set a Google Maps API key here for map functionality across your app. Review these settings after creating a new app to ensure the basics are correct.

Expected result: You understand the General settings including app name, subdomain, and application rights.

2

Configure your custom domain

Click the Domain / email tab in Settings. To add a custom domain, enter your domain name and click Add domain. Bubble provides DNS records (CNAME or A records) that you need to add in your domain registrar's DNS settings. Point your domain's CNAME to the value Bubble provides. SSL certificates are provisioned automatically once DNS propagates (can take up to 48 hours). If using Cloudflare, set the DNS record to DNS-only mode (grey cloud) to avoid SSL conflicts.

Pro tip: Add both www and non-www versions of your domain, with one redirecting to the other, to avoid SEO duplicate content issues.

Expected result: Your custom domain is configured with DNS records and SSL certificate provisioned.

3

Set up SEO and social sharing metadata

Click the SEO / metatags tab. Set your app's default page title and meta description — these appear in Google search results when no page-level override is set. Upload a favicon (the small icon in browser tabs). Set the OG (Open Graph) image — this appears when your URL is shared on social media. You can also add custom script tags in the header section for analytics (Google Analytics, Facebook Pixel) or external libraries. Each individual page can override these defaults in its page settings.

Expected result: Default SEO metadata, favicon, and social sharing images are configured for your entire app.

4

Enable and configure API access

Click the API tab in Settings. Here you can enable the Data API (exposes your database via REST endpoints) and the Workflow API (allows external services to trigger backend workflows). Generate API tokens for authentication. Below that, select which Data Types to expose through the Data API and configure their permissions. You can also enable Swagger documentation for your API by checking the appropriate box. This is essential for any integration with external services.

Pro tip: Only expose Data Types that external services actually need. Every exposed type increases your API surface area and potential security risk.

Expected result: API access is configured with tokens generated and appropriate Data Types exposed.

5

Manage collaboration and editor access

Click the Collaboration tab. Here you can invite other people to edit your app by entering their email addresses. Set permission levels: each collaborator can be given access to specific tabs (Design, Workflow, Data, etc.) or full access. On paid plans, you can add multiple editors. The Free plan is limited to one editor. Review who has access regularly and remove collaborators who no longer need access.

Expected result: Team members are invited with appropriate permission levels for collaborative app development.

6

Configure language and translation settings

Click the Languages tab. Bubble lets you customize every default text string in your app — error messages, validation messages, and system prompts. Click any text to edit it. For multilingual apps, you can add additional languages and provide translations for each string. The App texts section shows all translatable strings. You can export and import translation files in CSV format for professional translation. These translations affect built-in Bubble elements and error messages — custom text in your own elements must be translated separately using your data model.

Pro tip: For fully multilingual apps beyond just system messages, RapidDev can help design a translation architecture using Option Sets or a dedicated Translations Data Type that handles all your custom content.

Expected result: System messages are customized and additional language translations are configured if needed.

Complete working example

Workflow summary
1BUBBLE SETTINGS SECTION REFERENCE
2=====================================
3
4GENERAL TAB:
5 - App name and subdomain
6 - Transfer / Archive app
7 - Application rights (public/private)
8 - Google Maps API key
9 - Favicon upload
10
11DOMAIN / EMAIL TAB:
12 - Custom domain configuration
13 - DNS records (CNAME / A record)
14 - SSL certificate (auto-provisioned)
15 - Email settings (SendGrid integration)
16
17SEO / METATAGS TAB:
18 - Default page title
19 - Default meta description
20 - OG image for social sharing
21 - Script/meta tags in header (analytics, libraries)
22 - Robots.txt configuration
23
24API TAB:
25 - Enable Data API (REST endpoints for database)
26 - Enable Workflow API (backend workflow triggers)
27 - API tokens (generate, revoke)
28 - Data Type exposure settings
29 - Swagger documentation toggle
30
31COLLABORATION TAB:
32 - Invite editors by email
33 - Permission levels per tab
34 - View/remove current collaborators
35
36LANGUAGES TAB:
37 - Customize default system messages
38 - Add translation languages
39 - Export/import translation CSV files
40 - App texts reference
41
42OTHER TABS:
43 - Sub-apps: Manage sub-applications
44 - Versions: Version control (paid plans)
45 - Visual settings: ID attributes on elements

Common mistakes when managing Bubble settings

Why it's a problem: Using Cloudflare proxy mode (orange cloud) with Bubble's custom domain

How to avoid: Set the DNS record to DNS-only mode (grey cloud icon) in Cloudflare when pointing to Bubble.

Why it's a problem: Not setting page-level SEO metadata and relying only on app defaults

How to avoid: Set custom page title and meta description in each page's settings for optimal search engine visibility.

Why it's a problem: Exposing all Data Types in the Data API unnecessarily

How to avoid: Only check the Data Types that external services actually need to access.

Best practices

  • Review all Settings sections when starting a new app to configure defaults early
  • Set up a custom domain as soon as you are ready for production — DNS propagation takes time
  • Add Google Analytics or your preferred analytics tool in the SEO / metatags header section
  • Generate separate API tokens for each external integration for granular access control
  • Customize error messages in the Languages tab to be user-friendly instead of technical
  • Regularly review the Collaboration tab to remove access for people who no longer need it
  • Keep your favicon and OG image professional — they appear in browser tabs and social media shares

Still stuck?

Copy one of these prompts to get a personalized, step-by-step explanation.

ChatGPT Prompt

I just created a Bubble.io app and I need to configure all the essential settings before going live. Can you give me a checklist of everything I should set up in the Settings tab including domain, SEO, API access, and collaboration?

Bubble Prompt

Help me configure my app's settings for production. I need to set up SEO metadata, enable the Data API for external access, and customize the default error messages in the Languages section.

Frequently asked questions

Can I change my app's subdomain after creating it?

No. The bubbleapps.io subdomain is set when you create the app and cannot be changed. You can use a custom domain to present any URL you want.

How long does DNS propagation take for a custom domain?

DNS changes typically propagate within 1-4 hours, but can take up to 48 hours in rare cases. SSL certificates are provisioned automatically once DNS resolves correctly.

Can I add Google Analytics to my Bubble app?

Yes. Go to Settings → SEO / metatags and paste your Google Analytics script tag in the 'Script/meta tags in header' section. It will load on every page.

How many collaborators can I add?

The Free plan allows one editor. Starter allows one, Growth allows two, and Team allows five. Enterprise plans offer unlimited editors.

Do Settings changes require redeployment?

Most Settings changes take effect immediately in the development environment. Domain and API settings affect both dev and live. Some changes require a fresh deployment to live.

Can RapidDev help configure my Bubble app for production?

Yes. RapidDev can audit your Settings configuration, set up custom domains, configure API access, and ensure your app is properly configured before launch.

RapidDev

Talk to an Expert

Our team has built 600+ apps. Get personalized help with your project.

Book a free consultation

Need help with your project?

Our experts have built 600+ apps and can accelerate your development. Book a free consultation — no strings attached.

Book a free consultation

We put the rapid in RapidDev

Need a dedicated strategic tech and growth partner? Discover what RapidDev can do for your business! Book a call with our team to schedule a free, no-obligation consultation. We'll discuss your project and provide a custom quote at no cost.