How to create a subtheme for Open Atrium

Last updated on
30 April 2025

Open Atrium is shipped with Open Atrium Radix, a sub-theme of the Radix theme for Panopoly. Check the project page of Radix for further background information on this Bootstrap based theme.

Find general information about Drupal subtheming. Read about Radix subtheming; this page also shows you how to create a sub-theme manually, in case the Drush method doesn't work for you.

Please note that creating subthemes is never going to be a completely black-box "click one button" process. It is still expected that it's done by somebody familiar with writing Drupal themes, etc. The drush command is just a starting point to save a bunch of work.

Below is a summary of steps to generate a valid sub-theme of oa_radix

  1. Run drush oa_radix mysubtheme. If you get the error: The drush command 'oa_radix mysubtheme' could not be found, don't forget to run drush dl oa_radix and drush cc drush to ensure you are subtheming from an install in /sites/all/themes/
  2. Run compass watch in site/all/themes/mysubtheme/
  3. cp profiles/openatrium/themes/oa_radix/colorizer.inc sites/all/themes/mysubtheme/ (Optional, if colorizer is needed)
  4. cp profiles/openatrium/themes/oa_radix/assets/stylesheets/colorizer.css sites/all/themes/mysubtheme/assets/stylesheets/(Optional, if colorizer is needed)
  5. cp profiles/openatrium/themes/oa_radix/templates/colorizer.htm sites/all/themes/mysubtheme/templates(Optional, if colorizer is needed)
  6. goto admin/appearance, enable mysubtheme
  7. goto admin/config/development/bootstrap_library, Themes Visibility -> Activate on specific themes -> Only the listed themes, add mysubtheme
  8. goto admin/appearance, set default mysubtheme
  9. DONE.

Please note that after these steps have done, the created subtheme only has one region (content region). If you need more regions so that you can add/arranges blocks, you have to add regions in .info file. Without adding more regions, the subtheme may look like NOT working or some errors.

Subtheme troubleshooting

I cannot edit panels content using the editor. I just see a cog that spins forever.
You have not enabled bootstrap for your sub-theme. Follow the step above to activate it on your subtheme.

Help improve this page

Page status: Not set

You can: