# Promo Promo blocks allow you to inject styled content between products in the grid. Useful for sales banners, category callouts, or custom messages.

{% hint style="info" %} Note: You can choose a collection here, but this will only show the promo block for that one collection.\ \ Leave the setting empty if you want the promo block to be shown on all collection pages. {% endhint %}

Settings	Type	Description
Collection	`collection`	Show promo only on selected collection.
Image	`image_picker`	Promo background image.
Layout
Show in position	`range`	Determines product position to insert promo.
Width	`select`	Choose how wide the promo should be: `Grid item`, `2 grid items`, or `Full width`.
Text
Heading	`richtext`	Promo headline text (HTML supported).
Heading size	`range`	Size of heading text.
Highlight
Type	`select`	Visual treatment for emphasized words: `Underline`, `Squiggle`, `Circle`, `Alternate font`, etc.
Highlight color	`color`	Color used for text highlights.
Text color	`color`	Text color used when highlighting.
Text	`textarea`	Description or message text.
Text size	`range`	Adjusts the body text size.
Content position	`select`	Placement of text over the image:`Center`, `Top left`, `Bottom right`, etc.
Content layout	`select`	Layout of text and button: `Inline` or `Stacked`. Inline applies only on full width for desktop.
Colors
Overlay type	`select`	Adds an overlay: `Disabled`, `Opacity overlay`, and `Text underlay`.
Background color	`color`	Applies when no image is chosen.
Show text background	`checkbox`	Adds a colored background behind text.
Background	`color`	Background color override.
Text	`color`	Text color override.
Button
Button text	`text`	Button label. Leave blank to link the full promo image.
Button URL	`url`	Destination URL for the button.
Button color	`select`	Style color of the button: `Primary`, `Secondary`, `White`, or `Black`.
Button style	`select`	Visual button type: `Solid`, `Outline`, `Solid with border`, `Soft`, or `Text`.
Size	`select`	Button size option: `Small`, `Medium`, or `Large`.

### Adding a new banner To add a new banner, you need to add a new block to the collection pages section. #### Show a percentage discount With Palo Alto, you have the option to show a percentage discount in the collection promo blocks:

To change the position of each block, you have to set it from the block settings (you can **not** drag and drop them like most blocks). {% hint style="info" %} Please note that if the position set is unavailable (i.e., there are not enough products in the collection), the promo banner will not be shown. {% endhint %} --- # 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://palo-alto.presidiocreative.com/collections/collection-pages/promo.md?ask= ``` 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.