medusajs avatar

Building Admin Dashboard Customizations

If you're building custom UI for Medusa's admin dashboard, you'll need this before you touch any code. It covers the full stack of admin customizations: widgets for product and order pages, custom pages, forms, tables, and data loading patterns. The most critical part is the data loading section, which hammers home a pattern that's easy to mess up: always use separate queries for display data versus modal data, and never conditionally load display queries based on UI state. It also includes design system rules like semantic color classes and the surprisingly important detail that Medusa prices aren't stored in cents, so don't divide by 100 when displaying them. The skill explicitly tells you to load reference files before implementing, since the quick reference alone won't cut it.

skills.sh installs
4.7K
GitHub stars
236
last updated
Aug 21, 2026

Install

$ npx -y skills add medusajs/medusa-agent-skills --skill building-admin-dashboard-customizations --agent claude-code

Installs into .claude/skills of the current project.

Files

Medusa Admin Dashboard Customizations

Build custom UI extensions for the Medusa Admin dashboard using the Admin SDK and Medusa UI components.

Note: "UI Routes" are custom admin pages, different from backend API routes (which use building-with-medusa skill).

When to Apply

Load this skill for ANY admin UI development task, including:

  • Creating widgets for product/order/customer pages
  • Building custom admin pages
  • Implementing forms and modals
  • Displaying data with tables or lists
  • Adding navigation between pages

Also load these skills when:

  • building-with-medusa: Building backend API routes that the admin UI calls
  • building-storefronts: If working on storefront instead of admin dashboard

CRITICAL: Load Reference Files When Needed

The quick reference below is NOT sufficient for implementation. You MUST load relevant reference files before writing code for that component.

Load these references based on what you're implementing:

Sponsors

Details

Repository
github.com/medusajs/medusa-agent-skills
Categories
Frontend Development, AI & Agent Building, Productivity & Planning, Design & UI/UX

More from medusajs/medusa-agent-skills

All 15
1forcedotcom avatarcommerce-b2b-open-code-components-replaceforcedotcom/sf-skillsReplace OOTB (out-of-the-box) B2B Commerce components with open source equivalents in site metadata content.json files, or look up the equivalent open code `sit4.6Kskills.sh installs
2composiohq avatartheme-factorycomposiohq/awesome-claude-skillsToolkit for styling artifacts with a theme. These artifacts can be slides, docs, reportings, HTML landing pages, etc. There are 10 pre-set themes with colors/fo4.6Kskills.sh installs
3axiomhq avatarbuilding-dashboardsaxiomhq/skillsDesigns and builds Axiom dashboards via API. Covers chart types, APL and metrics/MPL query patterns, SmartFilters, layout, and configuration options. Use when c4.5Kskills.sh installs
4dpearson2699 avatarswift-testingdpearson2699/swift-ios-skillsWrites and migrates Swift Testing framework tests with @Test, @Suite, #expect, #require, confirmation, traits, withKnownIssue, Attachment.record, processExitsWi4.5Kskills.sh installs
5anthropics avatardesign-systemanthropics/knowledge-work-pluginsAudit, document, or extend your design system. Use when checking for naming inconsistencies or hardcoded values across components, writing documentation for a c4.5Kskills.sh installs
6grafana avatarfleet-managementgrafana/skillsManage a fleet of Grafana Alloy collectors with Fleet Management — author Alloy pipelines once, target them via attribute matchers (`env="production"`, regex `r4.5Kskills.sh installs