Blog

October 30, 2025·Product

Add Images to Categories in Medusa

Shahed Nasser

Shahed  avatar

Shahed Nasser

Learn how to associate images like thumbnails and banners with product categories in Medusa.

Image modal

Community Requested Tutorial
This tutorial was requested by our community.

Vote for the next tutorial

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

Get Started

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.

Image modal

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.

Image modal

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.

Image modal

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.

Share this post

Ready to build your custom commerce setup?