Last updated September 6, 2014. Created on October 4, 2011.
Edited by mak777, snufkin, Cellar Door. Log in to edit this page.

If the Omega Tools Wizard and Drush method of creating subthemes are unavailable or you are unable to successfully create a subtheme using them, the manual subtheme creation is a viable option as well (though we recommend you try the other methods prior to this).

Manual Method

Omega supplies three starterkits. Go to sites/all/themes/omega/starterkits, and choose the starterkit that best suits your needs:

  • Omega-html5: This will cover 99% of use-cases. HTML5 is a better choice in terms of long-term compatibility with the modern web’s changing browser standards.
  • Omega-xhtml: Choose this starterkit if you have any particular xhtml requirements.
    Alpha-xhtml - No need to use Alpha at this time with the above Omega versions.

How to Create and Install:

For the remainder of these documents we will refer to the subtheme you create as mysubthemename.

  1. Copy starterkit folder

    Copy the starterkit folder you choose and place it in your sites/all/themes folder, rename to your preferred subtheme name. DO NOT use spaces or dashes (-) in your subtheme name, or your subtheme will NOT be recognized.

  2. Rename your .info file:

    Open your subtheme folder and locate the file. Rename this file to the exact name that you used for your subtheme folder. It is imperative that the name of your theme folder and your .info file match, otherwise your theme will not display. See the paths below for example:
    sites/all/themes/mysubthemename and sites/all/themes/mysubthemename/

  3. Make the necessary changes to the file

    Open and locate the following lines:
    name = Replace with mysubthemename
    description = Replace with a description of your subtheme
    *** VERY IMPORTANT ***
    hidden = TRUE *** DELETE THIS LINE ***
    starterkit = TRUE *** DELETE THIS LINE ***

  4. Adapt existing CSS filenames:

    In order for your responsive CSS to load correctly you must change the names of the default CSS files. Rename all the files found at /sites/all/themes/mysubthemename/css to include your subtheme name. An example being: starterkit-alpha-default.css to mysubthemename-alpha-default.css. Make sure that if you have a module with an underscore (e.g. my_sub_theme) the underscore in placeholder will become a dash (e.g. my-sub-theme-alpha-default.css).

Go for it!

You are now ready to begin using your subtheme! Go to admin/appearance and you will find your newly created subtheme ready to be used. Enable and set default your subtheme only. REMEMBER, there is no need to enable the Alpha and Omega core themes.

Link to a Useful Video on How to Manual Install

Looking for support? Visit the forums, or join #drupal-support in IRC.