4.1. Admin Development

In this chapter, you'll learn about the Medusa Admin dashboard and the possible ways to customize it.

What is the Medusa Admin?#

The Medusa Admin is an intuitive dashboard that allows merchants to manage their ecommerce store. It provides management featuers related to products, orders, customers, and more.

Tip: To explore more what you can do with the Medusa Admin, check out the User Guide. These user guides are designed for merchants and provide the steps to perform any task within the Medusa Admin.

The Medusa Admin is built with Vite. When you install the Medusa application, you also install the Medusa Admin. Then, when you start the Medusa application, you can access the Medusa Admin at http://localhost:9000/app.

Tip: If you don't have an admin user, use the Medusa CLI to create one.

How to Customize the Medusa Admin?#

You can customize the Medusa Admin dashboard by:

Adding new sections to existing pages using Widgets.
Adding new pages using UI Routes.

The next chapters will cover these two topics in detail.

What You Can't Customize in the Medusa Admin#

You can't customize the admin dashboard's layout, design, or the content of the existing pages (aside from injecting widgets).

If your use case requires heavy customization of the admin dashboard, you can build a custom admin dashboard using Medusa's Admin API routes.

Medusa UI Package#

Medusa provides a Medusa UI package to facilitate your admin development through ready-made components and ensure a consistent design between your customizations and the dashboard’s design.

Refer to the Medusa UI documentation to learn how to install it and use its components.

Admin Components List#

To build admin customizations that match the Medusa Admin's designs and layouts, refer to this guide to find common components.

Was this chapter helpful?