> ## Documentation Index
> Fetch the complete documentation index at: https://help.noxity.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Themes

> The top-level Themes tab in WP Toolkit. Install, update, activate, and remove themes across one or many WordPress sites.

The **Themes** tab at the top of WP Toolkit is the multi-site theme manager. Same shape as the [Plugins tab](/web-hosting/cpanel/domain-management/wordpress-management/plugins), just for themes.

Open it from cPanel home → **Domains** → **WordPress Management** → **Themes**.

<Frame caption="Themes tab listing every theme used across all sites">
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/noxity/images/cpanel/domain-management/wordpress-management/themes/listing-light.png" alt="WP Toolkit Themes tab with the multi-site theme list" className="block dark:hidden" />

  <img src="https://mintlify.s3.us-west-1.amazonaws.com/noxity/images/cpanel/domain-management/wordpress-management/themes/listing-dark.png" alt="WP Toolkit Themes tab with the multi-site theme list" className="hidden dark:block" />
</Frame>

## What's in the list

Each row is one theme, with:

* A thumbnail (from the theme's `screenshot.png`).
* The theme name and version.
* An update badge if a newer version is available.
* The count of sites using it, with the active site count separately. WordPress only runs one theme at a time per site, so the active count is at most one per site.
* An expand toggle that lists every site the theme is installed on.

Toolbar buttons match the Plugins tab: **Install**, **Upload**, **Update**, **Activate**, **Deactivate**, **Remove**.

## Install a theme on multiple sites

<Steps>
  <Step title="Click Install">
    Theme search opens against the WordPress.org repository.
  </Step>

  <Step title="Pick a theme">
    Click **Install** on the card. A preview thumbnail and the author name help you confirm the right one.
  </Step>

  <Step title="Pick target sites">
    Same multi-site checklist as plugins. Tick the sites where the theme should land.
  </Step>

  <Step title="Decide whether to activate">
    Active sets it as the running theme. Off installs the theme without switching the site over.

    <Warning>
      Activating a theme on a live site changes the appearance immediately. If you're switching themes for real, do it on a [cloned staging site](/web-hosting/cpanel/domain-management/wordpress-management/site-management) first and test before pushing back.
    </Warning>
  </Step>

  <Step title="Run">
    Per-site results at the end.
  </Step>
</Steps>

## Upload a paid or custom theme

The Upload button accepts a `.zip`. Same constraints as plugin uploads (PHP `upload_max_filesize`). Updates for paid themes usually need a license key inside WordPress admin.

## Update themes

The Update button on the toolbar applies every available theme update across every site that has it. For one theme on selected sites, expand the row and pick.

## Active vs. installed

A site can have many themes installed but only one active. Themes you've stopped using sit on disk taking space and, occasionally, attracting attention from vulnerability scanners. Clean them up with **Remove** on the rows you no longer need.

The default WordPress themes (Twenty Twenty-Four, Twenty Twenty-Three, etc.) are useful as fallbacks: if your active theme breaks, WordPress falls back to one of these. Keep at least one default installed.

## Common issues

<AccordionGroup>
  <Accordion title="Switching theme broke the site layout">
    Themes register custom widgets, sidebars, menus, and Customizer settings. Switching to a different theme drops those bindings. Switch back to the previous theme to recover, or restore from a backup taken before the switch.
  </Accordion>

  <Accordion title="A theme update breaks a child theme">
    Child themes inherit from parents. If the parent changed a function the child overrode, you'll see PHP errors. Roll back the parent (restore from backup) and reach out to the child theme's maintainer.
  </Accordion>

  <Accordion title="The Themes tab is missing themes I installed manually">
    Run **Scan** from the [Installations tab](/web-hosting/cpanel/domain-management/wordpress-management/installations). WP Toolkit re-reads each site's `wp-content/themes` and refreshes the list.
  </Accordion>
</AccordionGroup>

## Need a hand?

<CardGroup cols={2}>
  <Card title="Open a ticket" icon="life-ring" href="https://members.noxity.io/submitticket.php">
    Best for anything that needs an account check or a config change on our end.
  </Card>

  <Card title="Live chat" icon="messages" href="https://noxity.io/contact">
    Faster for quick questions during business hours.
  </Card>
</CardGroup>