This add-on is operated by Bablic

Website Localization with no i18n requirements


Last Updated: 07 May 2015

The Bablic add-on is currently in beta.

Table of Contents

Bablic is an add-on for easy website localization.

Adding Bablic to a web application transforms it to a fully localized web application. 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 provide you with a translation management 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:create 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:create bablic --original=<ORIGINAL_LOCALE_CODE> --target=<TARGET_LOCALE_CODES>

For example:

$ heroku addons:create 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

A Rails 3 sample app can be found on GitHub at


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 Node.js

A Node.js sample app can be found on GitHub at

in your layout.ejs file

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

Using with Python/Django

A Django sample app can be found on GitHub at

Create a context processor that will add the snippet to every template context:

from django.conf import settings # import the settings file

import os
BABLIC_SNIPPET = os.environ.get('BABLIC_SNIPPET','')

def bablic(request):
        return {'BABLIC_SNIPPET': BABLIC_SNIPPET, 'locale': BABLIC_SNIPPET and request.session and request.session.get('locale')}

Add the context processor in your


Add the snippet injection in you layout html file

            {{ BABLIC_SNIPPET|safe }}

If you want to define the selected locale from the backend set the bablic.locale after the snippet

        {{ BABLIC_SNIPPET|safe }}
        {% if locale %}
                bablic.locale = "{{ locale }}";
            {% endif %}


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.

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.

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:destroy 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: