[[extend-theme-find]]

=== Finding Themes

[role="summary"]
How to use filters to search themes and evaluate them.

(((Theme,finding)))
(((Theme,evaluating)))
(((Contributed theme,finding)))
(((Contributed theme,evaluating)))
(((Drupal.org website,finding and evaluating themes on)))


==== Goal

Find and evaluate themes on _Drupal.org_.

==== Prerequisite knowledge

* <<understanding-drupal>>
* <<understanding-themes>>

//==== Site prerequisites

==== Steps

. Go to https://www.drupal.org, and navigate to _Download & Extend > Themes_
(https://www.drupal.org/project/project_theme).

. Filter your search using the categories on the theme search page.
For example, you might use these filters:
+
[width="100%",frame="topbot",options="header"]
|================================
|Field name |Explanation |Example value
|Maintenance status |How actively is the theme maintained? If a theme is actively
 maintained, you can expect bug fixes and improvements on a regular basis.
 |Actively maintained
|Development status |What kind of development is the theme undergoing? If you
 select _Under active development_, you can expect new features to be added, and
 some aspects may still change. If you select _Maintenance fixes only_, it means
 that the theme is considered complete. |Any
|Core compatibility |The Drupal version the theme is compatible with.|8.x
|Status |_Sandbox projects_ are experimental projects. _Full projects_ have already
 gone through an approval process, but they can still be in development.|Full projects
|Stability | Whether or not the project maintainer has created a production-ready
 version. |Has a supported stable release
|Security advisory coverage | Whether or not the project maintainer has agreed to
 follow Drupal Security Team procedures. |Has security advisory coverage
|Search themes |Search by search term in the theme's description.|-
|Sort by |Order your search results by criteria like _Most installed_ (popular themes
 that many sites use) or _Last release_ (date of latest version released). |Most installed
|================================
+
--
// Theme search box on https://www.drupal.org/project/project_theme.
image:images/extend-theme-find_theme_finder.png["Filters on the theme search page on _Drupal.org_"]
--

. Click _Search_. Search results will appear.
+
--
// Search results on https://www.drupal.org/project/project_theme.
image:images/extend-theme-find_search_results.png["The search results page on _Drupal.org_"]
--

. To further evaluate a theme, click its title in the list of search results
to visit its project page.

Some aspects to pay attention to while evaluating themes:

* Introduction: The description of the theme on its project page should be clear
and useful. A screenshot of the theme helps your evaluation as well.

* Project information: There may be warnings in this area of the page, such as
if a theme is no longer being developed, or is not covered by the security
advisory policy.

* Project information > Reported installs, downloads: You can see how many
people have downloaded and how many sites use the theme.

* Issues: See if there are any open issues, potential problems with the
theme. Check the Statistics to see how regularly issues are responded to.

* Documentation, Resources: Check if the theme has documentation or a README
file, that can help you install, configure, explore, and test it.

==== Expand your understanding

* <<extend-theme-install>>

//==== Related concepts

==== Videos

// Video from Drupalize.Me.
video::https://www.youtube-nocookie.com/embed/M8LYX6K53jg[title="Finding Themes"]

//==== Additional resources


*Attributions*

Written by https://www.drupal.org/u/dianalakatos[Diána Lakatos].
