Each recommendation box has its own settings for the title, layout, which products it uses and how its product cards look. Store-wide and page-wide defaults keep every box consistent, so you only change what needs to be different.
Availability
Plan: Growth Agents plan · Platform: SHOPLINE
Open a box's settings
Click the box on the canvas. The Recommendation Box window opens.
Click the Default Box card (or a variant card). The Default Box Settings drawer opens with General expanded.
Change what you need. The canvas previews your edits as you type.
Click Save at the bottom of the drawer, then Publish in the top bar.
How defaults work
Settings pass down three levels: Global Settings (the whole store), then Page Settings (every box on one page type), then the box itself. A field you haven't set on the box shows an Inherited chip and the inherited value in grey. A field you've set shows a Reset chip. Click it to go back to the inherited value. Clearing a text field does the same.
To change the defaults, click Settings (the gear in the top bar) and open Global Settings or Page Settings. Page Settings applies to the page currently selected in the page selector.
Settings explained
General
Setting | What it does | Default |
Box Title | Heading above the box | The type's name |
Layout | Carousel, Grid, Rows or Slider. On the Product page, Related Products, Others Also Liked, Bought Together and Cross Sell also offer Bundle and Bundle Grid | Carousel (Bought Together on Product: Bundle) |
Reference Product | Which product the picks are based on: Current Product (Product page only), In-cart, Recent Purchases or Recent Views | First option in the list |
Collection | The collection a Featured Collection box shows. Required | None |
Sort Order | How a Featured Collection box sorts products: Popularity, Trending, New Arrivals, price, or Random | First option in the list |
Scope | For New Arrivals on Product and Collection pages, and Most Popular on Product pages: Entire Store, or only the product's collection (Item's Collection) or the current collection (Current Collection). On other pages, New Arrivals can be limited to a collection you pick | Entire Store |
Number of Products | Most products the box shows | 12 (5 for bundle layouts) |
Items per Page | Cards visible at once in a carousel on desktop. Phones ignore it and let shoppers swipe | 4 |
Product Title Pattern | Message for an Upsell box with the Slider layout, such as "Would you like to add {title} for {price}?". You can use {title}, {price}, {original-price} and {vendor} | — |
Extra CSS Classes | Class names your theme or developer uses to style the box | Empty |
Audience Segments | Who sees this box. Leave empty for everyone | All visitors |
Fallback (Cross Sell, Upsell and Bought Together)
Setting | What it does | Default |
Fallback Method | What to show when there are no recommendations for the reference product: hide the box, or show a collection, Most Popular, Trending or another type | Hide Box |
Fallback Collection | The collection to show when you choose Show Collection | None |
Bundle Labels (Bundle layouts): Add to Cart Button, Total Price Label and This Item Label let you rename the bundle's button and labels. The drawer also lists the bundle discount campaigns that apply to this box.
Image Settings (not for Slider or Bundle): Max Width (px) 280, Max Height (px) 350, Margin Right (px) 20, Border Radius (px) 0, and Hover Mode (Show Secondary shows the second product image on hover). In Mobile View, these settings change the phone layout only.
Navigation (not for Rows or Slider): Arrow Mode, Arrow Style, and Auto-Scroll Interval (sec) (0 turns auto-scroll off).
Quick Actions (not for Slider or Bundle): Mode (Disabled, Show on Hover or Always Visible), Action Type (Dropdown or Quick View Dialog) and Button Label.
Store-wide settings
These live in Settings and apply to every box unless a page or box overrides them: sale tag, price format, image zoom on hover, what happens after add to cart, colors, fonts, image size, arrows, quick actions and review stars. Review stars and loyalty points are set store-wide only.
Tip
Set colors and fonts once in Global Settings so new boxes match your brand automatically. Change a single box only when it needs to stand out.
Troubleshooting
You see | Why | What to do |
"Pick a collection for this box" | A Featured Collection box has no collection | Choose a Collection. Without one the box has nothing to show |
"Segment already used by another variant" | Two variants of this box target the same audience | Remove the segment from one of them |
"Collections could not be loaded. Please try again." | The collection list didn't load | Close and reopen the field |
"Failed to save changes. Please try again." | The drawer couldn't save | Click Save again |
Items per Page is missing | It only appears for Carousel in Desktop View | Switch the layout or the device view |