October 30, 2025·Product
Add Images to Categories in Medusa
Shahed Nasser
Shahed Nasser
Learn how to associate images like thumbnails and banners with product categories in Medusa.

Community Requested Tutorial
This tutorial was requested by our community.
Businesses often need to associate images with product categories, such as thumbnails and banners. These images are especially useful when creating stylish megamenus or category pages on the storefront.
Medusa’s customizable Framework makes it easy to store custom data and manage them in relation to existing data models. You can also use File Modules to upload these images to services such as S3.
Add Images to Product Categories
Follow this step-by-step guide
How it Works
You can build custom modules in Medusa that define data models and include the logic to manage them. For example, you can create a Product Media Module that holds a data model for category images and link those images to Medusa’s Copy to clipboardProductCategory data model.

Then, you can customize the Medusa Admin to support uploading and deleting category images, as well as setting them as thumbnails. You can insert a widget into the existing category details page to display category images along with management functionalities.

On the storefront, you can customize it to create stylish experiences with those images. For instance, you can build a megamenu displaying categories with their thumbnails or show a banner image on a category page.

Tutorial: Add Images to Product Category
This tutorial in our documentation guides you through the process of adding images to product categories. You’ll learn how to:
- Create a Product Media Module that defines custom data models for images.
- Customize the Medusa Admin to support managing product category images.
- Customize the Next.js Starter Storefront to add a megamenu and display a banner on the product category page.



