> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.ecomx.co/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Shine Related Products

**Theme:** Shine · **Section type:** Product page section

The Related products section shows products similar to the one a customer is viewing. Shopify picks the products automatically, so customers can keep browsing and find alternatives without going back to a collection.

> **Note:** Related products is part of the product template. You can hide it, but you can't add it from **Add section**. Shopify needs some store data before it can recommend products, so a new store may show few or no products at first.
![Related products section under the product details](https://storage.crisp.chat/users/helpdesk/website/-/f/8/b/b/f8bb8da391016800/related-products-1_eqwsqq.jpg)

**What you can do**
- Set up the section
- Let customers add products from the cards
- Choose the layout on large screens and phones
- See what customers see
- Look up every setting in "Settings reference"
- Fix common problems

---

## Set up the section
1. In the theme editor, open a product template, for example **Default product**.
2. In the left sidebar, click **Related products**.
3. Under **General**, enter a **Heading** and set **Maximum items to show**.
4. Click **Save**.

> **Tip:** To control which products appear, use the Shopify **Search & Discovery** app. There you can add related products manually for each product.

## Let customers add products from the cards
1. Click **Related products**.
2. Under **Product card**, choose a **Quick shop action**: Quick add, Quick view, Both, or Not use.
3. If you chose Quick add or Both, choose a **Quick buy mode**:
   - **Standard (variant picker)** opens a small window where customers pick a variant and add it to the cart.
   - **Bulk order (all variants)** opens a table where customers enter a quantity for each variant at once.
4. Click **Save**.

> **Note:** You change how the quick shop window looks in **Theme settings** > **Quick shop**, and how the quick buy button shows on cards in **Theme settings** > **Product card** > **Quick buy display**.

## Choose the layout on large screens and phones
1. Click **Related products**.
2. Under **Large screen**, choose a **Section heading position**, a **List style** (Grid or Carousel), and the **Columns per row**.
3. Under **Mobile screen**, choose the same settings for phones.
4. Click **Save**.

> **Tip:** With the Grid style, set **Maximum items to show** to a multiple of **Columns per row** so the last row is full.

## What customers see
- **Loading:** the products load when customers scroll down to the section.
- **Product cards:** each card shows the product image, title, and price, plus the vendor and variant swatches if you turned them on. The card style follows **Theme settings** > **Product card**.
- **Carousel:** customers swipe or use the arrows to see more products.
- **Quick add:** customers click the add button on a card to pick a variant and add the product to the cart without leaving the page. **Quick view** opens the product details in a window.
![Quick add window opened from a related product card](https://storage.crisp.chat/users/helpdesk/website/-/f/8/b/b/f8bb8da391016800/related-products-2_1q4vu4o.jpg)

## Settings reference

### General
| Setting | What it does |
| ---- | ---- |
| Color scheme | Sets the colors of the section. You edit color schemes in Theme settings > Colors. |
| Heading | The section heading. Put words between [ and ] to highlight them. You choose the highlight style in Theme settings > Typography. |
| Heading size | Sets the heading size: H2, H3, H4, or H5. |
| Maximum items to show | Sets how many products to show, from 1 to 10. |

### Product card
| Setting | What it does |
| ---- | ---- |
| Show vendor | Shows the vendor on each card. |
| Show variant swatches | Shows variant swatches on each card. You set up swatches in Theme settings > Product information. |
| Quick shop action | Adds a Quick add button, a Quick view button, Both, or none (Not use) to each card. |
| Quick buy mode | Opens a variant picker (Standard) or a table with every variant (Bulk order) when customers use quick add. Appears with Quick add or Both. See "Let customers add products from the cards" above. |

### Large screen
| Setting | What it does |
| ---- | ---- |
| Section heading position | Places the heading at the Top left or Top center above the products, or Inline beside them. |
| List style | Shows the products in a Grid or a Carousel. |
| Columns per row | Shows 3, 4, 5, or 6 products per row. |

### Mobile screen
| Setting | What it does |
| ---- | ---- |
| Section heading position | Places the heading at the Top left or Top center. |
| List style | Shows the products in a Grid or a Carousel. |
| Columns per row | Shows 1 or 2 products per row. |

## Troubleshooting
**The section shows only the heading, with no products.**
Shopify has no recommendations for this product yet. Add related products for it in the Search & Discovery app, or wait until your store has more sales data.

**The Quick buy mode setting is missing.**
**Quick buy mode** appears only when **Quick shop action** is Quick add or Both.

**The last row of the grid isn't full.**
Set **Maximum items to show** to a multiple of **Columns per row**, or switch **List style** to Carousel.

**I want to choose exactly which products to show.**
Related products always uses Shopify's recommendations. To show products you pick, add a section such as Featured collection to the product template.

## Related articles
- [Shine Product Details](https://doc.ecomx.co/en/article/shine-product-details-10bsi6u/)
- [Shine Quick Shop](https://doc.ecomx.co/en/article/shine-quick-shop-18cw684/)
- [Shine Tabbed Collections](https://doc.ecomx.co/en/article/shine-multiple-product-tabs-yujkhj/)
- [Shine Featured Collection](https://doc.ecomx.co/en/article/shine-featured-collection-kqvywq/)
- [Shine Featured product](https://doc.ecomx.co/en/article/shine-featured-product-x3ilzf/)