Skip to main content
Your catalog lives in two places in Vulpy Commerce. Medusa owns the commerce data (products, variants, inventory, pricing), and Payload owns the editorial content that dresses those products and categories on the storefront. This page shows where each surface lives and how to work in them.
The fastest way is to ask Fox. Fox works in the same admins and can do the operational catalog work for you.
  • Create a new product called “Padel Racket X” in the Rackets category.
  • Add editorial hero blocks to the Summer category.
  • Seed the demo catalog.

​
Where each surface lives

Medusa is the source of truth for product identity. Payload productContent and categoryContent are synced from Medusa; title, handle, and medusaCategoryId are read-only in Payload. Editorial fields (blocks, h1, seo) are writable.

​
Create a product

1

Sign in to the Medusa admin

Open http://localhost:9000/app and sign in with the shared admin credentials set at install (or reset them with pnpm vulpy user reset). Or just ask Fox to create the product for you.
2

Create the product

Go to Products and click New product. Set title, handle, description, and variants (size, color, price).
3

Assign categories

Attach the product to one or more categories. Categories flow to Payload as categoryContent for editorial dressing.
4

Publish and verify

Publish the product, then open the storefront at http://localhost:3000 to confirm it appears on the category and PDP.
Medusa product and category admin widgets crosslink into Payload admin and the storefront, so you can jump straight from a Medusa product to its editorial page.

​
Add editorial content on Pro

Pro adds Payload editorial for products and categories on top of Medusa. Use Payload to layer marketing blocks, SEO metadata, and hero content without touching commerce data.
In Payload admin, open Product Content, find the synced record for your Medusa product, and add blocks (hero, rich text, media, callouts). The storefront PDP renders these blocks alongside the Medusa variant and price data.

​
Seed a demo catalog

For a quick end-to-end demo, seed the padel-shop demo fixtures. Every seeded record is stamped metadata.demo_catalog = true so it never mixes with real data and is safe to re-run.

​
Next steps

Manage orders

Fulfill orders and manage customers in the Medusa admin.

Storefront content

Publish landing pages and blocks with Payload.