Complete Setup Guide
Everything you need to install, configure, and use GoLocal! to make your Bubble.io app multilingual.
1 Install the Plugin
GoLocal! is available as a free plugin on the Bubble.io marketplace. You don't pay anything to install it ā the plugin itself costs $0. Billing only applies when you connect it to a GoLocal! project with an API key.
Open the Bubble editor ā Plugins tab.
Click "+ Add plugins" and search for "GoLocal" or "Auto Translator".
Find GoLocal! ā Auto Translator and click "Install". It's free.
Drag the GoLocal! element onto any page (typically a reusable header). The element is invisible.
2 Create Your Account & Project
To activate the plugin, you need an API key. API keys are generated in your GoLocal! dashboard when you create a project.
A 5-day free trial starts automatically. No credit card required. Your API key is generated immediately.
Copy the API key ā you'll need it when configuring the plugin in Bubble.
myapp.bubbleapps.io, enter exactly that.3 Configure the Plugin
Click on the GoLocal! element. At minimum, set one field:
Minimum required setup:
api_keyā paste the API key from your GoLocal! projectWith just the API key, GoLocal! auto-detects your visitors' browser language, translates all visible text, and shows a language switcher widget.
4 Plugin Fields ā Reference
api_keyRequiredYour project's API key from the GoLocal! dashboard.
Domain-bound ā safe to include in client-side code.
source_languageOptionalTwo-letter code of your app's original language. Examples: en, uk, de.
If empty, auto-detected. Setting it explicitly improves accuracy.
target_languageOptionalLanguage to translate into. Dynamic field ā bind to a Bubble state, URL parameter, or user preference.
If not set, GoLocal! auto-detects the visitor's browser language.
enabledOptionalCheckbox controlling whether translation is active. Default: checked.
show_widgetOptionalShow the built-in language switcher widget. Default: unchecked.
widget_positionOptionalWidget position: bottom-right (default), bottom-left, top-right, top-left.
dataset_1OptionalPre-translate your Bubble database for instant loading.
Structured format (recommended):
// Bubble setup:
Do a search for (Categories) :format as text
Content: {This Category's Title ; This Category's Name ; This Category's Body}
Delimiter: ,
// Append another type:
:append Do a search for (Cures) :format as text
Content: {This Cure's Title ; This Cure's Name ; This Cure's Prescription}
Delimiter: ,
Fields inside { } separated by ; ā blocks separated by ,. See Datasets for details.
do_not_translate_idsOptionalComma-separated element IDs to never translate. Specifying a group/container ID excludes all children.
Example: user-bio, code-block, brand-section
private_translate_idsOptionalElements that are translated but translations aren't cached globally. Use for per-user data (names, addresses).
Example: user-name, order-address
5 Datasets ā Translating Your Bubble Database
Most Bubble apps display data from the database. Without datasets, dynamic content is translated on first view ā causing a visible delay. Datasets pre-translate everything for instant loading.
Format 1: Structured ā for multi-field items (recommended)
Wrap each item in {}, separate fields with ; (semicolon), use , as delimiter between items.
// Bubble: Do a search for (Categories) :format as text
Content: {This Category's Title ; This Category's Name ; This Category's Body}
Delimiter: ,
// Append: Do a search for (Cures) :format as text
Content: {This Cure's Title ; This Cure's Name ; This Cure's Prescription}
Delimiter: ,
// Result: {Health;Wellness;Guide...},{Beauty;Skincare;Routines...},{Aspirin;Relief;Take 2x...}
{} split by ; ā blocks split by , ā commas in your text are safe.Format 2: Simple ā for single-value lists
For short values without commas (category names, tags):
Content: This Category's Name Delimiter: ,
// Output: Electronics,Clothing,Books,Toys
Important: If text may contain commas, always use the structured format with {field;field} wrapping.
6 How Translation Works
GoLocal! uses a multi-layer caching system:
First visitor (cold start)
All visible text is collected, translated, and cached globally on our edge network (300+ locations). Takes 1ā3 seconds.
Subsequent visitors (cached)
Instant translations from edge cache nearest the user. No server calls, no AI processing.
New or changed content
Only new/changed text goes through translation. Everything else stays cached.
Speed comparison
7 Pricing & Billing
Three plans, all with unlimited translation words.
| Feature | Starter | Pro | Business |
|---|---|---|---|
| Monthly price | $15/mo | $35/mo | $89/mo |
| Yearly price | $149/yr | $349/yr | $890/yr |
| Languages included | 5 | 10 | 20 |
| MAU limit | 30K | 150K | 1M |
| Projects | 1 | 1 | 2 |
MAU
Unique visitors who saw translations. Bots filtered out. 10% overage free, then $3/10K extra.
Extra Languages
$2/month per additional language beyond your plan's included count.
5-Day Free Trial
Every new project starts with a free trial. No credit card required.
8 Partner Program
Earn money by recommending GoLocal!
Share your referral link ā earn recurring commissions for every paying customer you bring.
Sign up as a partner
Dashboard ā Partner tab ā "Join Partner Program". Get your unique referral link.
Share your link
Blog, YouTube, Bubble forum, social media, tutorials, or directly with clients.
Earn commissions
Recurring commission for the lifetime of each referred user's subscription.
Get paid
Request payout via bank transfer or PayPal when balance reaches minimum threshold.
Ready to make your app multilingual?
Install the free plugin, create a project, paste your API key ā and your Bubble app speaks every language.