🛒 Medusa Admin Panel Guide
The Medusa admin panel is the central core of your store for managing products, orders, discount codes, customers, and shipping rules.
1. Login to Admin Panel
To log into the store admin panel, you can use the following access details:
- Development Address (Local):
http://localhost:7001 - Default Username:
admin@medusa-test.com(or the email set in your server's .env file) - Default Password:
supersecret
2. Managing Products, Categories, and Collections
🛍️ Creating a New Product and Variants
- Click on Products from the left menu.
- Click the Create Product button in the top right.
- Enter the main info including Title, Description, Handle (product URL), and main images.
- Define Options and Variants: In the Options section, you can define attributes like
SizeorColorand set a separate price and inventory for each combination.🎨 How color circles are displayed in the frontend:• Normal mode (English name): If the color name is in English (likeRed,Blue,Black), the frontend directly uses the color name to display the color circle.• Exact mode (Hex code / Native and non-English titles): For higher accuracy or when using non-English and localized titles in any language (like Persian, Arabic, French, etc.), you must set thecolor_codekey with a hex code (e.g.#FF5733) in the Metadata section.
Tip about displaying Color Swatches
- If the color name is entered in standard English (like
RedorGreen), the frontend automatically uses the same name to display the color. - To display more accurate color codes (hex codes like
#2A9D8F) or when you use localized titles for other languages (like Persian, Arabic, etc.), it is recommended to enter the Metadata section and fill thecolor_codefield with the hex color code.
📁 Assigning Categories
Categories determine how products are grouped in the site's main menu and store pages.
- Go to Categories from the left menu and create tree categories (e.g.
Men -> Clothing -> T-shirt). - To add a product to a category, go to the product edit page and select the corresponding categories from the Organize section.
🏷️ Collections and Sales Campaigns
Collections are used to group products outside the main category structure (like Autumn Sale or Special Spring Collection).
- Click on Collections from the left menu and hit the New Collection button.
- Enter the campaign title and add desired products to it.
- You can use this collection in dynamic Strapi sections (like Section Showcase).
3. Order and Shipment Management
📦 Reviewing and Changing Order Status
When a customer makes a purchase, the new order appears in the Orders section.
- Pending: The order has been placed and payment confirmed.
- Processing: The order is being packed by the warehouse.
- Fulfilled: The shipment has been handed to the post or courier.
- Completed: The shipment has reached the customer.
🚚 Registering Tracking Number
- Enter the desired order and click the Create Fulfillment button.
- Check the products that have been packed.
- Enter the tracking code in the Tracking Number field.
- By clicking save, the system automatically sends an email/SMS containing the tracking code to the customer.
📄 Issuing Order Invoice and Receipt
In the details of each order, you can click on the Print Invoice option to print an official purchase invoice tailored to tax rules, including the shipping address, invoice items, and total amount paid.
4. Regions and Shipping Methods
🌐 Configuring Region
The Medusa system works based on Regions. The region is configured for currency and tax rules of the country.
- Go to Settings > Regions.
- Select your Region.
- Set the main currency.
📮 Defining Shipping Methods
You can add different post methods with fixed or variable prices:
- Express Post: Fast national delivery with fixed or weight-based cost.
- Registered Post: Economical delivery for regular purchases.
- City Courier: Specifically for intra-city delivery.
5. Discount Codes and Promotions
🎟️ Creating Percentage and Fixed Amount Discount Codes
- Go to the Discounts section from the left menu and click on Add Discount.
- Specify the discount code title (e.g.
OFF20orSPRING). - Select the discount type:
- Percentage: Percentage discount (e.g. 20%).
- Fixed Amount: Fixed amount discount (e.g. 100,000 Tomans).
- You can set an expiration date and the maximum number of times the code can be used.
🎁 Creating Free Shipping Promotion
By selecting the Free Shipping type when creating a promotion, the shipping cost is automatically zeroed for orders that meet the conditions.
Conditions you can define:
- Region: Free shipping active only for a specific region or country.
- Customer Group: Free shipping only for specific groups like VIP or wholesalers.
- Sales Channel: Free shipping applied only through a specific sales channel.
6. Customer Management and Grouping
👥 Customer Management and Group Creation (Customer Groups)
In the Customers section, you can view the list of all registered users and their purchase history.
- Click on Customer Groups and create a new group (e.g.
Wholesale BuyersorVIP). - Add specific users to this group.
- Now you can set lower prices or special discounts for this group of users when pricing products.
7. Official and Supplementary Medusa Documentation
For more advanced tutorials, you can benefit from the official text and video documentation of MedusaJS: