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

# MainWP Dashboard Themes

> Set MainWP Dashboard to Light, Dark, or System appearance for your account, or choose a custom theme from MainWP Tools.

Choose how MainWP Dashboard looks when you sign in. The setting is saved for your user account. To change a WordPress theme on a child site, see [Manage Themes](https://docs.mainwp.com/sites/themes/managing-themes-with-mainwp.md).

## Choose Light, Dark, or System

In MainWP Dashboard 6.4.2 and later, use the **Appearance** controls in the header:

| Option | Behavior |
| - | - |
| **System** (monitor) | Follows your device's light or dark preference and updates when it changes. |
| **Light** (sun) | Keeps the Dashboard in light mode. |
| **Dark** (moon) | Keeps the Dashboard in dark mode. |

If you see a palette button, click **Select MainWP theme**. Choose an option in the **Select MainWP Theme** dialog and save. The palette appears when a legacy theme is active or custom theme files are available.

## Manage Themes from MainWP Tools

1. Open **MainWP menu (three lines, top right) > MainWP Tools** (`/wp-admin/admin.php?page=MainWPTools`).
2. Find **Select MainWP Dashboard theme** and choose a built-in or custom theme.
3. Click **Save Settings**.

MainWP also lists a legacy theme if you are currently using it.

***

## Custom Theme Files

You can create custom themes by modifying existing CSS files and uploading them to your Dashboard site.

**1. Download the MainWP Dashboard plugin**

Download the **MainWP Dashboard** plugin from the [WordPress.org repository](https://wordpress.org/plugins/mainwp/).

**2. Extract the plugin files**

Unzip the plugin files to your computer.

**3. Find the default themes**

Navigate to `/mainwp/assets/css/themes` directory to find the built-in theme CSS files.

**4. Copy and customize a theme**

Copy one of the CSS files and open it in your preferred code editor. Make your customizations.

**5. Rename your theme file**

Save the file with a new descriptive name (e.g., `my-agency-theme.css`).

**6. Upload to your Dashboard**

Upload the CSS file to `/wp-content/uploads/mainwp/themes/` on your Dashboard site using FTP or your hosting file manager.

**7. Select your custom theme**

Your custom theme appears in the theme selector in **MainWP menu (three lines, top right) > MainWP Tools** (`/wp-admin/admin.php?page=MainWPTools`) and in the theme modal path.

***

## Theme File Locations

| Location | Purpose |
| - | - |
| `/wp-content/plugins/mainwp/assets/css/themes/` | Built-in themes (do not modify) |
| `/wp-content/uploads/mainwp/themes/` | Custom themes (upload yours here) |

> [!NOTE]
>
> If an older `custom-dashboard` folder exists, MainWP migrates it to the `themes` folder path used now.
>
> Custom themes in the uploads directory persist through plugin updates. Built-in themes may be overwritten during updates.

***

## Related Resources

* [Change Sidebar Position](https://docs.mainwp.com/customization/how-to-change-the-sidebar-position.md) - Adjust sidebar location
* [Customize Dashboard Logo](https://docs.mainwp.com/customization/customize-mainwp-dashboard-logo.md) - Brand your Dashboard
* [Widget Column Layout](https://docs.mainwp.com/customization/how-can-i-change-the-number-of-widget-columns-on-the-overview-page.md) - Adjust widget arrangement
* [Manage Themes](https://docs.mainwp.com/sites/themes/managing-themes-with-mainwp.md) - Manage Child Site WordPress themes


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.