> ## 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.

# Custom Dashboard

> Customize the layout, appearance, and functionality of your MainWP Dashboard with this Extension to create an interface that suits your needs.

## What You'll Learn

* Adding custom PHP, CSS, and JavaScript to your Dashboard
* Where custom code is stored and executed
* Handling PHP errors safely
* Accessing example code snippets

***

<div id="addon-data" style={{display: 'none'}} data-title="Custom Dashboard" data-purchase-url="https://mainwp.com/add-on/mainwp-custom-dashboard-extension/" data-pricing-tier="free" data-bundle="Essentials" data-addon-type="extension" data-version="5.0.1" data-developer="MainWP" data-changelog-url="https://mainwp.com/changelog/mainwp-custom-dashboard-extension/" data-owned-by="Jestart LLC" data-privacy-url="https://mainwp.com/mainwp-plugin-privacy-policy/" />

<Info>
  **Extension Add-on** - This add-on provides standalone functionality within MainWP Dashboard. No third-party plugins required.
</Info>

<iframe className="w-full aspect-video rounded-xl" src="https://www.youtube.com/embed/T6jzvD3ogfw" title="Custom Dashboard - Video Tutorial" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />

The MainWP Custom Dashboard Extension is designed to contain your custom snippets for your MainWP Dashboard.
By adding custom snippets to this plugin, you can easily extend your MainWP Dashboard functionality or change the way it looks.
After activation, open it from **Add-ons > Administrative > Custom Dashboard** in MainWP Dashboard.

<img src="https://mintcdn.com/mainwp/2l_gbp8O-WEhKcrd/images/add-ons/custom-dashboard-css-editor.png?fit=max&auto=format&n=2l_gbp8O-WEhKcrd&q=85&s=8ec9b211cba43000e51eb56757e7c02e" alt="Screenshot of Custom Dashboard extension interface showing PHP, CSS, and JS code editors" width="1903" height="947" data-path="images/add-ons/custom-dashboard-css-editor.png" />

This extension will help you to keep all your changes in one location and independent of the other components.
This enables you to safely update your MainWP Dashboard plugin on your MainWP Dashboard site without worry about losing your modifications as well as deactivating your custom code if needed for troubleshooting.
The built-in code editor allows you to add your code directly through the extension interface.
**No FTP access is required.**

Check out our Github repository where we keep example snippets that will help you get started:

* [CSS Code Snippets](https://github.com/mainwp/mainwp-custom-dashboard-extension-examples/tree/master/css)
* [PHP Code Snippets](https://github.com/mainwp/mainwp-custom-dashboard-extension-examples/tree/master/php)
* [JS Code Snippets](https://github.com/mainwp/mainwp-custom-dashboard-extension-examples/tree/master/js)

## How It Works

MainWP Custom Dashboard Extension saves your PHP, CSS, and JS snippets in WordPress options on your MainWP Dashboard site instead of requiring separate PHP, CSS, or JS files.
CSS snippets are added as inline styles on MainWP pages, and JS snippets are added as inline admin scripts on the MainWP Dashboard site.
Saved PHP Code Snippets are executed on page load by using the PHP function `eval()`.
In case the `eval()` function is disabled on your host, please contact your host support and have them enable it for you.

If a saved PHP snippet causes a parse or compile fatal error, the extension uses WordPress fatal-error handling or a shutdown handler to show an error message and a link back to the PHP editor with snippet execution disabled:

<img src="https://mintcdn.com/mainwp/2l_gbp8O-WEhKcrd/images/add-ons/custom-dashboard-php-error.png?fit=max&auto=format&n=2l_gbp8O-WEhKcrd&q=85&s=80be503659f06a69ad5c16883b5a33ca" alt="Screenshot showing PHP error message with link to fix the code" width="1903" height="355" data-path="images/add-ons/custom-dashboard-php-error.png" />

MainWP Custom Dashboard Extension is used to apply custom code snippets to the MainWP Dashboard site ONLY!
It doesn't apply code to child sites.
To apply custom code snippets to child sites, please see the [MainWP Code Snippets Extension](https://mainwp.com/extension/code-snippets/).

***

## Related Resources

* [Development Add-ons](/add-ons/development) - Browse all development tools
* [Code Snippets Extension](/add-ons/development/code-snippets-extension) - Deploy code to child sites
* [Dashboard Themes](/customization/how-to-change-the-theme-for-mainwp) - MainWP Dashboard appearance and theme behavior
