Skip to main content

Conditional pins

Conditional pins extend manual merchandising by allowing you to control when a pinned product should be active. Instead of pins being permanently visible, you can configure conditions that determine when each pin appears in your collection.

Condition types

Always Pinned is the default behavior where the product stays pinned at its assigned position indefinitely. Use this for evergreen products that should always appear prominently. Scheduled Pins allow you to set a specific time window during which the pin is active. Configure a start date and time, and optionally an end date and time. The pin automatically activates when the schedule begins and deactivates when it ends. This is ideal for promotional periods, seasonal campaigns, or limited-time features. Advanced Conditions give you full control using custom rules based on product attributes. The pin is only active when the conditions evaluate to true for the pinned product. For example, you can configure a pin to only be active while the product is in stock, or while a specific variant is available.

How conditional pins work

When you configure a conditional pin, the system continuously evaluates the conditions: For scheduled pins, a background process checks the current time against your configured schedule and automatically enables or disables the pin as needed. You don’t need to manually manage pins for time-based promotions. For advanced conditions, the system evaluates the rules against the current product data whenever the product is updated. If a product goes out of stock and your condition requires availability, the pin is automatically disabled until the product becomes available again.
Disabled conditional pins are visually indicated in the merchandising interface so you can see which pins are currently inactive and why.

Use cases for conditional pins

Promotional Campaigns: Schedule pins for Black Friday, holiday sales, or flash promotions without manual intervention. Inventory-Aware Merchandising: Only pin products while they’re in stock, automatically removing out-of-stock items from prominent positions. Seasonal Rotations: Set up pins for seasonal collections that automatically activate and deactivate based on dates. Attribute-Based Visibility: Pin products only when they meet specific criteria, such as having a certain tag or being from a particular vendor.

Default variant for pins

When you pin a product to a specific position, you can optionally set a default variant for that pin. This controls which variant’s data (price, image, and options) appears for the pinned product on the collection page. This is useful when a product has multiple variants and you want to showcase a specific one. For example, if you pin a jacket and set the default variant to “Color: Navy,” the collection tile will display the Navy variant’s price and image rather than the first variant. Default variant options set on a pin take priority over request-level defaultSelectedOptions but are overridden by explicit variant filters and keyword-matched variant selection. See the full variant selection priority for the complete order of precedence.
Default variant selection for pins is also available in visual ranking rules. When both a merchandising rule pin and a ranking rule pin specify default variant options for the same product, the ranking rule pin takes precedence.

See also