{"id":125525,"date":"2019-07-21T18:13:30","date_gmt":"2019-07-21T18:13:30","guid":{"rendered":"https:\/\/developer.wordpress.org\/rest-api\/reference\/themes\/"},"modified":"2024-01-16T20:30:15","modified_gmt":"2024-01-16T20:30:15","slug":"themes","status":"publish","type":"rest-api-handbook","link":"https:\/\/developer.wordpress.org\/rest-api\/reference\/themes\/","title":{"rendered":"Themes"},"content":{"rendered":"
\n
\n

Schema<\/h2>\n

The schema defines all the fields that exist within a theme record. Any response from these endpoints can be expected to contain the fields below unless the `_filter` query parameter is used or the schema field only appears in a specific context.<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
\n stylesheet<\/code>\n <\/td>\n\n The theme's stylesheet. This uniquely identifies the theme.<\/p>\n

\n JSON data type: string <\/p>\n

Read only<\/p>\n

Context: <\/code><\/p>\n<\/td>\n<\/tr>\n

\n template<\/code>\n <\/td>\n\n The theme's template. If this is a child theme, this refers to the parent theme, otherwise this is the same as the theme's stylesheet.<\/p>\n

\n JSON data type: string <\/p>\n

Read only<\/p>\n

Context: <\/code><\/p>\n<\/td>\n<\/tr>\n

\n author<\/code>\n <\/td>\n\n The theme author.<\/p>\n

\n JSON data type: object <\/p>\n

Read only<\/p>\n

Context: <\/code><\/p>\n<\/td>\n<\/tr>\n

\n author_uri<\/code>\n <\/td>\n\n The website of the theme author.<\/p>\n

\n JSON data type: object <\/p>\n

Read only<\/p>\n

Context: <\/code><\/p>\n<\/td>\n<\/tr>\n

\n description<\/code>\n <\/td>\n\n A description of the theme.<\/p>\n

\n JSON data type: object <\/p>\n

Read only<\/p>\n

Context: <\/code><\/p>\n<\/td>\n<\/tr>\n

\n is_block_theme<\/code>\n <\/td>\n\n Whether the theme is a block-based theme.<\/p>\n

\n JSON data type: boolean <\/p>\n

Read only<\/p>\n

Context: <\/code><\/p>\n<\/td>\n<\/tr>\n

\n name<\/code>\n <\/td>\n\n The name of the theme.<\/p>\n

\n JSON data type: object <\/p>\n

Read only<\/p>\n

Context: <\/code><\/p>\n<\/td>\n<\/tr>\n

\n requires_php<\/code>\n <\/td>\n\n The minimum PHP version required for the theme to work.<\/p>\n

\n JSON data type: string <\/p>\n

Read only<\/p>\n

Context: <\/code><\/p>\n<\/td>\n<\/tr>\n

\n requires_wp<\/code>\n <\/td>\n\n The minimum WordPress version required for the theme to work.<\/p>\n

\n JSON data type: string <\/p>\n

Read only<\/p>\n

Context: <\/code><\/p>\n<\/td>\n<\/tr>\n

\n screenshot<\/code>\n <\/td>\n\n The theme's screenshot URL.<\/p>\n

\n JSON data type: string,
\n Format: uri\n <\/p>\n

Read only<\/p>\n

Context: <\/code><\/p>\n<\/td>\n<\/tr>\n

\n tags<\/code>\n <\/td>\n\n Tags indicating styles and features of the theme.<\/p>\n

\n JSON data type: object <\/p>\n

Read only<\/p>\n

Context: <\/code><\/p>\n<\/td>\n<\/tr>\n

\n textdomain<\/code>\n <\/td>\n\n The theme's text domain.<\/p>\n

\n JSON data type: string <\/p>\n

Read only<\/p>\n

Context: <\/code><\/p>\n<\/td>\n<\/tr>\n

\n theme_supports<\/code>\n <\/td>\n\n Features supported by this theme.<\/p>\n

\n JSON data type: object <\/p>\n

Read only<\/p>\n

Context: <\/code><\/p>\n<\/td>\n<\/tr>\n

\n theme_uri<\/code>\n <\/td>\n\n The URI of the theme's webpage.<\/p>\n

\n JSON data type: object <\/p>\n

Read only<\/p>\n

Context: <\/code><\/p>\n<\/td>\n<\/tr>\n

\n version<\/code>\n <\/td>\n\n The theme's current version.<\/p>\n

\n JSON data type: string <\/p>\n

Read only<\/p>\n

Context: <\/code><\/p>\n<\/td>\n<\/tr>\n

\n status<\/code>\n <\/td>\n\n A named status for the theme.<\/p>\n

\n JSON data type: string <\/p>\n

Context: <\/code><\/p>\n

One of: inactive<\/code>, active<\/code>\n <\/td>\n<\/tr>\n<\/table><\/div>\n<\/section>\n

\n
\n
\n

Retrieve a Theme<\/h2>\n

Definition & Example Request<\/h3>\n

GET \/wp\/v2\/themes<\/code><\/p>\n

Query this endpoint to retrieve a specific theme record.<\/p>\n

$ curl https:\/\/example.com\/wp-json\/wp\/v2\/themes<\/code>\n <\/div>\n

\n

Arguments<\/h3>\n\n\n
\n status<\/code>\n <\/td>\n\n Limit result set to themes assigned one or more statuses.\n <\/td>\n<\/tr>\n<\/table><\/div>\n<\/section>\n
\n
\n

Retrieve a Theme<\/h2>\n

Definition & Example Request<\/h3>\n

GET \/wp\/v2\/themes\/<stylesheet>?)<\/code><\/p>\n

Query this endpoint to retrieve a specific theme record.<\/p>\n

$ curl https:\/\/example.com\/wp-json\/wp\/v2\/themes\/<stylesheet>?)<\/code>\n <\/div>\n

\n

Arguments<\/h3>\n\n\n
\n stylesheet<\/code>\n <\/td>\n\n The theme's stylesheet. This uniquely identifies the theme.\n <\/td>\n<\/tr>\n<\/table><\/div>\n<\/section>\n<\/div>\n","protected":false},"author":0,"featured_media":0,"parent":23078,"menu_order":0,"template":"","meta":{"footnotes":""},"class_list":["post-125525","rest-api-handbook","type-rest-api-handbook","status-publish","hentry","type-handbook"],"revision_note":"","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/developer.wordpress.org\/wp-json\/wp\/v2\/rest-api-handbook\/125525","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/developer.wordpress.org\/wp-json\/wp\/v2\/rest-api-handbook"}],"about":[{"href":"https:\/\/developer.wordpress.org\/wp-json\/wp\/v2\/types\/rest-api-handbook"}],"version-history":[{"count":6,"href":"https:\/\/developer.wordpress.org\/wp-json\/wp\/v2\/rest-api-handbook\/125525\/revisions"}],"predecessor-version":[{"id":151990,"href":"https:\/\/developer.wordpress.org\/wp-json\/wp\/v2\/rest-api-handbook\/125525\/revisions\/151990"}],"up":[{"embeddable":true,"href":"https:\/\/developer.wordpress.org\/wp-json\/wp\/v2\/rest-api-handbook\/23078"}],"wp:attachment":[{"href":"https:\/\/developer.wordpress.org\/wp-json\/wp\/v2\/media?parent=125525"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}