Medusa Admin User Guide

Welcome to the Medusa Admin user guide. This user guide is intended to help admin users learn how they can use the Medusa Admin to perform commerce operations and manage their store.

Medusa Admin Overview

Who is this guide for?#

This guide is for Medusa Admin users looking to master the Medusa Admin and manage their store effectively. You don't need any technical knowledge to follow these guides.

You can also follow these guides if you're exploring Medusa and its operational features.

NoteFor technical users, learn how to build and customize Medusa in this documentation.

Access the Medusa Admin#

To access the Medusa Admin dashboard of your ecommerce store, open the URL of your local (localhost:9000/app) or deployed website. You’ll be asked to log in.

Log In Page

You must use your user’s email and password to log in. If you’re unsure what your email and password are, please contact the technical team that deployed your Medusa application.

Technical TipRefer to this documentation on how to create a user.

Tour of Medusa Admin#

After you log into your Medusa Admin, you see a sidebar menu to the left with a search bar at its top, a at the top right, and in the middle the content of the page you’re currently on.

The sidebar menu includes the main navigation of your Medusa Admin. You can use it to navigate between different pages, such as Products or Orders pages.

Sidebar Menu

You can hide the sidebar by clicking the icon at the top next to the sidebar. Clicking it again shows the sidebar.

Sidebar items have shortcuts. For example, the Products page has a G then P shortcut. To view the shortcut of an item, hover your mouse for a few seconds and a tooltip will appear with the shortcut.

Sidebar Shortcuts

You can also find all shortcuts by clicking on your profile item at the bottom of the sidebar and choosing "Shortcuts".

Settings and Quick Actions#

At the bottom of the sidebar you'll find a Settings item, which takes you to further settings of your store such as Region and Sales Channel management. You'll also find your avatar and name.

Settings and profile

By clicking on your avatar and name, you'll view quick actions such as going to profile settings, view shortcuts, or changing the admin theme.

Profile Quick Actions

At the top of the sidebar, you'll find a search item. You can also open the search window using the shortcuts:

  • Windows and Linux: CTRL + K
  • Mac OS: + K

Search Window

You can select a result with your mouse, or use the up and down arrows on your keyboard to navigate between the results, then choose a result by hitting the Enter key.

Check Notifications#

At the top right you’ll find a icon. Clicking this icon opens a side window to view any notifications you might have. Use this to view notifications such as completed product exports.

Notifications Window

Change Language#

The Medusa Admin supports multiple-languages, with English being the default one. Check out available languages here.

Learn how to change the language in this guide.

Change Admin Theme#

The Medusa Admin comes in light and dark themes. You can change the theme by clicking the profile item at the bottom of the sidebar -> Theme -> Light, Dark, or System, defaulting to your Operating System or Browser theme.

Dark Theme

Was this guide helpful?
Ask Anything
FAQ
What is Medusa?
How can I create a module?
How can I create a data model?
How do I create a workflow?
How can I extend a data model in the Product Module?
Recipes
How do I build a marketplace with Medusa?
How do I build digital products with Medusa?
How do I build subscription-based purchases with Medusa?
What other recipes are available in the Medusa documentation?
Chat is cleared on refresh
Line break