Skip to content

adminAppearanceThemes

Every theme the installation knows about, active ones first. Returns a plain list — the gallery is small and not paginated.

Arguments

None.

Fields

FieldTypeDescription
codeStringTheme code, used by every other Appearance operation.
nameStringDisplay name.
authorStringTheme author.
versionStringTheme version.
urlStringTheme homepage.
demoUrlStringLive demo.
screenshotStringPreview image URL.
ratingStringCatalog rating.
tagsIterableCatalog tags.
descriptionStringCatalog description.
isInstalledBooleanWhether the theme's files are on the server.
statusStringactive, installed or available.
activeOnIterableChannels running the theme, each { id, name }.

Use cases

  • Build a theme picker — group by status: active is in use, installed can be activated now, available needs installing on the server first.

Best practices

  • Query activeOn bare. It is a JSON value, not a typed object, so it takes no sub-selection.
  • Do not select id — the gallery is keyed by code, which is what every other operation takes.
  • Only an installed theme can be activated. Gate the activate control on isInstalled.

Permissions

Requires appearance.themes.

Released under the MIT License.