Skip to content
Go to file


Failed to load latest commit information.
Latest commit message
Commit time

Spree Internationalization

Build Status Code Climate

This is the Internationalization project for Spree Commerce

See the official Internationalization documentation for more details.

Happy translating!

  1. Add this extension to your Gemfile with this line:

Spree >= 3.1

gem 'spree_i18n', github: 'spree-contrib/spree_i18n'

Spree 3.0 and Spree 2.x

gem 'spree_i18n', github: 'spree-contrib/spree_i18n', branch: 'X-X-stable'

The branch option is important: it must match the version of Spree you're using. For example, use 3-0-stable if you're using Spree 3-0-stable or any 3.0.x version.

  1. Install the gem using Bundler:
bundle install
  1. Copy & run migrations
bundle exec rails g spree_i18n:install
  1. Restart your server

If your server was running, restart it so that it can find the assets properly.

Model Translations

We removed support for translating models into a separate Gem.

Please update your Gemfile if you still need the model translations.

# Gemfile
gem 'spree_globalize', github: 'spree-contrib/spree_globalize', branch: 'master'


WARNING: If you want to keep your model translations, be sure to add the spree_globalize gem to your Gemfile before migrating the database. Otherwise you will loose your translations!

1. Migrate your database

bin/rake spree_i18n:upgrade
bin/rake db:migrate

Note: The migration automatically skips the removal of the translations tables. So it's safe to run the migration without data loss. But be sure to have the spree_globalize gem in your Gemfile, if you want to keep them.

2. Remove Assets

From vendor/assets/javascripts/spree/backend/all.js

//= require spree/backend/spree_i18n

and from vendor/assets/stylesheets/spree/backend/all.css

*= require spree/backend/spree_i18n

3. Remove Configuration

Remove all occurrences of SpreeI18n::Config.supported_locales from your code.


See corresponding guidelines

Copyright (c) 2010-2015 Spree Commerce Inc. and other contributors. released under the New BSD License

You can’t perform that action at this time.