App configuration

Solidus includes many preferences with default settings that are appropriate for typical stores. For a list of Solidus' preferences and their default values, see the Spree::AppConfiguration documentation . The Spree::AppConfiguration class is where all of Solidus' preferences are defined.

The built-in preferences are well-tested options that allow you to implement complex ecommerce behaviors.

A limited set of these preferences can be configured by store administrators from the solidus_backend admin area.

Since Solidus is a Rails engine , much of its behavior can be customized through initializers. You can modify or initialize preferences using initializers. Some default preferences are explicitly set in the initializer at config/initializers/spree.rb.

In this file's first Spree.config block, the currency and mails_from preferences are given default values you may want to modify:

      Spree.config do |config|
  config.currency = "USD"
  config.mails_from = "[email protected]"


This block instantiates the main configuration object for solidus_core. Here, you can start to change Solidus' behavior to accommodate many common use cases.

Once your application has been initialized, you can set any preferences using Spree::Config, which is an instance of Spree::AppConfiguration. For example, if you wanted to change your store's currency:

      Spree::Config.currency = "AUD"


Do not extend application-wide preferences

We do not support changing or extending the Spree::AppConfiguration preferences. However, you may be able to get the functionality you require by adding preferences that are specific to a model. For more information see the Add model preferences article.

If you're developing a Solidus plugin you may consider adding your configuration by inheriting from the class Spree::Preferences::Configuration just like Solidus does.

Another way to add configuration is by customizing Rails.configuration, see the Rails guides for details and examples.

Read the current preference settings

You can read all of Solidus' currently set preferences quickly from your Rails console:



Or, if you want the value of a specific preference:




Solidus is an open source platform supported by the community. We encourage everyone using Solidus to contribute back to the documentation and the code.

If you’re interested in contributing to the docs, get started with the contributing guidelines. If you see something that needs fixing and can’t do it yourself, please send us an email.