> For the complete documentation index, see [llms.txt](https://palo-alto.presidiocreative.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://palo-alto.presidiocreative.com/theme-settings/settings/upsells.md).

# Upsells

Use custom metafield definitions to displays upsell promotions.

The Upsells settings let you control the appearance of upsell product blocks, including layout dimensions and button design, to encourage customers to add complementary items to their cart.

[See this article to learn how](/promotions/upsell-promotions.md)

<figure><img src="https://891064830-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz8oqtXqtdhOM4CxRzekr%2Fuploads%2FgoyOvDYdysmPKRRFIwXW%2Fupsells-theme-settings.jpg?alt=media&amp;token=68dc2373-6213-4e5c-82d1-0ba190493e93" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="157.7803955078125">Settings</th><th width="90.5728759765625" align="center">Type</th><th>Description</th></tr></thead><tbody><tr><td><strong>Layout</strong></td><td align="center"></td><td></td></tr><tr><td>Height</td><td align="center"><code>range</code></td><td>Sets the height of the upsell module. Adjustable <code>from 100px to 200px</code>.</td></tr><tr><td>Image width</td><td align="center"><code>range</code></td><td>Defines the image size as a percentage of the module width.</td></tr><tr><td><strong>Button</strong></td><td align="center"></td><td></td></tr><tr><td>Color</td><td align="center"><code>select</code></td><td>Choose button color: <code>Primary</code>, <code>Secondary</code>, <code>White</code>, or <code>Black</code>.</td></tr><tr><td>Style</td><td align="center"><code>select</code></td><td>Choose button style: <code>Solid</code>, <code>Outline</code>, <code>Solid with border</code>, <code>Soft</code>, or <code>Text</code>.</td></tr><tr><td>Size</td><td align="center"><code>select</code></td><td>Set button size: <code>Small</code>, <code>Medium</code>, or <code>Large</code>.</td></tr></tbody></table>