Community Documentation

Theming Guide

Last updated November 23, 2012. Created by Heine on August 2, 2012.
Edited by Manjit.Singh, drupalshrek, achton. Log in to edit this page.

This handbook is about customizing the look and feel of a Drupal site. We'll show you how you can modify the appearance of your Drupal site without requiring expert knowledge of programming. And if you wish to go further, we cover that too.

This guide assumes some knowledge of HTML and CSS but no PHP programming knowledge is necessary. It also assumes you have administrator's privileges to a Drupal site. You might also want to familiarize yourself with some of the terminology used in Drupal. We concentrate on Drupal 7 with notes for Drupal 6 where applicable.

Other Places to Explore

Overview

We start with customizing the appearance using an existing theme. You may be surprised how customizable an existing theme can be simply by changing a few settings. From there we discuss ways to make your own theme based on an existing theme, and then show you how to tweak it through the use of CSS stylesheets.

Next we'll explore how to override various theme's parts; regions and node types. We then move onto creating your own theme from scratch; which isn't all that difficult. Finally we'll cover more advanced topics employing PHP coding.

Our concentration throughout this document will be on using preferred techniques. We touch briefly on what's possible but our discussion will center on Drupal's preferred theming engine and best practices. This involves, among other things, copying files and modifying the copies, overriding files with your own versions rather than modifying the originals and housing all your modified theme's files under the sites/all/themes directory. This is a step towards upgrade-proofing your site and facilitates future maintenance.

Please help improve these pages if you can, including joining in on the working group's project page.

Page status

No known problems

Log in to edit this page

About this page

Level
Beginner
Audience
Designers/themers, Site administrators
Keywords
appearance, themes, theming
Drupal’s online documentation is © 2000-2013 by the individual contributors and can be used in accordance with the Creative Commons License, Attribution-ShareAlike 2.0. PHP code is distributed under the GNU General Public License. Comments on documentation pages are used to improve content and then deleted.