docs: general updates and fixes (#13620)

This commit is contained in:
Shahed Nasser authored and GitHub committed 2025-09-30 08:45:30 +03:00
1 parent dda756dfaa
commit f970e1355a
47 files changed
+358 -306

No files matched your search

+18 -18
View File
@@ -6,19 +6,19 @@ export const metadata = {
# {metadata.title}
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.
Welcome to the Medusa Admin user guide. This guide is intended to help admin users and merchants learn how to use the Medusa Admin to perform commerce operations and manage their store.
![Medusa Admin Overview](https://res.cloudinary.com/dza7lstvk/image/upload/v1739530936/User%20Guide/Screenshot_2025-02-14_at_1.01.35_PM_ecyltl.png)
## 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.
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 this guide.
You can also follow these guides if you're exploring Medusa and its operational features.
You can also follow this guide if you're exploring Medusa and its operational features.
<Note>
For technical users, learn how to build and customize Medusa in [this documentation](!docs!/learn).
For technical users, learn how to build and customize Medusa in the [Get Started](!docs!/learn) section of the documentation.
</Note>
@@ -32,65 +32,65 @@ You must use your user’s email and password to log in. If you’re unsure what
<Note title="Technical Tip">
Refer to [this documentation](!resources!/medusa-cli#user) on how to create a user.
Refer to the [Medusa CLI](!resources!/medusa-cli#user) reference to learn how to create a user.
</Note>
## 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 <InlineIcon Icon={BellAlert} alt="bell" /> at the top right, and in the middle the content of the page you’re currently on.
After you log into your Medusa Admin, you'll see a navigation sidebar with a search bar at the top, a <InlineIcon Icon={BellAlert} alt="bell" /> notifications icon in the header, and the main content area in the center.
### Sidebar Menu
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.
The sidebar menu includes the main navigation of your Medusa Admin. You can use it to navigate between different domains, such as the Products or Orders pages.
![Sidebar Menu](https://res.cloudinary.com/dza7lstvk/image/upload/v1739529281/User%20Guide/Screenshot_2025-02-14_at_12.34.22_PM_oeyaol.png)
You can hide the sidebar by clicking the <InlineIcon Icon={SidebarLeft} alt="sidebar" /> icon at the top next to the sidebar. Clicking it again shows the sidebar.
You can hide the sidebar by clicking the <InlineIcon Icon={SidebarLeft} alt="sidebar" /> icon at the top next to the sidebar. Clicking it again will show the sidebar.
### Sidebar Shortcuts
Sidebar items have shortcuts. For example, the Products page has a <Kbd>G</Kbd> then <Kbd>P</Kbd> shortcut. To view the shortcut of an item, hover your mouse for a few seconds and a tooltip will appear with the shortcut.
Sidebar items have shortcuts. For example, the Products page has a <Kbd>G</Kbd> then <Kbd>P</Kbd> shortcut. To view the shortcut of an item, hover your mouse over it for a few seconds and a tooltip will appear with the shortcut.
![Sidebar Shortcuts](https://res.cloudinary.com/dza7lstvk/image/upload/v1739530172/User%20Guide/Screenshot_2025-02-14_at_12.48.19_PM_moyjtv.png)
You can also find all shortcuts by clicking on your profile item at the bottom of the sidebar and choosing "Shortcuts".
You can also find all shortcuts by clicking on your profile item at the bottom of the sidebar and selecting "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.
At the bottom of the sidebar, you'll find a Settings item, which takes you to additional settings for your store such as Region and Sales Channel management. You'll also find your avatar and name.
![Settings and profile](https://res.cloudinary.com/dza7lstvk/image/upload/v1739530277/User%20Guide/Screenshot_2025-02-14_at_12.51.06_PM_lq0ehf.png)
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.
By clicking on your avatar and name, you'll see quick actions such as accessing profile settings, viewing shortcuts, or changing the admin theme.
![Profile Quick Actions](https://res.cloudinary.com/dza7lstvk/image/upload/v1739530277/User%20Guide/Screenshot_2025-02-14_at_12.50.50_PM_qqmw54.png)
### Search Bar
At the top of the sidebar, you'll find a search item. You can also open the search window using the shortcuts:
At the top of the sidebar, you'll find a search item that opens the search window. You can also open the search window using these keyboard shortcuts:
- Windows and Linux: <Kbd>CTRL</Kbd> + <Kbd>K</Kbd>
- Mac OS: <Kbd>⌘</Kbd> + <Kbd>K</Kbd>
![Search Window](https://res.cloudinary.com/dza7lstvk/image/upload/v1739529553/User%20Guide/Screenshot_2025-02-14_at_12.36.53_PM_vps6cm.png)
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 <Kbd>Enter</Kbd> key.
You can select a result with your mouse, or use the up and down arrow keys on your keyboard to navigate between the results, then choose a result by pressing the <Kbd>Enter</Kbd> key.
### Check Notifications
At the top right you’ll find a <InlineIcon Icon={BellAlert} alt="Bell" /> 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.
At the top end of the header, you'll find a <InlineIcon Icon={BellAlert} alt="Bell" /> 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](https://res.cloudinary.com/dza7lstvk/image/upload/v1739529955/User%20Guide/Screenshot_2025-02-14_at_12.45.44_PM_ljdvof.png)
### Change Language
The Medusa Admin supports multiple-languages, with English being the default one. Check out available languages [here](./tips/languages/page.mdx).
The Medusa Admin supports multiple languages, with English being the default. Check out available languages in the [Languages](./tips/languages/page.mdx) guide.
Learn how to change the language in [this guide](./settings/profile/page.mdx#change-admin-language).
Learn how to change the language in the [Profile Settings](./settings/profile/page.mdx#change-admin-language) 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.
The Medusa Admin comes with 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, which defaults to your Operating System or Browser theme.
![Dark Theme](https://res.cloudinary.com/dza7lstvk/image/upload/v1739530936/User%20Guide/Screenshot_2025-02-14_at_1.01.56_PM_fdcgmz.png)