> 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/collections/collection-pages/promo.md). # 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 %}