General Configuration

You can configure Active Admin settings in config/initializers/active_admin.rb. Here are a few common configurations:


Active Admin requires two settings to authenticate and use the current user within your application.

  • the method controllers used to force authentication
config.authentication_method = :authenticate_admin_user!
  • the method used to access the current user
config.current_user_method = :current_admin_user

Both of these settings can be set to false to turn off authentication.

config.authentication_method = false
config.current_user_method   = false

Site Title Options

Every page has what's called the site title on the left side of the menu bar. If you want, you can customize it.

config.site_title       = "My Admin Site"
config.site_title_link  = "/"
config.site_title_image = "site_image.png"
config.site_title_image = ""
config.site_title_image = ->(context) { }

Internationalization (I18n)

To translate Active Admin to a new language or customize an existing translation, you can copy config/locales/en.yml to your application's config/locales folder and update it. We welcome new/updated translations, so feel free to contribute! To translate third party gems like devise, use for example devise-i18n.

Localize Format For Dates and Times

Active Admin sets :long as default localize format for dates and times. If you want, you can customize it.

config.localize_format = :short


When registering resources in Active Admin, they are loaded into a namespace. The default namespace is "admin".

# app/admin/posts.rb
ActiveAdmin.register Post do
  # ...

The Post resource will be loaded into the "admin" namespace and will be available at /admin/posts. Each namespace holds on to its own settings that inherit from the application's configuration.

For example, if you have two namespaces (:admin and :super_admin) and want to have different site title's for each, you can use the config.namespace(name) block within the initializer file to configure them individually.

ActiveAdmin.setup do |config|
  config.site_title = "My Default Site Title"

  config.namespace :admin do |admin|
    admin.site_title = "Admin Site"

  config.namespace :super_admin do |super_admin|
    super_admin.site_title = "Super Admin Site"

Each setting available in the Active Admin setup block is configurable on a per namespace basis.

Load paths

By default Active Admin files go inside app/admin/. You can change this directory in the initializer file:

ActiveAdmin.setup do |config|
  config.load_paths = [File.join(Rails.root, "app", "ui")]


By default Active Admin includes comments on resources. Sometimes, this is undesired. To disable comments:

# For the entire application:
ActiveAdmin.setup do |config|
  config.comments = false

# For a namespace:
ActiveAdmin.setup do |config|
  config.namespace :admin do |admin|
    admin.comments = false

# For a given resource:
ActiveAdmin.register Post do
  config.comments = false

You can change the name under which comments are registered:

config.comments_registration_name = 'AdminComment'

You can change the order for the comments and you can change the column to be used for ordering:

config.comments_order = 'created_at ASC'

You can disable the menu item for the comments index page:

config.comments_menu = false

You can customize the comment menu:

config.comments_menu = { parent: 'Admin', priority: 1 }

Utility Navigation

The "utility navigation" shown at the top right normally shows the current user and a link to log out. However, the utility navigation is just like any other menu in the system; you can provide your own menu to be rendered in its place.

ActiveAdmin.setup do |config|
  config.namespace :admin do |admin|
    admin.build_menu :utility_navigation do |menu|
      menu.add label: "", url: "",
                                          html_options: { target: :blank }
      admin.add_current_user_to_menu  menu
      admin.add_logout_button_to_menu menu