Detailed guide. An unofficial adaptation of User Guide 1.3. Source updated April 14, 2025; reviewed November 6, 2026. No running-Drupal procedure test has been performed.
Official source ↗ · Previous: 1.2 Modules · Chapter 1 overview · Next: 1.4 Distributions
Goal
Distinguish presentation from functionality. Read 1.1 and 1.2 alongside this topic.
Adapted explanation
Themes define visual presentation. The source distinguishes the content selected by core and modules from the HTML markup and CSS wrapping that content. It describes bundled themes, contributed or third-party free and paid themes, and custom themes.
The bundled-theme description is release-dependent; read the packaging qualification below.
Custom themes
The source introduces custom themes when existing options do not fit, including simple styling changes. Our qualification: this conceptual simplification is not a procedure allowing required theme definitions or files to be omitted. Consult the official theming documentation ↗ for implementation.
Our diagnostic examples
| Question | Initial area to investigate |
|---|---|
| Font size, spacing or color | Theme presentation |
| What an item list selects | Feature configuration |
| What appears in a sidebar | Regions and block placement |
| A post’s wording | Content editing |
These are starting points, not a complete responsibility map for every site. Record whether you are inspecting the public or administrative theme. See the Chapter 8 placement detail .
Update note: Olivero’s provider
Check the deprecated-theme list in 11.5.0-beta1 ↗ and the moved-extension list in 12.0.0-beta1 ↗ . We also cross-checked the explicit Olivero entry in 12 because the 11.5 beta text has a spelling variation.
Verify provider and compatible release if retaining Olivero; use the actual regions of any replacement theme. These beta notes do not recommend production beta deployment. See the existing annotation .
Sources, credits and changes
Source: Drupal User Guide 1.3 ↗ . Contributors and source links listed in its Attributions: John Grubb ↗ · Jennifer Hodgdon ↗ . Refer to the source for writing, editing and adaptation roles, and to the guide-wide credits ↗ .
Copyright remains with the individual contributors; the official copyright page ↗ states © 2015–2025. Changes include reorganized explanations and procedures, our preparation and verification examples, troubleshooting notes, source-interpretation qualifications and release references. Original screenshots and videos are not reproduced. This adapted text is shared under CC BY-SA 2.0 . It is not an official edition or endorsement. This notice does not license unrelated articles or the site design.
Chapter navigation
Previous: 1.2 Modules · Chapter 1 overview · Next: 1.4 Distributions
Preface · Chapter 2 · All chapters · Search official information