Persistent Cart — Block Settings Overview

This article covers every setting available in the R+ Persistent Cart app embed block. The block is configured directly from your Shopify theme editor under App Embeds. All changes take effect immediately after saving — no code editing required.

Cart Behavior

These settings define how the cart responds when a customer logs in or out of your store.

Reload page on cart update

Controls whether the page refreshes automatically after the cart is updated during a session change. Set it to "Reload" if you want the storefront UI to always reflect the latest cart state — this is the safest option for most themes. Set it to "Don't reload" if your theme uses AJAX cart updates and you want a smoother, flicker-free experience.

Default: Don't reload.

Merge guest cart on login

Determines what happens to the items that the customer added before logging in. Set to "Merge" to combine their guest cart with their saved account cart. Set to "Don't merge" to apply one of the more specific login behaviors described below.

Default: Don't merge.

Login behavior (visible only when Merge is disabled)

Controls what happens to the current cart when a customer logs in and their saved account cart is empty. "Replace" means the empty account cart takes over — the guest cart is cleared, though it may be restored on logout. "Don't replace" means the guest cart overrides the empty account cart — the customer effectively picks up where they left off as a guest.

Default: Don't replace.

Logout behavior

Defines what the customer sees in their cart after signing out. Three options are available: "Clear cart" empties the cart entirely on logout. "Restore guest cart" reverts the cart to whatever the customer had before they logged in. "Continue with synced cart" leaves the cart exactly as it was during the logged-in session.

Default: Clear cart.

Toast Notification

A toast is a small pop-up message shown to customers when their cart is restored or updated. This section controls whether it appears and how it looks.

Show toast notification on cart update

Toggles the toast on or off. When hidden, none of the toast styling or animation settings have any effect.

Preview toast in theme editor

Shows or hides toast notification from theme editor. Toggle it on when you need to style the toast.

Close toast notification

Controls how the toast can be dismissed. "Manually" shows a close button that the customer must click. "Auto" dismisses the toast after a set duration. "Both" allows either method. Default: Both.

Toast Text

The message displayed inside the toast. Supports rich text formatting. Default: "Your cart has been restored."

Toast Appearance

Background color — The fill color of the toast card. Default: white (#fff).

Text color — The color of the message text. Default: black (#000).

Close button color — The color of the × icon used to dismiss the toast. Default: black (#000).

Border radius — Rounds the corners of the toast card, from 0 px (sharp corners) to 30 px (pill shape). Default: 4 px.

Text Font Size — Separate controls for desktop (6–36 px) and mobile (6–36 px). Default: 16 px on both.

Text Font Weight — Separate controls for desktop and mobile, ranging from 100 (thin) to 700 (bold) in steps of 100. Default: 400 (regular).

Text Alignment — Separate controls for desktop and mobile. Options: Start, Center, End. Default: Center on both.

Toast Animation

Toast Effect The direction from which the toast slides into view. Separate settings for desktop and mobile. Options: Show from start (left), Show from end (right), Show from top, Show from bottom. Default: Show from top.

Toast Duration How long the toast stays visible before auto-closing, when auto-dismiss is enabled. Range: 1–15 seconds. Default: 3 seconds.

Toast Position

The toast can be placed anywhere on screen using a combination of vertical and horizontal position settings, each configurable separately for desktop and mobile.

Vertical position — Top, Center, or Bottom. Default: Top.

Horizontal position — Start, Center, or End. Default: Center.

Spacing

These settings control the space around and inside the toast card.

Outer Space (margins)

The gap between the toast and the edges of the screen. Configured separately for desktop and mobile, with independent controls for top/bottom and start/end margins. Range: 0–100 px in steps of 2. Default: 24 px on all sides.

Padding Desktop Settings

The inner space between the toast content and its border — top, bottom, start, and end sides independently. Range: 0–60 px. Default: 20 px on all sides.

Padding Mobile Settings

The same inner spacing controls as above, applied specifically on mobile viewports. Range: 0–60 px. Default: 20 px on all sides.

Quick Reference

Do you need help?

If you have any questions or run into issues, please contact us — we’re happy to help.