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 a- ProductGridItem.
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 MouseOriginal price:$999Price:$950.04
 - 4k Philips Monitor 27”Original price:$490Price:$420
 - Echo Dot Smart SpeakerOriginal price:$310Price:$280
 - Aedle VK-1 L HeadphoneOriginal price:$150Price:$130
 - Oculus VR HeadsetOriginal price:$344Price:$315
 - Apple AirPods ProOriginal price:$249Price:$229
 - Product Shelf- Displays a list of products to be used as a section on the store. See more