Product Grid
It's a section generally used on PLP pages to list the products available in the store.
The ProductGrid is a compound of the following:
ProductGrid: wraps the product grid items.ProductGridItem: wraps the product inside a list item.ProductCard: the proposed child of aProductGridItem.
Import
Import the component from @faststore/ui
import { ProductGrid, ProductGridItem } from '@faststore/ui'We highly recommend using the ProductCard as the direct child of the ProductGridItem.
import {
ProductCard,
ProductCardContent,
ProductCardImage,
} from '@faststore/ui'Import Styles into your FastStore project
To apply the styles of this component in your FastStore project, import the following into your stylesheet:
@import '@faststore/ui/src/components/organisms/ProductGrid/styles.scss';Follow the instructions in the Importing FastStore UI component styles tutorial.
Usage
Props
Product Grid
| Name | Type | Description | Default |
|---|---|---|---|
| testId | string | ID to find this component in testing tools (e.g.: Cypress, Testing Library, and Jest). | fs-product-grid |
Product Grid Item
| Name | Type | Description | Default |
|---|---|---|---|
| testId | string | ID to find this component in testing tools (e.g.: Cypress, Testing Library, and Jest). | fs-product-grid-item |
Design Tokens
| Local token | Default value/Global token linked |
|---|---|
--fs-product-grid-gap-mobile | var(--fs-grid-gap-0) |
--fs-product-grid-gap-tablet | var(--fs-product-grid-gap-mobile) |
--fs-product-grid-gap-desktop | var(--fs-grid-gap-2) |
--fs-product-grid-columns-mobile | 2 |
--fs-product-grid-columns-tablet | 4 |
--fs-product-grid-columns-desktop | var(--fs-product-grid-columns-tablet) |
Customization
data-fs-product-grid
data-fs-product-grid-item
Best Practices
✅ Do's
- Respect
ProductGridItemcontent's width considering the space available on the page.
❌ Don'ts
- Avoid using a lot of
ProductGridItemon the same row, this could lead to unwanted horizontal scroll.
Related components

Apple Magic Mouse
Original price:$999Price:$950.04
4k Philips Monitor 27”
Original price:$490Price:$420
Echo Dot Smart Speaker
Original price:$310Price:$280
Aedle VK-1 L Headphone
Original price:$150Price:$130
Oculus VR Headset
Original price:$344Price:$315
Apple AirPods Pro
Original price:$249Price:$229
Product Shelf
Displays a list of products to be used as a section on the store.
See more