# Complementary products

The complementary products section displays related items powered by Shopify’s Search & Discovery app. When configured, it shows products that naturally pair with the current product to encourage add-on purchases and improve conversion.

#### Header

Controls the visibility of the section header above the complementary products.

#### Direction

Defines the layout direction of complementary products on desktop. Set to “Row” to display products horizontally; mobile always uses a column layout.

#### Heading

The title shown for the section. Leave blank to use the theme default.

#### Subheading

Optional supporting text displayed below the heading. Leave blank to use the theme default.

#### Product limit

Sets the maximum number of complementary products to display. Default is 10.

#### Show divider

Toggles a visual divider to separate the section from surrounding content for improved layout clarity.

#### Vertical spacing

Controls the overall spacing around the section to adjust its visual separation from other elements.

#### Vertical spacing (desktop)

Sets the vertical spacing applied on desktop devices. Default is Large.

#### Vertical spacing (mobile)

Sets the vertical spacing applied on mobile devices for better readability on smaller screens.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://gatame.gitbook.io/highstreet/templates/product/complementary-products.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
