Store variables
On this page
Store Variables are used to set parameters that dictate how your store works. They are always optional (because they have default values) and can be changed to affect your store or to provide custom values that apply for your Store, eg. API keys for third-party services.
When adding a store variable, you should know what variable are already available to use, what values the variables can contain, and what effect each will have on your store. You are not limited to these as you can create any variables you want and update your theme to make use of them.
Themes have Theme Variables and these work in much the same way. The key difference is that a Theme Variable’s value is used for all stores that use that theme, whereas Store Variables only impact that store.
If you want to override a Theme Variable for a single store, create a Store Variable for that store using the same key used by the theme.
Adding a store variable
New variables can be added for a store from it’s Store Variables related list.
For each variable you add to your store, give it a name that makes sense to your organisation. Add a key and the value for that variable. if you make the variable available in Liquid (checkbox), the key can be referenced in your theme to make use of the value you entered.
Variables already available
| Key | Value | Effect |
|---|---|---|
| addressify_api_key | A valid API Key for the Addressify service | Enables address autocomplete on the checkout shipping address field (Australia only). See Addressfinder integration for setup. <hr>For multi-region support, see Google address autocomplete |
| captcha_type | String (e.g., “recaptcha”) | The type of captcha service to use. See Adding captcha to your checkout flow |
| captcha_site_key | Google reCAPTCHA site key | Site key from the Google reCAPTCHA console. See Adding captcha to your checkout flow |
| captcha_secret_key | Google reCAPTCHA secret key | Secret key from the Google reCAPTCHA console. See Adding captcha to your checkout flow |
| captcha_passing_score | Decimal (0.0 to 1.0, default: 0.5) | The minimum reCAPTCHA v3 score required to pass. See Adding captcha to your checkout flow |
| cart_abandoned_hours | Integer (Min: 1, Max: 1080, default: 10) | How many hours after the customer creates a cart before it is marked as abandoned (between 1 hour and 45 days). See Process empty and abandoned carts |
| checkout_uses_email_confirmation | true or false | Adds a confirm email field to the checkout form requiring customers to enter their email address twice |
| checkout_uses_first_and_last_name | true or false | Separates the First and Last name on checkout |
| delivery_windows.allow_on_backorder | true or false | Allows delivery windows to be selected for backordered items. See Delivery windows |
| enable_company_name | true or false | Adds an extra field for Company Name to the checkout form and the profile page |
| autocomplete_countries | Comma-separated 2-character ISO country codes (e.g. AU,US) | Countries supported by Google address autocomplete at checkout. Google supports up to five at a time. Must have Available in Liquid enabled. See Google address autocomplete |
| default_autocomplete_country | 2-character ISO country code (e.g. AU) | The default country pre-selected for Google address autocomplete at checkout. Must have Available in Liquid enabled. See Google address autocomplete |
| google_autocomplete_api_key | A valid Google Maps API key | Enables Google address autocomplete on the checkout shipping address field. Must have Available in Liquid enabled. See Google address autocomplete |
| google_maps_api_key | A valid API Key for the Google Maps service | Enables maps for the Location Finder feature and anywhere else maps can be used on the site |
| google_reviews.delivery_days | Integer (1 to 365) | Number of days expected for delivery of orders |
| google_reviews.merchant_id | Google Merchant ID | Used when you add Google Reviews to your store |
| google_reviews.opt_in_style | Various options (e.g., CENTER_DIALOG, BOTTOM_RIGHT_DIALOG) | Position of the Opt In form |
| guest_subscriptions_enabled | true or false | Allows guest users (not signed in) to purchase subscription products. See Subscription products |
| logins.unconfirmed_access_minutes | Integer (Min: 0, default: 0) | Grace period in minutes that allows a new user to be signed in before confirming their email. When set to 0, the user must confirm their email before they can sign in |
| order_reference_prefix | String (Max: 10 characters, default: “SC”) | Set a prefix to order reference numbers instead of using the default of SC. Values longer than 10 characters are truncated |
| passwords.minimum.alpha_numeric_characters | Integer (default: 8) | Minimum number of alphanumeric characters required in a password. See Enforce password complexity |
| passwords.minimum.lower_case_characters | Integer (default: 1) | Minimum number of lowercase characters required in a password. See Enforce password complexity |
| passwords.minimum.upper_case_characters | Integer (default: 1) | Minimum number of uppercase characters required in a password. See Enforce password complexity |
| passwords.minimum.special_characters | Integer (default: 1) | Minimum number of special characters required in a password. See Enforce password complexity |
| passwords.lockout.failed_attempts_threshold | Integer (default: 5) | Number of failed login attempts before the account is locked |
| passwords.lockout.max_duration_minutes | Integer (default: 15) | How long in minutes an account stays locked after exceeding the failed attempts threshold |
| session.inactivity_timeout_minutes | Integer (default: 30) | How many minutes of inactivity before a customer’s session expires and they are signed out |
| session.absolute_timeout_minutes | Integer (default: 60) | Maximum session duration in minutes regardless of activity. After this time the customer is signed out |
| show_new_recipient_form | true or false | Enables a button/link on the checkout which gives the customer the chance to ship it to someone else |
| test_checkout_emails | Comma-separated list of email addresses (Max: 4) | Register email addresses that when used at checkout, orders come through marked as Test Order. See Use test mode for transaction testing |
| use_shipping_notes | true or false | Adds an extra field for use on the shipment section of the checkout |
| visible_address_lines | Integer (Min: 1, default: 1) | How many Street Address lines to provide on forms |