Block Settings
Settings available to merchants in the Shopify theme editor.
Overview
Both AutoCart app blocks expose configurable settings in the Shopify theme editor. These settings control the UI labels, appearance, and basic behavior of the AutoCart modal.
Settings Reference
Mode Selection
Only available in the Button Mode block. The Automatic Mode block always uses actionVariant: "automatic".
| Setting | ID | Type | Default | Description |
|---|---|---|---|---|
| Autocart Modal | action_variant | select | "button" | Choose how autocart should behave: "automatic" (triggers immediately) or "button" (requires user click). |
Styling
| Setting | ID | Type | Default | Description |
|---|---|---|---|---|
| Button custom CSS | custom_styles | textarea | #ac-submit-button { } | Custom CSS for the trigger button. Target the #ac-submit-button selector. |
| Dialog custom CSS | custom_dialog_styles | textarea | #ac-dialog { } | Custom CSS for the dialog/modal. Target the #ac-dialog selector. |
UI Labels
| Setting | ID | Type | Default | Description |
|---|---|---|---|---|
| Button Label | button_label | text | "Open Autocart" | Text on the trigger button (button mode only). |
| Modal title | modal_title | text | "Autocart Picker" | Title displayed at the top of the gift picker modal. |
| Modal subtitle | modal_subtitle | text | "Select which product you desire to receive" | Subtitle displayed below the modal title. |
| Next button label | next_button_label | text | "Next" | Label for the "Next" navigation button in multi-step modals. |
| Back button label | back_button_label | text | "Back" | Label for the "Back" navigation button. |
| Confirm button label | confirm_button_label | text | "Confirm" | Label for the final confirmation button. |
| Deny button label | deny_button_label | text | "I don't want these gifts" | Label for the "decline" button when modal selector is enabled. |
| Close button label | close_button_label | text | "Close" | Label for the close button. |
| Product label | variant_label | text | "Variants" | Label shown above the variant selector. |
| Product description | variant_description | text | "Select the variant of the product." | Description text for the variant selector. |
| Product select button | variant_select_button | text | "Select" | Button label when only one variant is available (replaces dropdown). |
| Product variant placeholder | variant_select_placeholder | text | "No variant selected" | Placeholder text in the variant dropdown. |
| Total products corner label | corner_label | text | "Gifts" | Label shown in the corner badge indicating total gift count. |
| Confirm Modal title | confirm_modal_title | text | "Products to add" | Title of the confirmation modal (automatic mode). |
| Confirm Modal subtitle | confirm_modal_subtitle | text | "The following products are going to be added to your cart, accept or refuse." | Description in the confirmation modal. |
Toast Notifications
| Setting | ID | Type | Default | Description |
|---|---|---|---|---|
| Loading toast title | loading_toast_title | text | "Updating cart..." | Message shown while cart is being updated. |
| Update toast title | update_toast_title | text | "Cart has been updated." | Title of the toast shown after cart update completes. |
| Update toast description | update_toast_description | text | "Your cart is out of date. Reload to reflect the changes." | Description shown when manual reload is needed. |
Behavior
| Setting | ID | Type | Default | Description |
|---|---|---|---|---|
| Manual reload | manual_relaod | checkbox | false | When enabled, shows a reload prompt instead of automatically refreshing the page after cart updates. |
| Discount codes to exclude | discount_codes_to_exclude | text | (empty) | Comma-separated list of discount codes. When any of these codes are applied, AutoCart rules are skipped. |
| Debug | debug | checkbox | false | When enabled, logs all automation evaluations and conditions to the browser console. |
Advanced
| Setting | ID | Type | Description |
|---|---|---|---|
| Custom settings | custom_settings | textarea | Advanced settings passed as additionalSettings. See Custom Settings for the full reference. |
Usage Example
The custom_settings field accepts key-value pairs formatted as JavaScript object properties:
These values are injected directly into window.autoCartConfig.additionalSettings.