An example web application in Sinatra that uses Bablic addon from heroku
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Bablic is an add-on for easy website localization.

Adding Bablic to a web application gives you the abillity to control your site localization from the cloud. No i18n infrastructure needed! It doesn't matter in which language your site is written and you don't need to use any guidelines to start the integration. The installation takes a minute for any site. We provude you a translation memory system on our dashboard, or simply on top of your site. Bablic also offers:

  • Automatic integration to human translation services.
  • Machine translation.
  • CSS modifications support.
  • Bi-directional support.
  • Language navigation widget.
  • Image replacement.

Provisioning the add-on

Bablic can be attached to a Heroku application via the CLI:

A list of all plans available can be found [here](
$ heroku addons:add bablic
-----> Adding bablic to sharp-mountain-4005... done, v18 (free)
-----> Localization is set from "en" to "es"

You'll notice the message saying you're site localization is set from english to spanish, those are the defaults locale codes. To define your site locale codes on provision:

$ heroku addons:add bablic --original=<ORIGINAL_LOCALE_CODE> --target=<TARGET_LOCALE_CODES>

For example:

$ heroku addons:add bablic --original=fr --target="de,hi"
-----> Adding bablic to sharp-mountain-4005... done, v18 (free)
-----> Localization is set from "fr" to "de,hi"

Once Bablic has been added, a BABLIC_ID and a BABLIC_SNIPPET setting will be available in the app configuration. The BABLIC_SNIPPET is the client-side code that will be added to your HTML layout files. to integrate your web pages. This can be confirmed using the heroku config:get command.

$ heroku config:get BABLIC_ID

After installing Bablic the application should be configured to fully integrate with the add-on.

Using with Rails 3.x


in your layout.erb file ( or any other html template file you're using )

        <%= ENV('BABLIC_SNIPPET') %>


Exclude specific elements:

<div data-bablic-exclude>
    Text not for translation

Include specific elements, even if their parents are excluded:

<div data-bablic-exclude>
Text not for translation
    <span data-bablic-include>
     Text for translation

Using with NodeJS

in your layout.ejs file

        <%- process.env.BABLIC_SNIPPET || '' %>


For more information on the features available within the Bablic dashboard please see the docs at [](

The Bablic dashboard allows you to: add or remove languages, translate content, revise bad translations, change locale detection & adjust language navigiation widget.

Bablic Dashboard

The dashboard can be accessed via the CLI:

$ heroku addons:open bablic
Opening bablic for sharp-mountain-4005…

or by visiting the Heroku apps web interface and selecting the application in question. Select Bablic from the Add-ons menu.

Bablic Add-ons Dropdown

Migrating between plans

Application owners should carefully manage the migration timing to ensure proper application function during the migration process.

Use the heroku addons:upgrade command to migrate to a new plan.

$ heroku addons:upgrade bablic:newplan
-----> Upgrading bablic:newplan to sharp-mountain-4005... done, v18 ($49/mo)
       Your plan has been updated to: bablic:newplan

Removing the add-on

Bablic can be removed via the CLI.

This will destroy all associated data and cannot be undone!
$ heroku addons:remove bablic
-----> Removing bablic from sharp-mountain-4005... done, v20 (free)

Before removing Bablic a data export can be performed from Bablic Dashboard.


All Bablic support and runtime issues should be submitted via on of the Heroku Support channels. Any non-support related issues or product feedback is welcome at

Additional resources

Additional resources are available at: