Settings Reference
All merchant-configurable settings for the autocart-checkout-gift extension.
Overview
The checkout gift extension exposes settings that merchants can configure in the Shopify admin when placing the extension block in the checkout.
Settings
Display Mode
| Key | Type | Name | Description |
|---|---|---|---|
singleRule | single_line_text_field | Upsell type | Controls the display mode of the extension. Allowed values: "banner", "slider". |
banner mode: Displays gift options as a banner block within the checkout. Rules are evaluated globally — all matching rules are processed.
slider mode: Displays a single rule's products in a horizontal slider. Requires setting the ruleTitle to target a specific rule by its title. Only one rule is displayed at a time.
Activator UI
These settings control the button/heading that triggers the gift picker modal.
| Key | Type | Name | Default | Description |
|---|---|---|---|---|
giftIcon | boolean | Show activator gift icon | (unchecked) | When enabled, displays a gift icon (🎁) beside the activator label. |
activatorHeading | single_line_text_field | Activator heading | (empty) | Title text displayed above the activator button. |
activatorButtonLabel | single_line_text_field | Activator Button label | (empty) | Text on the button that opens the gift picker modal. |
Modal
| Key | Type | Name | Default | Description |
|---|---|---|---|---|
modalTitle | single_line_text_field | Modal title | (empty) | Title displayed at the top of the gift picker modal. |
modalDescription | single_line_text_field | Modal description | (empty) | Optional description text below the modal title. |
Slider Configuration
These settings only apply when singleRule is set to "slider".
| Key | Type | Name | Default | Description |
|---|---|---|---|---|
ruleTitle | single_line_text_field | Rule title | (empty) | The exact title of the automation rule to target. Required for slider mode. Must match the rule title exactly. |
sliderTitle | single_line_text_field | Slider title | (empty) | Optional title displayed above the slider. Supports {quantity} placeholder to show the number of available gift selections. |
sliderSubtitle | single_line_text_field | Slider subtitle | (empty) | Optional subtitle. Also supports {quantity} placeholder. |
productRows | number_integer | Product Rows | 2 | Number of product rows visible at a time in the slider. |
Advanced
| Key | Type | Name | Default | Description |
|---|---|---|---|---|
doNotEvaluateStorefrontRule | boolean | Do Not Evaluate Storefront Rule | (unchecked) | When enabled, products that were added by storefront-only autocart rules will not be re-evaluated or removed at checkout. This is useful when storefront rules use conditions (like page URL) that are unavailable at checkout. Without this setting, such products would be removed because the checkout extension cannot verify the original storefront condition. |
debug | boolean | Debug | (unchecked) | Enables debug logging to the browser console. Prints all automation evaluations, condition results, cart state, and queue operations. |
App Metafields
The extension reads the following settings configured in the AutoCart app → Settings page:
| Setting | Purpose |
|---|---|
| Autoclean Rules | When enabled, automatically removes products from expired/deleted rules from the cart. |
| Checkout Active | Feature gate — must be active for the extension to function. |