element with the "locksmith-email-container" class: ```php

``` \ You can copy the entire element and all child elements like so:

4. Paste this directly into your "Mailing list signup prompt". You should end up with something like this:

The "key_condition_id" will vary depending on you *actual* key condition id

5. Save that, and open your locked page again on your storefront. If everything worked, your email list signup prompt and form should look exactly like it did before. But now you have the ability to edit it as needed. Please note that you must always include a `

` tag with an id of `locksmith_email_form` - otherwise Locksmith will try to include the form itself, and you'll end up with two forms - so don't remove that when editing the code. # Showing multiple prompts on the same page How to set up Locksmith to show more than one input form when using more than one condition type on the same page Many of Locksmith's access conditions require input from your customers, whether that be a login, or just a code entry or a confirm button press. Sometimes you might wish to give your customers flexibility by providing multiple different ways for a customer to gain access. For example, perhaps they can enter a passcode OR subscribe to your mailing list. Setting that up would look something like this:

By default, **Locksmith only shows one entry method at a time to customers**. In the above example, you'd see something like this:

Newsletter prompts are prioritized over passcode prompts according to Locksmith's internal rules

## Editing messages to show both forms To include a specific form for a key condition that you're using, you can mix and match the following liquid variable outputs in your Locksmith messages:

Form/condition type	Liquid code used to include the form
passcode	`{{ locksmith_passcode_form }}`
mailing list signup (i.e. Klaviyo or Mailchimp)	`{{ locksmith_email_form }}`
confirmation	`{{ locksmith_confirmation_form }}`
login - for store accounts. If you are not using legacy customer accounts, this is just a button pointing to the sign in page	`{{ locksmith_customer_login_form }}`
registration - for store accounts. only applicable if you are using the legacy customer account system	`{{ locksmith_customer_registration_form }}`

## Example Continuing the passcode/klaviyo example from above, add this: ``` Subscribe to our mailing list to continue! {{ locksmith_email_form }} Or, enter the passcode: {{ locksmith_passcode_form }} ``` Which results in this:

## Which message should you edit? The easiest way to make sure your locked pages display correctly when using multiple prompts is to simply **copy/paste the same exact message to each of your messages**. Technically only one of them will be used - which is based on Locksmith's internal sorting rules. But, for simplicity, use consistent messages:

# Showing content only to specific Markets How to use the Locksmith app to restrict content in your different Markets on your Shopify: Online Store sales channel Locksmith can be used to show different content depending on what Market a customer is visiting. The first step is to divide up the content in your store. If you already know what products or collections you want to show or hide in different Markets, then you do not need to create extra collections here. Since the goal for merchants here is typically to just to show a different product offering to different markets, you'll want to create collections that each contain the products that you'd like to display for each market. Keep in mind that you can use [Shopify's automated collection feature](https://help.shopify.com/en/manual/products/collections/automated-collections/auto-create) to make this easier. Once your collections are created, it's simply a matter of adding a lock to them in Locksmith: ![](/files/SRmuvAnRob6ZIV4MWMvi) {% hint style="info" %} **Note**: You are not limited to locking only collections or products in this way. You could also lock pages or variants, for example. In this case, you'd just need to create the variants or pages that you want to display for each Market. {% endhint %} Once the lock is created, you'll need to create the correct Locksmith "Key". Markets are typically set up by either creating *subdomains* on your store, or by creating *subfolders*. **Depending on which one of those you are using, you'll need to set up Locksmith a bit differently...** ## When using subdomains This will usually look something like [www.my-store.eu](http://www.my-store.eu), or ca.my-store.com, where the subdomain of the URL represents a different region that you're selling to. In this case, simply use Locksmith's "domain" key condition:

When setting this up, Locksmith will automatically show you suggestions for which domain to use, based on the domain settings for your store. ## When using locale + country subfolders This will usually look something like [www.my-store.com/en-us](http://www.my-store.com/en-us) or [www.my-store.com/fr-ca](http://www.my-store.com/fr-ca). In this case, your key conditions will look slightly different. Start by selecting the ["custom Liquid" key condition](/keys/more/custom-liquid-key-condition-basics):

Next, you'll add in something like the following as the "Liquid condition", making sure to edit the last part to match the subfolder you are wanting to grant access to: `{% if`**`request.locale.root_url == "/en-us"`**` `` ``%} ` Note that only the bolded part needs to be entered, as the rest is included automatically. You'll end up with something like this:

If you want to set up a key condition for your primary domain, use "/" as your root\_url. In specifically:\ \ `{% if`**`request.locale.root_url == "/"`**` `` ``%} ` ## Using the "localization" object Similar to the above, you can also use the Liquid localization object in your custom key condition. This is useful if you don't use subfolders. Shopify's documentation on the localization object is here: . {% hint style="warning" %} **Important!** Using this feature doesn't mean you can use any arbitrary country in your condition. It will only work for the countries that you've set up localization options for in your store. If you want to grant access to visitors based on their IP address location, that can be done with our "locations" key condition: . {% endhint %} Your condition will look something like the following - where "CA" is the ISO code for Canada:\ \ `{% if`**`localization.country.iso_code == "CA"`**` `` ``%} `

A list of country ISO codes can be found here: # Input lists How to use Locksmith's Input List feature to work with large numbers of inputs Locksmith gives you the ability to use input lists for managed sets of [**passcodes**](/keys/passcode-keys)**,** [**secret links**](/keys/secret-link-keys), or [**email addresses**](/keys/customer-account-keys). They're useful when you have a *very large* number of possible inputs. {% hint style="info" %} **Note**: Any time you have 1000+ inputs, it is recommended to use input lists over their vanilla counterparts. Input lists can handle millions of entries, so you have a lot of flexibility here. {% endhint %} ## Step 1: Add your inputs to an external file Input lists are stored externally! So you'll need to create a file that is accessible via a URL, adding all of the values to it that you would like to use. The most straightforward way to do it is to simply use Google sheets:\ \ **Google Sheets** must be formatted as a document having a single column of input values, one value per row:

### Supported file formats In addition to Google Sheets, sources may be of the following formats: * TXT (one input value per line) * CSV (a single column of input values, one value per row) * JSON (an array of strings) * Microsoft Excel XLSX (a spreadsheet having a single column of input values, one per row) * JSON array provided by a Mechanic cache endpoint ([read more about Mechanic here](https://apps.shopify.com/mechanic)) {% hint style="warning" %} **Important**: The source file must be either unauthenticated OR must be a Google Sheet or Google Doc that has been shared with the following email address: **.**\ \ \&#xNAN;*If you send a notification directly to this email address, it may bounce. However, as long as the document is properly shared with that email address, Locksmith will be able to access it.* {% endhint %} ## Step 2: Locksmith Configuration Input lists are configured in your Locksmith account settings. To find this area, open the Locksmith app and go to the Settings area (using the left-hand navigation):

Input lists are available in the "Extensions" area:

### Options An input list has four options: * **Name** * **Source URL** * Input values are **case-sensitive** (enable to require an exact case match) * **Default usage limit per input list item** - allows you to specify a default usage limit for any items that you add to the list. This is a great way to add **unique inputs** - simply enter **1** as the usage limit and each input can only be used once. * **Partial match** - when this option is enabled, Locksmith will accept submissions that **contain** an input list value, rather than requiring an exact match. This is useful for matching part of an email address ( e.g. the domain of the email address) or other partial string. Partial matching is available for any input list (including when they are used for passcodes, secret links, and email addresses) but for performance reasons, can only be used with input lists that have **fewer than 1000 values**. If you need to grant access to a larger list of values, and then a few partial matches, you can create two separate input lists and two separate keys. ### Syncing When an input list is synchronized with its source, any new items found in the source file will be added to Locksmith's copy of the list. Any items that are *no longer* found in the source file will be *removed* from Locksmith's copy of the list. Input lists that are sourced from Google Drive will be automatically synchronized whenever the source file is changed. (When used with Google Sheets, this allows for interesting flexibility: one could use a Google Form that saves data to a Google Sheets file, which then feeds into an input list. Whenever the form is submitted, Locksmith would automatically sync a new value into the input list.) All other input lists are automatically synchronized on a regular basis (currently at [midnight UTC](https://time.is/UTC), subject to change without notice). All input lists may be synchronized manually, by using the "Sync input list" button for the respective list. ## Step 3: Use with specific key conditions Once you've created at least one input list, you may use it when configuring a new key condition in your lock settings, by choosing one of the "Permit if..." options that mentions input lists. When adding keys to you locks, use the corresponding options... ### Email Addresses When configuring your key condition, select the "Permit if the customer has an email address from an input list…" option to have Locksmith compare customer inputs with items in your input list:

More information on using customer account key conditions here: {% content-ref url="/pages/vojen44dvTjRpsHujhOA" %} [Customer account keys](/keys/customer-account-keys) {% endcontent-ref %} ### Passcodes When configuring your key condition, select the "Permit if the customer gives a passcode from an input list…" option to have Locksmith compare customer input with items in your input list\

As with Locksmith's other passcode conditions, you may configure this condition to "remember" returning customers who are logged in. If this option is enabled, Locksmith will compare previously-accepted passcodes from the customer's records with *current* items in the selected input list. This means that *removing* previously-used items from the input list will result in the relevant returning customers being "forgotten". More information on using passcodes here: {% content-ref url="/pages/QDnvLtkLiYqhX0WaiZJp" %} [Passcode keys](/keys/passcode-keys) {% endcontent-ref %} ### Secret links When configuring your key condition, select the "Permit if the customer arrives using a secret link code from an input list…" option to match the visitor's current URL with items in your input list:

As with standard secret link keys, Locksmith will be trying to find matching secret link codes in the following parts of the URL: * The URL's "search" portion. For example, in a URL that looks like "", Locksmith will consider items in your input list having the value "foo=bar\&baz\&ls=qux". * Any component in the URL's "search" portion. For example, in a URL that looks like "", Locksmith will consider items in your input list having one of these values: "foo=bar", "baz", "ls=qux". * The "ls" query parameter, if present. For example, in a URL that looks like "", Locksmith will consider items in your input list having the value "qux". This means that you may form your shared URLs in any of the following ways, using an example secret link code of "foobar" to illustrate: * * Feel free to combine either option with other query parameters, like so: * . * . As with Locksmith's other secret link condition, you may configure this condition to "remember" returning customers who are logged in. If this option is enabled, Locksmith will compare previously-accepted secret link codes from the customer's records with *current* items in the selected input list. This means that *removing* previously-used items from the input list will result in the relevant returning customers being "forgotten". More information on using secret links here: {% content-ref url="/pages/VGiBbrxUlyxmZVtO2aLl" %} [Secret link keys](/keys/secret-link-keys) {% endcontent-ref %} # Protecting against bots A strategy to protect your products from bots and unapproved resellers purchasing from your Shopify Online Store {% hint style="warning" %} **This is a legacy guide**. This technique may still be useful for some, but for those wishing to add a "Checkout rule" to their store via Locksmith, see our guide here: [Setting up checkout validation with Locksmith](/tutorials/more/setting-up-checkout-validation-with-locksmith) {% endhint %} Many merchants that sell collectors items, limited edition items, or other types of highly exclusive items are plagued by bots purchasing their products, and come to Locksmith for help. **Without using a** [**checkout rule**](/tutorials/more/setting-up-checkout-validation-with-locksmith)**, Locksmith is NOT able to prevent bots and other unapproved resellers from purchasing from your store**. This is because direct-to-checkout links, which allow products to be purchased without even visiting the Online Store, exist within the Shopify platform, and it's not possible for apps to get involved with this layer. {% hint style="info" %} **Note**: This also applies to merchants wanting to use Locksmith to give away free items to select customers. As soon as bots pick up on the presence of your free items, they may attempt to buy your entire stock, *even if those items are protected by Locksmith*. {% endhint %} While Locksmith itself cannot help here, there is a way you can prevent this from happening *without the need for any apps*. ## The solution: discount codes So the general strategy here is to set your products up so that the *public* price is something pretty high - **a price high enough so that the bots will ignore it**. Then, you'll use [Shopify's Discount feature](https://help.shopify.com/en/manual/discounts) to create a discount to bring the price back down to the original price that you'd like to sell at. Thankfully, Shopify allows you to create discounts that can *only* be used by specific "customer segments". [More information on creating customer segments here](https://help.shopify.com/en/manual/customers/customer-segmentation/customer-segments). So, for example, you could create a customer segment that's based on a specific customer tag: ![](/files/i8KGG5M1Nca3GbyyHUDl) And then give the customer segment a description name: ![](/files/vwAM0j8CXw0fLuu7T5J0) When setting up the discount code, use the "Customer eligibility" section to select the customer segment that can use this discount: ![](/files/uEeZPjcYPuF0iCN6qfKs) The result of this is that you now have an avenue to make sure that only the customers you designate have a pathway to purchase that is secured all the way to the completion of the sale. You can absolutely use this strategy without further involvement with any apps, including Locksmith. The customers will simply use the product pages as normal, and enter the discount codes at checkout. Again, the price they'll see here will be higher than what the customer is most likely expecting, so make sure you do everything you can to communicate with your customers about using the discount code. You can do this in the product description, in customer mailers, or when they contact you (more on that below). That's it for the basic setup! ## How Locksmith *can* help *Optionally*, Locksmith can still help get your product pages to a place that helps direct your non-bot customers to the right place. Locksmith has features that will help hide the price and add-to-cart buttons so that the public facing price doesn't scare customers away that stumble onto your product pages. More information, and set up guide, on hiding the price and add to cart button here: {% content-ref url="/pages/eHG9k5snoahy4lKbaR7b" %} [Hiding product prices and/or the add to cart button](/tutorials/hiding-prices) {% endcontent-ref %} So basically, when set up correctly, your customers would see something like this when they land on your product pages: ![](/files/qGl7fLCtANT1EPbcLBXv) {% hint style="info" %} **Note**: You have flexibility in what you want the link to say, and where it points your customers to. {% endhint %} Then, when signed in with an approved account, they will be able to add to cart and purchase. ![](/files/CsjeRISKocMf83iykAPf) {% hint style="warning" %} **Remember**: Locksmith alone is not enough to prevent bots from purchasing the products out from under you - you'll need to combine this with the discount method outlined above. {% endhint %} For questions or help with setup, contact us via email at **!** # Earn recurring revenue on your exclusive content using ReCharge You can use Locksmith alongside a dedicated subscription app to lock content so that the content can only be accessed by active subscribers. This guide covers how to use ReCharge, but it should be noted that any recurring payment service that offers the "auto-tagging" feature would work with Locksmith. {% hint style="info" %} **Note**: This guide only covers recurring purchases. if you want to grant access based on a *single purchase,* that is a built-in Locksmith feature, no third party app required. [More info on that here](/tutorials/selling-digital-content-on-shopify). {% endhint %} ## ReCharge Setup: If you haven't already, install the ReCharge app and use their instructions to set up a recurring subscription for one of your products: [Get started with ReCharge here!](https://apps.shopify.com/subscription-payments) One thing to keep in mind is that even if you aren't offering a subscription to an actual physical product, you can still use ReCharge and just label the subscription product as something like "Exclusive Access" or "Membership". **Recharge will automatically tag customers with "Active Subscriber"** if they have an active ReCharge subscription, making the setup very simple. Also note that this tag is removed if the customer ends their subscription. ## Locksmith Setup: The Locksmith side of this is pretty straightforward. Open up the Locksmith app and create a lock by searching for the page, product, collection, etc that you want to limit access to. Once the lock is created, add the following key:

That's all it takes! Locksmith will now only grant access to accounts tagged with "Active Subscriber", which will only be added to accounts that have an active subscription via ReCharge. ## Advanced setup for multiple tiers: ### If all of your plans are accessing the same content... E.g. - you have a monthly, yearly, etc option - no additional setup needed: the same tag will get added to a customer account to matter what plan they have, and customers using all plans will be able to access the content. ### If you have multiple plan tiers to access *different* content, depending on the tier... E.g. Gold, Silver, Bronze tiers, but the access for each tier is different. In ReCharge, you'd create a recurring order product for each of your tiers. In Locksmith, add a lock to the content that is associated with a particular membership level. You will end up with at least one lock for each tier, maybe multiple, depending what content you are locking! Use the following key:

Make sure to fill out the "Only look at orders in the last..." field with the appropriate subscription length that matches you rReCharge subscription:

If there is any content that can be accessed by more than one type of membership level, just add them both as Locksmith keys:

**Feel free to ask questions if you're having any issues with any of that!** We can be contacted via email at m**.** ## Related articles: {% content-ref url="/pages/Rtavrz1uam6HlWPicwww" %} [Selling digital content on Shopify](/tutorials/selling-digital-content-on-shopify) {% endcontent-ref %} {% content-ref url="/pages/hydVEIVbc7QjkXdez4q0" %} [Use Locksmith and PayWhirl together to grant access based on subscriptions](/tutorials/more/use-locksmith-and-paywhirl-together-to-grant-access-based-on-subscriptions) {% endcontent-ref %} # Use Locksmith and PayWhirl together to grant access based on subscriptions You can use Locksmith alongside a dedicated subscription app to lock content so that the content can only be accessed by active subscribers. This guide covers how to use PayWhirl, but any recurring payment service that offers the "auto-tagging" feature would work with Locksmith. **Note**: This guide covers recurring subscriptions. If you want to grant access based on a *single purchase,* that is a built-in Locksmith feature, no third party app required. [More info on that here](https://www.locksmith.guide/tutorials/selling-digital-content-on-shopify). ### PayWhirl Setup: If you haven't already, install the PayWhirl app and use their instructions to set up a recurring subscription for one of your products. Start by creating a product on your store, and then linking it to a subscription through PayWhirl. You can find the full setup instructions here: {% embed url="" %} **Important: You'll need to configure PayWhirl to tag customers who subscribe.** To do this, click on the Workflows tab in PayWhirl, and then click on "Create customer tagging":

Next, click on "Tag active subscribers", and then "Create and activate workflow". Your setup should look something like this on the Workflows screen when you're done:

### Locksmith Setup: Open up the Locksmith app and create a lock by searching for the page, product, collection, etc that you want to limit access to. Once the lock is created, add the following key:

Here's a refresher on how to create keys: {% embed url="" %} That's all it takes! Locksmith will now only grant access to accounts tagged with "Active Subscriber", which will be added to accounts that have an active subscription via PayWhirl. Based on the Workflow settings you set up already, the tag will be removed when the customer cancels or is otherwise unsubscribed. As a result, they'll also automatically lose access to the locked content. ### Advanced setup for multiple tiers: #### If all of your plans are accessing the same content... E.g. - you have a monthly, yearly, etc option - no additional setup needed: the same tag will get added to a customer account to matter what plan they have, and customers using all plans will be able to access the content. #### If you have multiple plan tiers to access *different* content, depending on the tier... E.g. Gold, Silver, Bronze tiers, but the access for each tier is different. In PayWhirl, you'd create a recurring order product for each of your tiers. In Locksmith, add a lock to the content that is associated with a particular membership level. You will end up with at least one lock for each tier, maybe multiple, depending what content you are locking! Use the following key:

Make sure to fill out the "Only look at orders in the last..." field with the appropriate subscription length that matches your PayWhirl subscription:

If there is any content that can be accessed by more than one type of membership level, just add them both as Locksmith keys:

**Feel free to ask questions if you're having any issues with any of that!** We can be contacted via email at m**.** # Use Locksmith and Seal Subscriptions to grant access based on subscriptions You can use Locksmith with Seal Subscriptions to control access based on a customer’s subscription status. Seal Subscriptions supports auto-tagging customers depending on whether their subscription is active or inactive. Here’s how it works: #### How Seal Subscriptions tags customers * Seal Subscriptions can automatically tag customers when they have an active subscription. * When a subscription becomes inactive (expired or cancelled), Seal doesn’t remove the active tag. Instead, it applies an additional tag for inactive subscribers. Reference: #### Setting things up in Locksmith 1. Make sure Seal Subscriptions is configured to add both active and inactive tags to your customers. 2. Create a lock on the content you want to restrict (products, collections, pages, etc.). Guide:\ [Creating locks](/basics/creating-locks) 3. Add a key condition: **Permit if the customer is tagged with...** and enter your active subscription tag. This is a regular (non-inverted) condition. 4. Now turn this into a combo key by adding the second condition *inside the same key*: * Click **Edit** on the key you just created. * Scroll to **+ Add key condition** and add **Permit if the customer is tagged with \** * Enter your inactive subscription tag and (if needed) check [**invert**](/keys/more/inverting-conditions-in-locksmith) so the condition reads **Permit UNLESS the customer is tagged with \** * Save the lock. You now have a single combo key that requires both conditions at once. See:\ [Combining key conditions](/keys/more/combining-key-conditions)\ [Inverting conditions in Locksmith](/keys/more/inverting-conditions-in-locksmith) 5. Result: customers must have the **active** tag, and must **not** have the **inactive** tag, to get access. The keys should look like the following example once setup:

#### Helpful resources {% content-ref url="/pages/vojen44dvTjRpsHujhOA" %} [Customer account keys](/keys/customer-account-keys) {% endcontent-ref %} {% content-ref url="/pages/WvgSxoLu5Yu2LN8UhkxS" %} [Inverting conditions in Locksmith](/keys/more/inverting-conditions-in-locksmith) {% endcontent-ref %} {% content-ref url="/pages/ZcLkHf2n32p0GJzwXZME" %} [Combining key conditions](/keys/more/combining-key-conditions) {% endcontent-ref %} #### Summary Because Seal Subscriptions doesn’t remove active tags, you’ll need to use both a regular (non-inverted) condition (active tag) and an inverted condition (inactive tag) in Locksmith. This setup ensures that only customers with a current subscription can access your locked content. # Liquid locking basics Locksmith has a feature to create "Liquid" locks, which allows you to lock pages in your store that are otherwise not searchable using the basic "Add lock" resource search in Locksmith. {% hint style="warning" %} This is an advanced guide that requires knowledge of [Shopify's Liquid language](https://shopify.dev/api/liquid). If you're a developer type, read on! Otherwise, please note that Locksmith support is not able to write advanced custom Liquid locks for you. While we are happy to answer any questions you have along the way, if you need help writing these, you'll need to hire a paid Shopify expert. [Our list of partners is here](https://locksmith.partnerpage.io/). Alternatively, you can check [Shopify's own list of Shopify experts](https://www.shopify.com/partners/directory). {% endhint %} Moving on - to begin, click in the "Add a new lock" search field and select "Start a Liquid lock", or type "Liquid" in the search field: ![](/files/lwcHeVqlANvH3Vu0iL9g) Then click "Start a new lock":

This will bring up the following form:

## The "Liquid condition" The "Liquid condition" is the condition that is evaluated to decide if the lock will be engaged on the current page. The Liquid condition simply needs to evaluate to true or false. All liquid objects in Shopify are fair game here, [more info on Liquid objects here](https://shopify.dev/api/liquid/objects). **Useful examples** Any condition that evaluates to true will result in a locked page. So, imagine if you created a lock with this condition: ``` {% if true %} ``` That would result in every single page in your store becoming locked. This isn't advisable, it's just a proof of concept :) *** One of the most useful variables that you can use is the **canonical\_url** variable. This variable contains the full url of the current page, so it is a good way to lock pages that aren't usually searchable. For example you have an app that lives at *my-store.myshopify.com/apps/bulk-order-form-app*, you could lock it with the following condition: ``` {% if canonical_url contains "apps/bulk-order-form-app" %} ``` *** Another useful variable is the **template** variable. For example, an easy way to lock *only* the home page would be: ``` {% if template == "index" %} ``` If your home page template is called something else, you have the flexibility to lock it by adjusting the condition above. ## The "Liquid prelude" The "Liquid prelude" will be evaluated *before* the liquid condition, and is where you'll add any code that helps you set up the Liquid condition, and can span multiple lines. For example, you can assign to a specific custom variable, which can then be used the the Liquid condition later. For example, if you have a large number of pages that you want to lock at once, normally you'd need to do that by creating a separate lock on each page. You could use the Liquid lock feature to lock them all at once. Perhaps something like the following: In your Liquid **prelude**: ``` ``` In your Liquid **condition**: ``` {% if page_is_locked %} ``` This would result in all "Pages" in your store that contain "member" or "secret" in the title becoming locked. ## Related resources You can also create Liquid keys! While the function of Liquid keys is fundamentally different than what is covered on this page, the concepts while setting them up are very similar: {% content-ref url="/pages/ve2JX4pz2jetN297ciB6" %} [Custom Liquid key-condition basics](/keys/more/custom-liquid-key-condition-basics) {% endcontent-ref %} {% content-ref url="/pages/sr7kTFCzra9xHwxwqCNd" %} [Locking multiple pages at once](/tutorials/more/locking-multiple-pages-at-once) {% endcontent-ref %} # Restricting checkout from the cart How to use the Locksmith app to add checkout restrictions on your Shopify Online Store Locksmith allows you to restrict checkout by using a lock on the cart page in your store. **This is a good choice for merchants who want to allow customers to view all content in their store and browse fully,** only adding in restrictions on the last page before checkout. Or, to simply add extra restrictions for checking out, on top of other locks in the store. ### **Limitations:** * The method locks down the cart page only. The cart page is always found at the '.../cart' link in your store (e.g. [www.example-store.com/cart](http://www.example-store.com/cart)). Using other types of carts (slider, dropdown, dynamic/ajax, etc.) or adding "Buy Now" links to your store (which point the customer directly to checkout without going through the cart page) will not work with this method. * Locking the checkout area itself is **not** possible using Locksmith’s standard locking methods. This means that checkout links leading directly to checkout—such as ‘Buy Now’ buttons, upsell links, permalinks, or abandoned cart links—cannot be restricted using this approach. However, you can enforce a single checkout restriction using Locksmith’s checkout validation feature. Learn more here: [Setting up checkout validation with Locksmith](/tutorials/more/setting-up-checkout-validation-with-locksmith) \ Moving on, this is the checkout page without any locks in effect: ![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/5ddd799f2c7d3a7e9ae472fc/images/5e731ab22c7d3a7e9ae96a46/file-LTWtPLdeVV.png) You can lock the entire cart page if preferred. This will work just like any other Locksmith lock. However, it is also possible to take it further and lock only the "Check out" button. Once Locksmith is set up, the result will be something like one of these screenshots (depending on your settings): ![](/files/4Tn9CQxfZMcbLWyz4Ga9) \------ ![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/5ddd799f2c7d3a7e9ae472fc/images/5e7321942c7d3a7e9ae96a84/file-huM7dgYXcb.png) ## Part One: Creating the lock Use the following steps 1\. Open up the Locksmith app and search and for "cart" and click on it, or select it after clicking into the search bar when it comes up in the search dropdown: ![](/files/XcoTy3r7PJXl7CnCkGP8) 2\. On the next page, under "Keys", you'll add in your conditions. Here are some of the more common conditions used... **To impose a minimum purchase amount:**

\ **To make sure only customers that are signed in and have approved accounts can proceed:**

\ **Customer must enter a passcode to checkout:**

\ 3\. If you just want to lock the entire cart page, click "Save" to finish. If you want to lock *only* the "Checkout" button, make sure "enable manual locking" is checked under Advanced Settings before saving: ![](/files/L33CMyVWdNraB7AKCITV) Done with part one! If you need help with setting up more complicated checkout conditions, Locksmith may be able to help. Just get in touch with us :) ## Part two: Theme changes {% hint style="success" %} *New to manual locking?* [*Check out our general introduction*](/keys/more/manual-mode)*.* {% endhint %} Some modifications to your shop's theme will need to be done to protect just the checkout button. {% hint style="info" %} **Because each theme is a bit different, this feature *****does***** require manual coding.** If you install a new theme down the road, these changes will need to be re-applied. {% endhint %} The rest of this guide gets a bit technical! We can take care of adding the code for you for you, no problem, so if you're interested, get ahold of us. #### **Rather do it yourself?** Keep reading... In this portion, you'll update your shop's theme to protect *just* the checkout button(s) on your cart, allowing your visitors to manage their cart but not check out until they meet your criteria. 1. From your Shopify admin area, navigate to "Online Store" -> "Themes". Then, click the three-dots button in the upper-right corner for your theme, and select the "Edit HTML/CSS" option. 2. Open the "cart.liquid" file (under "Templates"). If you have a newer "sectioned" theme, you may actually need to edit the "cart-template.liquid" file (under "Sections") 3. Add the following to the very top of the file:`{% capture var %}{% render 'locksmith-variables', variable: 'access_granted', scope: 'subject', subject: cart %}{% endcapture %}{% if var == 'true' %}{% assign locksmith_access_granted = true %}{% else %}{% assign locksmith_access_granted = false %}{% endif %}` 4. Find the checkout submit button(s), and wrap this code with `{% if locksmith_access_granted %} ... {% endif %}` . You can also add an "else" section to show a message to anyone who's been prevented from checking out.Here's a pretty typical example: Before: ``` {% if additional_checkout_buttons %}

{% endif %} ``` After: ``` {% if locksmith_access_granted %} {% if additional_checkout_buttons %}

{% endif %} {% else %}

Please add at least $50 to your cart to check out.

{% endif %} ``` Save the template, and you're done! :) ## Other considerations: ### Clearing the cart when a customer signs out: {% hint style="info" %} **Note:** The script used here isn't an officially supported Locksmith feature. The following is an example of a script that's commonly used to clear a customer's cart when they log out. {% endhint %} Some merchants set up their cart restrictions so that they only apply to certain signed-in customers and the exclusive products they have access to. In this case, it might be possible for customers to sign out to bypass these conditions once restricted products have been added to the cart. If that applies to you, consider ensuring that all products are removed from the cart when a customer signs out. You can achieve this by adding the following JavaScript to your **layout/theme.liquid** file, just before the closing tag: ``` ``` This will clear the cart when the logout button is pressed, preventing that workaround. If this script doesn't work in your theme, your theme may not include jQuery libraries. To include those libraries, the following script can be added to an empty line right before the cart clearing script mentioned above. ``` ``` ## A note about Abandoned Cart emails If you have abandoned cart emails enabled on your shop, either through the built-in Shopify feature or an app, those emails may allow the customer to circumvent checkout restrictions. These emails can send the customer directly to the checkout process without touching the cart page. The customer will be able to check out with whatever amount was in the abandoned cart, whether or not it passes your restrictions. **Your checkout restrictions will not work 100% of the time if you're sending abandoned cart emails***,* so keep that in mind when you're setting this up. :) # Confirmation key condition Ask for a simple confirmation before granting access to content in your Shopify Online Store sales channel. This is a straightforward key condition that allows access solely based on if the customer confirms the prompt that you set. Something like the following:

To use, simply choose the key condition labelled "Permit if the customer confirms the prompt*":*

Choose the condition from the list, or type "confirm" - which will filter the list to only show the confirmation condition.

## Set the desired prompt Common use-cases/examples include: * Please confirm that you are over the age of 21 * By clicking 'Yes', you agree to our Terms of Service for accessing this page * Confirm if you have read the prerequisite material to access this advanced module * Please confirm that you have not experienced any recent health complications that could prevent you from fully engaging with this experience * etc Any message that you decide to use can be added directly to the **Messages** area:

{% hint style="info" %} You can also add messages directly to the condition setup if you need unique messages per condition. Or, you can set default messages the **Settings > Messages** area of the Locksmith app, and leave Lock > Messages blank to use it. {% endhint %} ## Changing the button text If you need to use something other than "Confirm" as your button text, this is done through your theme.
1. Go to Online Store > Themes > "Edit default theme content". [More info on that, from Shopify, here](https://help.shopify.com/en/manual/online-store/themes/customizing-themes/language/change-wording). 2. Find the Locksmith tab, and edit the button as needed:

## Adding text after the button If you want to add text that shows up *after* the button, simply use `{{ locksmith_confirmation_form }}` to denote where the form will show up. Then add more text as desired:

This results in the following, when Locksmith renders the prompt on button for your visitors:

## Including other form types If you have multiple key condition types on the same lock, it might be useful to include other form types within the prompt, so that they display on the same page. We have a guide on doing this here: {% content-ref url="/pages/ThvKsaJtKXtdZ5y5612d" %} [Showing multiple prompts on the same page](/tutorials/more/showing-multiple-prompts-on-the-same-page) {% endcontent-ref %} ## Translations You'll need to follow the regular workflow for translating anything in your theme. To get started with that, you'll likely want to use [Shopify's free Translate and Adapt app](https://apps.shopify.com/translate-and-adapt), or one of the paid apps from the app store. [More info on this, from Shopify, here](https://help.shopify.com/en/manual/markets/languages/translate-adapt-app). Once you have a language/locale/translation set up for your theme, you'll see a Locksmith > "Confirmation button text" area which you can edit as needed, for each of your languages. In the Translate and Adapt app, that looks like this:

To add translatable messages to the input prompt, check out or guide here: {% content-ref url="/pages/aP8lIk1Bb966HCf6shyh" %} [Adding translations to your Locksmith messages](/tutorials/more/adding-translations-to-your-locksmith-messages) {% endcontent-ref %} # Restricting customers to a specific collection With Locksmith, it is simple to lock down a specific collection, so that it can only be viewed by a specific set of customers. However, some merchants want to take it one step further and make sure that those customers can *only* access their collection, while the rest of the store is restricted to them. ### Part 1: Create the collection lock Add a lock to the collection that you want these customers to access. Use the search bar in Locksmith to search for the collection by name:

Under "Keys", choose how these customers will gain access. You can use whatever method of access you want. The most common way of granting access in this scenario is to use "customer tags" to grant access:

Make sure the "Force open other locks" setting is turned on for this lock. Use the following guide to do this: [Using the "Force open other locks" setting](/keys/more/using-the-force-open-other-locks-setting) . **This setting is important.**

### Part 2: Create a lock covering the rest of the store In order to make sure that these customers can't see the rest of your store, you need to actually add a lock to your "entire store": ![](/files/verEhuBwLx6iYx2dkTJG) For your key condition, you need to use the "invert" option to obtain the opposite of the first key condition:

The invert option in the context of the rest of the key condition settings.

Use the guide here if you need more guidance on how to invert your key condition: {% content-ref url="/pages/WvgSxoLu5Yu2LN8UhkxS" %} [Inverting conditions in Locksmith](/keys/more/inverting-conditions-in-locksmith) {% endcontent-ref %} {% hint style="info" %} If this is a private collection, no further action necessary. If the collection is meant to be viewed by all customers, you'll also want to use the ["force open other locks](/keys/more/using-the-force-open-other-locks-setting)" setting on the lock for the entire store. {% endhint %} # Passcode-specific redirects It's possible to use Locksmith's passcode keys to redirect visitors to specific URLs, based on which passcode they enter. Using this technique, a single page (or other locked resource) can act as a kind of switching station, pointing visitors to the content that's appropriate for them. To accomplish this, set up multiple passcode keys, each one having a distinct passcode value. Then, for each key, use the triple-dot menu on the right to set a redirect URL, sending the visitor to the appropriate destination when they enter that passcode. A demonstration: {% embed url="" %} {% hint style="warning" %} If you enter the same URL for the redirect as any of the lock's contents, then when a customer uses that key, the result will be an infinite loop. To prevent this from happening, you'll want to avoid adding redirect links to pages that are covered by the same lock. {% endhint %} ## Related articles {% embed url="" fullWidth="false" %} {% embed url="" %} # Grow your subscriber lists with Klaviyo Locksmith allows you to present your customers with a form to subscribe to a Klaviyo email list, which the customer must enter before they gain access to the locked content:

## Setup To get started, create a new lock or navigate to the lock you'd like to use, then add the key condition labelled "if the customer subscribes to a Klaviyo list".

You can optionally filter the list by typing "klaviyo" as the filter.

{% hint style="info" %} You'll notice that Locksmith also supports *only* checking if a customer is already on a list (as opposed to subscribing them). This is a separate key condition, and it also supports checking segments! [We have a dedicated guide on that here](/tutorials/more/use-a-klaviyo-list-or-segment-as-an-access-control-list). {% endhint %} You'll need to create a Klaviyo API key and give it to Locksmith (see below). Once you do that, you'll be presented with your Klaviyo lists, and you'll be able to choose which one to use like so:

{% hint style="info" %} As noted within the key condition setup, Klaviyo has their own policies regarding double opt in, and it is typically enabled by default. This setting is adjusted in your Klaviyo dashboard - it is not a setting that is controlled by Locksmith. {% endhint %} ### Klaviyo API Access The first time you select this, Locksmith will prompt you for a Klaviyo API key:

In your Klaviyo dashboard, go to Settings > Account > API Keys. You can also use the "from your Klaviyo account" link within Locksmith to go directly there:

Click the "Create Private API Key" button to create a key for Locksmith. You'll see the new key on the next screen. The scopes that Locksmith needs *full access* to from the Klaviyo API key are "List", "Profiles", "Segments", and "Subscriptions":

Copy the API key:

Then, head back to Locksmith, where you'll be able to paste in the key. Click "Continue", and Locksmith will present you with a list of Klaviyo lists, to which your new subscribers will be saved. Once your Locksmith configuration is to your liking, hit the "Save" button. From here on out, new visitors to your locked resource will be required to subscribe before proceeding. {% hint style="info" %} **Note**: any customers who are already in your list will be seamlessly granted access when they enter their email address, and will not be added as a duplicate. {% endhint %} ## Related articles: {% content-ref url="/pages/9OqKmRBcX77ody3p6kr5" %} [Customizing the email list signup form](/tutorials/more/customizing-the-email-list-signup-form) {% endcontent-ref %} {% content-ref url="/pages/77iwUv68N0neEBD4ZfM9" %} [Use a Klaviyo list or segment as an access control list](/tutorials/more/use-a-klaviyo-list-or-segment-as-an-access-control-list) {% endcontent-ref %} {% content-ref url="/pages/eG56o6Uu6VtxcgDbdhwU" %} [Newsletter keys](/keys/more/newsletter-keys) {% endcontent-ref %} # Use a Klaviyo list or segment as an access control list Locksmith allows you to use an already-existing Klaviyo list or segment to determine who gets access to your locked content. The "Klaviyo member" key condition in Locksmith can check your Klaviyo lists or segments directly, to see if the current visitor should have access, and will grant or deny access accordingly. To set this up, choose the key condition labelled "if the customer is a member of a Klaviyo list or segment":

Optional: Use the filter box and type "klaviyo" for quick access.

{% hint style="info" %} Please note that this particular key condition does NOT subscribe new members, but you'll notice in the screenshot above that Locksmith *also* has a key condition for subscribing new members. [More information on that here](/tutorials/more/klaviyo). {% endhint %} ## API Key access The first time you access one of our Klaviyo key conditions, you'll need to set up Locksmith's API access to your Klaviyo account. This is covered in detail in our guide here: [Grow your subscriber lists with Klaviyo](/tutorials/more/klaviyo#klaviyo-api-access) However, one IMPORTANT detail is, if you are using segments, you need to make sure that your API Key also grants permissions for segments, in addition to the other requirements. So - just to be clear - if you are using segments, you should have an API key that grants "Full access" to: * Lists * Profiles * Segments * Subscriptions

## Setup Take note of these settings:

### List or segment You can choose between a list or a segment. They function the same in practice, in that Locksmith asks Klaviyo directly whether or not the supplied email address is on the list or segment ### "Only check signed-in customers" setting This setting changes the behavior of this key condition significantly! If left off (the default), Locksmith will prompt the visitor to enter their email address. The email address is the ONLY thing the customer needs to enter in this case, there is no requirement to sign in. This is what that would look like in your storefront:

This is the default input prompt message displayed to customers, but - like all of our default message prompt - can be customized as needed.

If turned ON, customers will be required to sign in. Then, once signed in, Locksmith will either grant or deny access depending on if the customer is found in the configured list or segment. Here is an example of Locksmith's sign in page:

The login button in this case brings the customer to the customer sign in page for your store. If you are using Shopify's Legacy customer account system, the customer will instead be presented with the entire customer login form right on the page.

{% hint style="info" %} **Tip**: Have multiple Klaviyo lists that you want to check? You can add separate keys to represent each list you'd like to check. To do this, after creating your first key and closing the configuration popup, click the "+ Add another key" button, and you can do it all over again, selecting a different Klaviyo list. {% endhint %} # Use Mailchimp to collect customer emails Mailchimp is a great way to stay in touch with your customers (and it's free!). Connecting it to your Locksmith account lets you grow your mailing list subscription base, by making sure your visitors' email addresses are on record. {% hint style="info" %} Mailchimp has their own policies regarding double opt in, and it is typically enabled by default. This setting is adjusted in your Mailchimp dashboard - it is not a setting that is controlled by Locksmith. {% endhint %} To try it out, use these steps: 1. If you haven't yet, create your free Mailchimp account at [mailchimp.com](http://mailchimp.com/), and create at least one mailing list - this list is where Locksmith will load in your visitors' email addresses. 2. [Create a lock](/basics/creating-locks) 3. On the lock page, under "Keys" choose the "Mailchimp" key condition from the list: ![](/files/y7HewVppqP6c6xVjwIzD) 4\. In that key, click on "Connect Mailchimp" and sign into your mailchimp account. You'll be prompted to close that window when done. 5\. Choose your Mailchimp list, click off the pop-up, and then click Save. Visitors who try to access your locked content will encounter a prompt to subscribe to your mailing list, and the email addresses they submit will be loaded into your Mailchimp account. ### Tips * For a brand-new mailing list, it can take a few minutes for new email addresses to appear in your Mailchimp account. * Mailchimp will not show subscribers in your admin panel if you have any required fields besides "Email Address". Check on this by opening your list in Mailchimp, then heading to "Settings" -> "List fields and \*|MERGE|\* tags". * To make it easy to see your subscribers that arrive through Locksmith, create a "Locksmith" segment for your list. Do this by opening your list in Mailchimp, then heading to "Manage subscribers" -> "Segments". Click "Create Segment", and set up your segment like so: ![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/5ddd799f2c7d3a7e9ae472fc/images/5e27859404286364bc9436ea/5e2785946ae6a.png) Hit the "Preview" button, then on the next screen click "Save as segment". # Hiding out-of-stock products The best way to hide out-of-stock products is to create a automated collection *containing* these products, which is then protected with Locksmith. *For more automation options around out-of-stock products,* [*see Mechanic's "out of stock" task library*](https://usemechanic.com/tasks/out%20of%20stock)*.* ### 1. Create an "out-of-stock" collection In the "Collections" area of the Shopify admin, create a new collection. Under "Collection type", select the "Automated" option, and configure its conditions such that products match an inventory stock level of less than 1. Save the collection. The result: a collection that *only* contains products that have been sold out. ![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/5ddd799f2c7d3a7e9ae472fc/images/5f0875842c7d3a10cbaa5a33/file-x1vszFO64Q.png) ### 2. Lock the collection Open up Locksmith, and use the "New lock" form on its homepage to search for your new collection, using the collection title that you specified earlier. ![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/5ddd799f2c7d3a7e9ae472fc/images/5f0876c12c7d3a10cbaa5a55/file-2K3Clfssna.png) Click on the matching collection, and follow the steps to save its new lock. On the next screen, update the lock's settings so that "Hide this collection and its products" is enabled. ![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/5ddd799f2c7d3a7e9ae472fc/images/5f08771604286306f8068020/file-mqhvLzaCZW.png) Save your settings. You're done! The result: this collection, and its products (representing all out-of-stock products in your store) are now fully hidden from visitors. # How to use a private browsing session When testing Locksmith configurations, it's frequently useful to open a private browsing session, thus guaranteeing that neither Locksmith nor Shopify will remember any of your previous activity, giving you a clean slate to test with. {% hint style="warning" %} **Important:** If you're using a URL with the `shopifypreview.com` domain to test, Locksmith changes won't appear there. The Shopify theme editor's built-in preview bypasses Locksmith entirely. Locks, keys, and any manual locking code can look like they are not in place. If you're testing your published theme, open the live storefront URL in a new private browsing window. If you're testing an unpublished theme, use the preview URL that includes `?fts=0&preview_theme_id=` followed by your theme ID, as described in [Testing Locksmith on unpublished themes](https://www.locksmith.guide/tutorials/more/testing-locksmith-on-unpublished-themes). {% endhint %} All major web browsers support private browsing. Here's how to start a session, in each browser: * Google Chrome: File → New Incognito Window (Ctrl+Shift+N, or Command+Shift+N) * Safari: File → New Private Window (Command+Shift+N) * Firefox: File → New Private Window (Ctrl+Shift+P, or Command+Shift+P) * Microsoft Edge: File → New InPrivate Window (Ctrl+Shift+N, or Command+Shift+N) For more information, from the sources, on how to use "private session" (sometimes called an incognito window), use the following links: * [Chrome (desktop & mobile)](https://support.google.com/chrome/answer/95464) * [Safari on Mac](https://support.apple.com/guide/safari/browse-in-private-ibrw1069/mac) * [Safari on iOS](https://support.apple.com/en-us/HT203036) * [Firefox (desktop)](https://support.mozilla.org/en-US/kb/private-browsing-use-firefox-without-history) * [Firefox (mobile)](https://support.mozilla.org/en-US/kb/private-browsing-firefox-android) * [Edge (desktop & mobile)](https://support.microsoft.com/en-us/microsoft-edge/browse-inprivate-in-microsoft-edge-cd2c9a48-0bc4-b98e-5e46-ac40c84e27e2) # Granting access to variants by visitor input Locksmith's variant locking feature results in automatic hiding of variants that the visitor doesn't have access to. If you're using keys that are based on things that don't require customer input (say, "permit if the customer is signed in"), then revealing those variants is automatic: if the customer qualifies, the variants appear. If you're using keys that require visitor input, like passcodes or email addresses, then an intermediate step needs to be added to the customer experience, allowing them to actually *enter* their information. This doesn't happen automatically, and without it, the visitor won't have a way of accessing the hidden variants. ## Setup ### 1. Create a dedicated "sign in" page In the Shopify admin area, head to the "Online Store" section, and open up your "Pages" list. Create a page that's just for customers who are shopping the particular variant(s) that you want to help them unlock. Add menu links to this page, if necessary and where appropriate. ### 2. Lock the page Back in Locksmith, search for the page, and create a lock for it. ### 3. Add a passcode key to the page lock, using the same passcode as your variant lock Here's where it comes together: by adding a passcode key that uses *the same* passcode as your variants, the customer's successful passcode entry *here* will result in the variant locks automatically opening, because they'll register the presence of the same passcode. A bonus, if you're using multiple variant locks: Because locks can have multiple keys, there's an opportunity here for you to add multiple passcode keys here, one for each of the different variant locks you've got. This is a useful strategy if you're preparing variants for separate audiences - this allows you to have a single "sign in" page, where everyone can gain access to their respective variants. ### 4. Optional: configure the key to redirect to your product If you like, use the key's advanced settings to add an automatic redirect, routing the customer to the right product page when they enter the right passcode. You can find this setting by clicking the triple-dot icon, to the right of the key condition. As noted in step 3, this *also* works with multiple passcode keys. Simply add the right redirect to each passcode key, and the customers will be routed to the right place after entering their passcode. ![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/5ddd799f2c7d3a7e9ae472fc/images/5f8a4847cff47e001a58f678/file-1ODFjAHu83.png) # Offering different variants by postal code In this tutorial, we'll talk about configuring a Shopify store to... * Prompt the visitor to enter their postal code upon arrival * Only display variants that have their "Postal code" option set to equal the postal code that the visitor entered To do this, we'll use a series of variant locks, and one shop lock. We'll also use passcode key conditions, leveraging the ability to use a single passcode entry to activate many passcode keys at once. ### Demo store We've set up a store that contains a couple of sample products, with a handful of supported postal codes. [View demo store](https://locksmith-demo-postal-code-variants.myshopify.com/) (password: locksmith) ### Instructions #### 1. Configure your product variants For each of your products, add an option labeled "Postal code". Add one variant for each postal code that you want to support. In the demo store linked above, here's how the variants are displayed in Shopify, for one of the sample product: ![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/5ddd799f2c7d3a7e9ae472fc/images/5f875a97c9e77c0016217dc2/file-Emom5NTJnc.png) #### 2. Lock each variant option Open the Locksmith app. Using Locksmith's search box, locate each variant option, one at a time: ![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/5ddd799f2c7d3a7e9ae472fc/images/5f875afb52faff0016aeff5d/file-k2wckdQsWW.png) Select the matching item, and continue to save the lock. On the next screen, add a passcode key, setting the passcode to the same value as the postal code: ![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/5ddd799f2c7d3a7e9ae472fc/images/5f875b8746e0fb001798d091/file-PaiQiFP0P9.gif) Save the lock. Repeat for each of your postal codes, resulting in one lock per postal code variant option. #### 3. Create a lock for the entire online storefront Back on the home screen of Locksmith, use the "Add lock" form to create a lock that covers the entire online store. ![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/5ddd799f2c7d3a7e9ae472fc/images/5f875c3dcff47e001a58e791/file-AZ8KcONBXO.gif) On the next screen, add a key that permits if the visitor enters one of many passcodes. Configure the passcode list to contain each of the postal codes that you support. ![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/5ddd799f2c7d3a7e9ae472fc/images/5f875c684cedfd0017dd1cbb/file-EcVyTp3SId.gif) #### 4. Test! :) You're done! When visitors arrive at your online store, they'll be prompted to enter their postal code. If it's one of the codes on your list, Locksmith will let them in, and will now only show them variants that match the postal code they entered. Your final Locksmith locks list should look something like this: ![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/5ddd799f2c7d3a7e9ae472fc/images/5f875d4b46e0fb001798d09c/file-T7lHKJc0yH.png) To try out the customer side of this, see the demo store linked at the beginning of this article. # Locking products by tag Locksmith won't lock by tag using the Locksmith search bar. The good news is that you can make this happen with a [smart collection in Shopify](https://help.shopify.com/en/manual/products/collections/smart-collections). 1\. In your Shopify Admin, click on *Products* then *Collections* *2.* In the upper right, click Create Collection 3\. Name your collection something relevant, and then scroll down and click on the "Smart" option for the collection. 4\. In the conditions area, choose "Product Tag... is equal to" and then add your product tag into that field: ![](/files/b7sTacCSzKLLgKLBEw5G) 5\. Click Save. Once that's done, search for your new collection by name in the Locksmith search bar, and lock it that way. You'll likely want to enable the "hide from search and lists" option on that collection lock. Any time you tag a new product with that tag, it'll automatically be in that collection and therefore locked by Locksmith. :) #### "What happens in the other collections that these products are in?" Once you create your collection lock, you'll be presented with these options: ![](/files/C2Bn3esGa4HX2ncGdmh7) The highlighted "Hide from lists" option here controls whether or not the tagged (and therefore locked) products will appear elsewhere. With the option enabled, Locksmith will automatically hide these products (unless the customer is already qualified for access). In that scenario, the customer *will* be able to see the products in your other collections – they won't be prompted for access until they click through to an individual product. With the option *disabled*, the products will remain visible in your other collections. (Note that the customer will still be prompted for access when they click through to a product, even in this scenario.) # Locking multiple pages at once {% hint style="success" %} **The simplest option first:** if you just want to protect a specific, known set of pages, you don't need any code. Create a lock on one page, then use the **Protected resources** section of the lock editor to **add the other pages** to the same lock. See [Creating locks → Protecting multiple resources with one lock](/basics/creating-locks#protecting-multiple-resources-with-one-lock). The Liquid approaches below are still useful when you want pages to be locked by a *rule* — e.g. every page whose title contains a word, every page using a certain template, or every page carrying a metafield — so that pages added in the future are locked automatically without editing the lock. {% endhint %} Because Shopify doesn't provide any way to group pages (in the way that collections work for products), we need to get down to the code level in order to lock pages by a rule, or to protect a large or changing set of pages automatically. To get started, you'll need to begin a "Liquid lock: {% content-ref url="/pages/kDZqJC3FEIXwGvqQNR5J" %} [Liquid locking basics](/tutorials/more/liquid-locking-basics) {% endcontent-ref %} ## Lock all pages containing a certain word: To lock all pages containing a certain word in the title, fill out the Liquid lock form like so: ![](/files/ukriDLaSjfHbXkZmmCFl) Example code for "Liquid condition" from above image: ``` page and page.title contains "MEMBERS" ``` Submit the form to create your lock, then proceed by configuring keys as appropriate. ## Lock all pages that use a certain custom template: To lock all pages that use a certain custom template, use this: ![](/files/vtaBr05wsrhELPfHCBEk) Example code for "Liquid condition" from above image: ``` page and page.template_suffix == "preview" ``` Submit the form to create your lock, then proceed by configuring keys as appropriate. ## Lock a list of pages by page handle: To lock a list of pages based on page handles using one lock:

To list pages handles that you would like to lock, you can do that by listing each handle in the "Liquid prelude" field where the "page\_handles" variable is defined (see image below).

You can replace "first-handle,second-handle,third-handle" with your own handles and list additional handles by adding a comma "," between each handle with no spaces. **Liquid condition:** Example code for the "Liquid condition" from above image: ``` page_is_locked ``` **Liquid prelude:** Example code for the "Liquid prelude" from above image: ``` {% assign page_is_locked = false %} {% assign page_handles = "first-handle,second-handle,third-handle" | split: "," %} {% if scope == "page" and page_handles contains page.handle %} {% assign page_is_locked = true %} {% endif %} ``` Submit the form to create your lock, then proceed by configuring keys as appropriate. ## Lock pages using a metafield If your pages don't share a common word in the title, don't use a shared custom template, and you'd rather not maintain a long list of page handles, you can use a [**page metafield**](https://help.shopify.com/en/manual/custom-data/metafields) to control which pages are locked. This approach is especially useful when you have a large number of pages built with different templates or page builders. **The idea:** create a custom metafield on your pages, and then create a single Liquid lock that checks whether that metafield has a value. Any page where the metafield is populated will be locked automatically. #### Step 1: Create a page metafield definition in Shopify 1. In your Shopify admin, go to **Settings > Custom data > Pages**. 2. Click **Add definition**. 3. Give it a name (for example, `locksmith_locked`) and set the type to **Single line text**. 4. Save the definition. #### Step 2: Set the metafield value on pages you want to lock 1. Open each page you want to lock in the Shopify admin. 2. Scroll down to the **Metafields** section at the bottom of the page editor. 3. Enter any value in your new metafield — it can be anything, such as `locked`, `true`, or a tag name. The important thing is that it's not blank. 4. Save the page. {% hint style="info" %} **Tip:** Shopify's built-in bulk editor does *not* currently support pages, so metafield values need to be set on each page individually through the Shopify admin. If you have a large number of pages to update, a metafield management app from the Shopify App Store or the Shopify API can help speed this up — though both options fall outside the scope of Locksmith support and may require a developer. {% endhint %} #### Step 3: Create the Liquid lock Follow the steps in our [Liquid locking basics](https://www.locksmith.guide/tutorials/more/liquid-locking-basics) guide to begin creating a Liquid lock, and fill in the fields as follows: **Liquid condition:** ``` page and page.metafields.custom.locksmith_locked != blank ```

\ No Liquid prelude is needed for this approach. Submit the form to create your lock, then proceed by configuring keys as appropriate. #### How it works This lock checks two things: that the current page is a page (not a product, collection, etc.), and that the page has a non-blank value in the `custom.locksmith_locked` metafield. If both are true, the page is locked. To lock a new page in the future, you just set the metafield value on that page — no need to edit the lock itself. To unlock a page, clear the metafield value. #### Optional: Use the metafield value as part of your key logic You can take this a step further by putting a **customer tag name** in the metafield value (for example, setting the metafield to `vip` on one group of pages and `members` on another). This opens up the possibility of using the metafield value in more advanced Liquid key conditions, allowing different groups of pages to require different access levels — all within a single lock. This kind of setup falls into advanced Liquid territory and may require a developer to implement. ## Additional notes: If you'd like to use something other than the title or template to activate this lock, take a look at [Shopify's Liquid documentation for pages](https://docs.shopify.com/themes/liquid/objects/page) - you can adapt your custom lock for any of the page attributes listed there. ## Related articles {% content-ref url="/pages/kDZqJC3FEIXwGvqQNR5J" %} [Liquid locking basics](/tutorials/more/liquid-locking-basics) {% endcontent-ref %} # Making a product accessible exclusively from the direct product link This can be useful for merchants that don't need a product to be "secure", but still want to keep customers from finding the product by accident. Locksmith also has a *secret* link feature, which is more heavily used and different than what this guide describes. The secret link feature is more secure. If you are looking for that, simply use the key condition labelled "Permit if customer arrives from the secret link" when setting up your key. If not, read on...\ \ Use the following steps: 1. Create a lock on the product in question - to do so, open Locksmith app and search for a product by name. 2. On the next page, under Keys, select the "(custom Liquid)" condition 3. Paste `template == "product"` into the "Liquid condition" box 4. Make sure the "hide this product from search results and other lists" option is checked!

You're done :) {% hint style="info" %} **Note**: This technique can be used with other types of resources such as Pages, Collections, Articles, Blogs, etc. You'd just substitute the correct template name in your Liquid condition. {% endhint %} If this technique isn't working, it's possible that your theme uses a non-standard template name (other than "product"). To fix this, just update "product" in the lock to whatever your theme uses. #### If you would like more information on Liquid key conditions, checkout the guide linked below. {% content-ref url="/pages/ve2JX4pz2jetN297ciB6" %} [Custom Liquid key-condition basics](/keys/more/custom-liquid-key-condition-basics) {% endcontent-ref %} ## Something else not covered here? Let us know by emailing us at: **** # Creating private team areas Locksmith can be used to create separate areas of your store for different teams, clubs, vendors, organizations, or other groups. These areas are intended to be private, only for the eyes of those members. This guide also applies even if there is only a single customer that should gain access to each area. To summarize, you will create a landing page that you can link all of your customers to, and then use Locksmith to lock down and redirect customers to their own content. The rest of the guide explains, in greater detail, how to do all of this. {% hint style="warning" %} **The setup for this can become involved**, particularly if you have a large number of groups that you want to set this up for. Before you go all in with setting this up, it might be best to follow the steps in this guide for just one or two groups, that way you can more quickly get a feel for how this will work for your store. {% endhint %} ## Step 1: Create the content for each group For each group, create the collection of products that applies to them. Or, if you prefer that your customers are redirected to a single product, or some other page, you can use those instead. ## Step 2: Create the landing page This can just be a regular Shopify Page, more info on that here:\ \ Call it whatever makes sense for you. You don't have to actually add any content to the page, since customers will be immediately redirected away from this page. **Optional: Add a link to this page to your navigation menu**. This is how customers will find their content. Label the link whatever applies to your store, such as "Shop", or "Your collection", or "Member area", etc. If you do not add a link to your navigation menu, you will need to have another method of making sure your customers find, or are sent, the link to your landing page. ## Step 3: Decide how you want to grant access While it is possible to use almost any of Locksmith's key condition types for this ([complete list here](https://www.locksmith.guide/basics/creating-keys)), there are two common types for determining access: * Customer tags ([more info here](https://www.locksmith.guide/keys/customer-account-keys)) * Passcodes ([more info here](https://www.locksmith.guide/keys/passcode-keys)) ## Step 4: Add the lock and keys to your landing page 1. [Create a Locksmith lock](https://www.locksmith.guide/basics/creating-locks) directly on your landing page. 2. For each of your customer groups, add a matching key that grants access *to this landing page* (we'll create the individual collection locks in the next step). This key should define how you want customers to ultimately gain access to their collection - **so whatever you chose in step 3.** 3. For each of the keys that you create, use Locksmith's redirect feature to redirect customer to the actual collection that you are granting access to. You can set up a redirect directly within the key settings, when creating a key. Simple use the input labelled "Redirect URL". [More info on redirecting with Locksmith here](https://www.locksmith.guide/tutorials/more/redirecting-using-locksmith#redirecting-customers-after-theyve-gained-access). ## Step 5: Add the locks and keys to each of your collections For each of your collections, add a lock to it and add a key that defines how you want customers to gain access. **This key should match whatever key you used in Step 4.** Except, of course, leave out the redirect on this one. *** Once you follow those steps, you will end up with a landing page that redirects customers to their own content. The redirect will happen after the customer has gained access via signing in or giving the passcode (or whatever access method you've chosen). Feel free to contact Locksmith support at **** for any questions regarding this. # Importing customers in bulk {% hint style="info" %} Just a quick note: **Locksmith does not create a separate database of customers**. Any customers that you import here are imported as regular Shopify customers and will appear in your Shopify [Customers area](https://help.shopify.com/en/manual/customers/manage-customers). Our bulk import is simply an additional tool with a couple extra options to create/import customers. {% endhint %} To get started using Locksmith's Customers area, use the "Customers" button, found in the footer navigation on any page of the app:

There are two options for importing your customers: using a plain list of email addresses, or by loading in a CSV file that you create with your spreadsheet application. ## Importing using email addresses The only thing you'll need: a list of emails to be used, one per line(or separated by a space). You'll also see options to: * add one or more **customer tags** to each customer that's created (useful for pre-approving wholesale accounts, for example) * set an **account password** (which would allow your customers to sign in immediately, using that password). If you'd like to customize which tags or what password is used *per customer*, try using a CSV instead - read on! ## Importing using a CSV For the most flexibility, set up your customer records in your spreadsheet application (like Excel, Google Sheets), and load it into Locksmith for a bulk import: ### Supported column names *All columns are optional, unless noted.* * Email (required!) * First name * Last name * Accepts marketing (can be "true" or "false") * Note * Tags (comma-delimited) * Password * etc... Since this information is just forwarded to your Shopify store, you'll be using the same format that Shopify uses. For more complete information on CSV files for Shopify customers (and what other columns are available), [check out this page](https://help.shopify.com/en/manual/customers/import-export-customers). ## Results Locksmith will give you a preview of the customers to be imported: ![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/5ddd799f2c7d3a7e9ae472fc/images/5e27859a2c7d3a7e9ae68e67/5e27859a2876c.png) And after you click the "Start Import" button at the bottom of the page, you'll see the results: ![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/5ddd799f2c7d3a7e9ae472fc/images/5e27859a04286364bc9436f4/5e27859a995e5.png) In addition to skipping any invalid e-mails, you'll notice that Locksmith will also automatically skip any emails that already have a customer account, and it'll let you know which ones it skipped. **For questions, get ahold of us via email at ** # Disabling Locksmith for certain theme files How to tell Locksmith to completely ignore specific files in your theme Locksmith does its work by adding its code to your theme's files. Sometimes you may want to keep Locksmith from modifying a file in particular, whether it's for a customization, or some other reason. To support this, Locksmith has a "Liquid assets to ignore" option. Configure it like so: 1. From within the Locksmith application, click "Settings". 2. Scroll to the bottom of the screen to the "Advanced" section. 3. For each Liquid asset you'd like to have Locksmith ignore, add its filename to the "Liquid asset blacklist" box. That will look like this: ![](/files/Kh7TMFhCWwsdIumJS426) {% hint style="info" %} **Note**: Use full file names. (e.g. "sections/collection-list.liquid" or "templates/gift\_card.liquid"), and enter them **one per line**. {% endhint %} **Please note:** If you need to use the ignore list because Locksmith is causing unexpected problems with your theme, please let us know! Feel free to use the ignore list for any purpose, but do get in touch at if there's a bug we can help resolve. :) # Adding translations to your Locksmith messages This guide shows you how to use the translation filter built into Liquid to simplify translating your Locksmith messages ## Step 1 - Edit your Locksmith message Start by adding something like the following to one of your Locksmith messages. [More info on Locksmith messages here](/tutorials/more/customizing-messages). You can use whatever keys you like, as long as it's prefixed with **locksmith:** ``` {{ "locksmith.foo.bar" | t }} ``` Make sure to include the quotes. In the app that looks like this:

Any Liquid or HTML code will still be rendered as normal, so add as much of that as you need.

**Saving a lock with any messages that contain the above formatting will trigger a Locksmith update** which will automatically edit (all of) the locale files in your theme so that they include a new editable and translatable attribute. This is an example of what that might look like from within the locale files in your theme:

{% hint style="info" %} You can add this to any of Locksmith's messages, including the access denied content, guest message content, passcode prompt, etc. {% endhint %} ## Step 2 - Adding the translations to your theme and locales #### Default locale theme content You can immediately open Online Store > Themes > "Edit default theme content" to edit what is shown there for your default language. If you're not sure how to edit the default content in your theme, check out [Shopify's guide on that here](https://help.shopify.com/en/manual/online-store/themes/customizing-themes/language/change-wording). When editing the default theme content, you'll now see a Locksmith tab, with a section that corresponds to what you added to the section above:

You might also see a "Forms" area in there. This is something automatically added by Locksmith, if you have certain condition types, in order to support translating the buttons for their forms.

#### Translations You'll need to install the free [Translate and Adapt](https://apps.shopify.com/translate-and-adapt) app from Shopify, or one of the other 3rd party alternatives. [More info on how to use the Translate and Adapt app here](https://help.shopify.com/en/manual/markets/languages/translate-adapt-app). If you've added the Translate and Adapt app to your store, you'll see the link to it from within the "Theme content" area. While you can open the app from your apps list, you can also open directly from there:

Once inside the "Translate and Adapt" app, **scroll down to find the Theme > "default theme content" area and press on it**. Then, similarly to above, you'll see a Locksmith section that you are free to edit as much as you need. **Do this for all of your store languages.**

## Important caveat The messages added with the above method are managed by Locksmith. If you delete the declaration in your messages (the `{{ "locksmith.foo.bar" | t }}` part), the corresponding messages will be deleted from (all of) your locale files. If you want a persistent message, that isn't directly connected to, managed by, or deleted by Locksmith. You'll need to go with a more manual approach. Additionally, there are apps out there that can manage this kind of thing automatically.\ \ Again, the difference with this approach to the above, is that Locksmith will not automatically edit your locale files, it will all need to be done on your end. To start, head into the language "locale" file you'd like to update in your theme, and then add a new entry at the bottom. You might see one "locksmith" entry already - **do not add it to that one**. Just create a new one. Use whatever label schema works for you (as long as the first label isn't "locksmith"). It can contain the word locksmith in it, just can't be an exact match. For example:

**Add this same entry into all desired locales files**, and update the "Enter Passcode" to the specific language.\ \ Next, in your passcode prompt message, use the translate filter on that variable. Here's an example:

Any html or styling will need to be around that, like the <p></p> in the above example.

# Redirecting using Locksmith How to use the Locksmith app's redirecting features to make sure your customers arrive on the intended page Out of the box, when a Locksmith lock is activated on a specific page, Locksmith will block acess to the *main content* of the page (i.e. everything in between the header and footer). The main content will then be replaced by Locksmith's access denied content, which might be a sign-in page, a passcode prompt, or simply a message letting the customer know that they don't have access (depending on what keys and settings you are using). Then, of course, once a customer gains access, they will be shown the content of the page normally. While that is the default behavior, you also have the ability to send customers to a different page **before** or **after** they gain access to the content. So in this way, there are **two types of redirecting** - redirecting customers right away once they arrive on the locked page, or redirecting customer once they gain access. ## Redirecting customers immediately when they arrive on a locked page - *before* they can gain access To redirect customers this way, you'll simply use a regular Javascript redirect script, and enter it into the "Messages" area in Locksmith. More information on the messages area here: {% content-ref url="/pages/YN4tss8Ren6LqyAQ78LD" %} [Customizing messages](/tutorials/more/customizing-messages) {% endcontent-ref %} This is an example of a simple redirect script: ``` ``` The only thing you'll need to change is the exact URL. Use the full URL whenever possible (as opposed to partial URLs). In Locksmith, this will look something like the following: ![](/files/jnc2MRipp8ZUlRU633JW) {% hint style="success" %} **Tip!** Redirect scripts can be used on any type of key condition, including customer account keys, passcodes, secret links, etc. {% endhint %} Also keep in mind that in the case of customer account keys, you have the option to define different messages(or behavior, in this case) based on whether or not the customer is signed in when they arrive on the page. So, you could redirect customers that were signed in (but still didn't have access), for example. This would look like the following: ![](/files/Fkf5VQQR5HIgmmMg50Bv) ### Redirecting customers to a login form and returning them after signing in {% hint style="warning" %} **Important notes:** By default, Locksmith will present the theme's login form in place of locked resources for key conditions that require a customer to sign into a store account. Once signed in, Locksmith will also return customers to the resource they were trying to access. This redirect is only necessary for certain issues or requirements from the store's login form.\ \ When using this redirect, Locksmith won't be able to display the lock's access message content along with the login form to which customers are redirected. {% endhint %} Sometimes, a theme's login form will include features that Locksmith is unable to present when replacing locked resources with Locksmith's access denied content. This redirect is a good way to ensure customers see the correct login form. {% hint style="info" %} Note: If your login form isn't loading correctly when presented by Locksmith, please let us know by emailing us at . {% endhint %} The following code provides an example of a JavaScript redirect that automatically redirects customers to the default login form in a Shopify store. This script includes a variable that captures the customer's current URL and sets it as the return URL after signing in.\ \ This script can be pasted into the "Guest messages content" area in Locksmith. ``` ```

## Redirecting customers *after* they've gained access Locksmith also has the ability to redirect customers once they've arrived to a page that they have access to. This could be useful if you wanted to show different pages to different customers once they've gained access. **Passcodes** is an area that this is frequently used for. So - for example: three customer groups that each need to see a different collection. If I have a landing page that I put a Locksmith lock on, we can use the redirect feature to send each customer to a different collection, *depending on which passcode they've entered*. The redirect-after-access feature is found in the key settings, accessed with the edit link to the right of each key: ![](/files/OlPLu5lZWq4kgopP6uy7) The Redirect URL field is in the Key options section, at the bottom of the keys settings card:

Since this is a key setting, you can set a different redirect for each key. Notice in this example that each key is redirecting to a different collection URL: ![](/files/xmw79iPlEpvZh52n13SO) {% hint style="warning" %} If you enter the same URL for the redirect as any of the lock's contents, then when a customer uses that key, the result will be an infinite loop. To prevent this from happening, you'll want to avoid adding redirect links to pages that are covered by the same lock. {% endhint %} ## Redirecting customers from the product page to the parent collection page *before* access is granted: {% hint style="info" %} This redirect is useful for merchants who would like to ensure customers land on the collection page, in case a customer first arrives directly via a product URL. {% endhint %} To redirect customers in this way, you can use some Liquid code to check if a customer is on a product page and then include a regular JavaScript redirect script within that Liquid. This code can be entered into the "Guest message content" field or "Passcode prompt" area on the collection lock's settings page. More information on the messages area here: {% content-ref url="/pages/YN4tss8Ren6LqyAQ78LD" %} [Customizing messages](/tutorials/more/customizing-messages) {% endcontent-ref %} The following code provides an example of some Liquid and a JavaScript redirect that automatically redirects customers to a collection page from a product page in a Shopify store. The Liquid code checks for the default product template to prevent the script from running on the collection page. This script includes the URL that can be modified to redirect customers to the collection page for the locked collection. This script can be pasted into the "Guest message content" field or "Passcode prompt" field on the respective collection lock's settings page.



  <script>
    window.location = 'https://example-store.myshopify.com/collections/example-collection';
  </script>

{% hint style="warning" %} **Notes:** * This should only be added to the "Guest message content" field or "Passcode prompt" field on a collection lock's settings page, and not to message fields on the app's settings page. Otherwise, the script will be run for all collection locks. * The JavaScript redirect's URL will need to be set to match the collection URL for the collection that the lock has been set up to protect. * The default product template has been used in this example. If your products use a custom template, you will need to adjust the Liquid to check for that custom template, or for custom and default product templates. {% endhint %} ## Related articles {% content-ref url="/pages/EBPF0ev9QHVuwHDr328s" %} [Passcode-specific redirects](/tutorials/more/passcode-specific-redirects) {% endcontent-ref %} {% content-ref url="/pages/X7LG072DD6bqFsb9J4S6" %} [Customizing Locksmith’s "Access denied content" messages, and redirecting customers](/tutorials/more/customising-locksmiths-access-denied-content-messages-and-redirecting-customers) {% endcontent-ref %} # Locking variants Manage pricing and other options by creating multiple variants, and use Locksmith to manage access. In addition to managing access to your products and collections, Locksmith can protect individual variants *within* your product listings. *New to product variants? Learn more here:* [*help.shopify.com/manual/products/variants*](https://help.shopify.com/manual/products/variants) **This is a powerful feature! It can allow you to tune your product listings in a way that previously required elaborate coding, or deep manual integration with other apps.** With variant locking, you can: * ... set up wholesale pricing on your existing products without creating duplicate products, then ensure that only your wholesalers can view those prices. * ... reserve a certain amount of stock for a particular customer. * ... allocate your inventory by distribution center, and restrict access regionally. * ... add bulk quantities for your trade customers, only allowing pre-approved customers to access it. **Note: This feature may conflict with other apps. See the *****Incompatibilities***** section below for more.** ## Creating a variant lock Start by ensuring you've got at least one product variant set up in your catalog. (Learn how to set these up [for new products](https://help.shopify.com/manual/products/variants#creating-variants-for-a-new-product), and [for existing products](https://help.shopify.com/manual/products/variants#creating-additional-variants-of-an-existing-product).) Then, open Locksmith, and search for the name of your variant: ![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/5ddd799f2c7d3a7e9ae472fc/images/5e27859104286364bc9436df/5e278590ee4e7.png) **Note:** if you don't see your variant in the search results, try opening up the "Help" page in Locksmith and pressing the\ Update Locksmith button there, and try your search again. This is sometimes necessary if you've very recently created your variant. Next, select the variant and click Save. You may then add your keys. That's it! :) ## Limiting the scope of a variant lock It's possible to limit the scope of products the variant is hidden on using the product tag key condition. To learn more, please visit: {% content-ref url="/pages/luKDNR4NuA438YIb1Mud" %} [Limiting the scope of variant locks using the product tag key condition](/keys/more/limiting-the-scope-of-variant-locks-using-the-product-tag-key-condition) {% endcontent-ref %} ## Using passcodes with variant locks Passcode keys don’t work by default when placed directly on a variant lock. This is because variants don’t have their own pages, and Locksmith only shows the passcode prompt by replacing full page content. If you’d like customers to use a passcode to unlock specific variants, you’ll need to pair the variant lock with a separate landing page: 1. Create a new page in your Shopify admin (this can be a simple landing page). 2. Add a lock to that page using the passcode key you want. 3. Apply the same passcode key to your variant lock. 4. Direct customers to the landing page, where they’ll be prompted to enter the passcode. Once entered, they’ll have access to the locked variants. ## Variant locks in multi-language stores If your store uses multiple languages, it’s important to understand how Shopify translations can affect variant locking. Locksmith’s variant locks match variant option values exactly. This means the lock checks the underlying option value string (for example, “480 packs” or “Large”), not just the variant’s position or how it appears visually on the page. In multi-language stores, Shopify allows you to translate variant option values per language. For exmaple, you'll get something like this:\ \ **Large** becomes **Groot**, **Grand**, **Grande*****,*** etc. Although these variants appear equivalent to shoppers, they are rendered as different strings in your Online Storefront. Because of this, all of the translations need to be entered into Locksmith so that Locksmith knows when to look for when hiding variants. Without this, it may appear as though a variant lock works in one language but not another. ### **How to handle translated variants** There are a couple supported ways to handle variant locking in multi-language stores, depending on how your translations are managed. #### **If your store uses Shopify Translate & Adapt (or another translation app)** When you create a variant lock, Locksmith automatically fetches translated option names and values from Shopify. Translations appear in a separate **Translations** section below the main lock settings, already filled in — no manual entry required (as long as translation permissions are approved). A single variant lock can then correctly match the variant across all of your store’s supported languages. **Approving translation permissions** If this is your first variant lock on a multi-language store, Shopify may first prompt you to approve additional permissions for Locksmith. This is a standard Shopify permissions screen — approve it to allow Locksmith to read your store’s translations. Until that permission is granted, Locksmith won't try to auto-fill translations. Once permissions are approved, any new variant lock you create will have the **Translations** section pre-filled automatically. **Updating translations** If you update variant translations in Shopify after a lock already exists, open the lock and use the button at the top of the **Translations** section: * **Auto-fill from Shopify** — shown when no translations are saved yet; fetches and fills all fields. * **Refresh translations from Shopify** — shown when translations are already saved; overwrites all fields with the latest data from Shopify. After using either button, make sure to save the lock to persist the updated translations. {% hint style="info" %} If multiple products have conflicting translations for the same option name or value, Locksmith will use the first one it finds. If you need to use a different translation, you will need to manually edit the fields in the **Translations** section of the lock. {% endhint %} #### **If your store uses duplicated variants per language** Some merchants choose to create separate variants for their translations (for example, one variant per language with different option value strings). If this is you, you will need to create *separate* variant locks for each translated option value, using the same key conditions. This allows variant labels to remain translated while ensuring the correct variants are locked in every language. ## Compatibility with other apps and features Because this feature allows you to filter out variants from view, it's likely that it will conflict with any other apps that *also* operate in this way.\ \ For **products** that are locked with Locksmith, we add a metafield to prevent them from being included on the Shop app sales channel. However, this automatic protection only applies at the **product** level. When **variants** are locked, Locksmith doesn’t add the metafield automatically, which means variant visibility on the Shop app needs to be managed manually by merchants.\ \ To learn more about this, see the page here: {% content-ref url="/pages/3ecPShTRhRo9FJqGnmP5" %} [Compatibility with other apps and Shopify features](/basics/compatibility) {% endcontent-ref %} Variant locking is *not* compatible with variants being displayed by other third-party apps, including page builder apps. To learn more about this, see the page here: {% content-ref url="/pages/IAdsDTVgV9DPm6d3rbZy" %} [Locksmith is not working with my page builder app](/faqs/locksmith-is-not-working-with-my-page-builder-app) {% endcontent-ref %} {% hint style="danger" %} Variant locks are **not** compatible with Locksmith's [manual locking](/tutorials/more/manual-mode) feature. {% endhint %} # Limiting the scope of variant locks using the product tag key condition By default, Locksmith's [variant locks](/tutorials/more/locking-variants) apply to all matching option/value combinations. For example, you'll typically see something like this:

Once a variant lock is created, you can limit which products it applies to by using the key condition labelled "If the product is tagged with":

Type "product" in the popover filter, as shown above, to more easily find the correct key condition

You'll use any existing product tags to denote which products you want the variant lock to apply to, or create new product tags if needed. If you want the lock to **apply to variants on one product tag only**, and leave all other products untouched, for example, you'll use an inverted key condition like so:

Then, **as a separate key,** add in your conditions for access to the product. So if you want to allow access to the variant with a sign in, that will look like this:

The result of this is that all matching variants will automatically be unlocked if the product is NOT tagged with "Snowboard". In other words, **the variant lock will only apply to products tagged with "Snowboard"**. # Handling JavaScript DOM errors caused by variant locks Locksmith enforces variant locks at the Liquid level, which can result in a different set of DOM elements being present than the theme expects. For example, a list of product images might be filtered down to omit images belonging to protected variants; this could result in a DOM error when the theme tries to address an image that Locksmith has prevented from appearing. {% hint style="info" %} Find JavaScript errors by opening your [web browser's developer tools](/tutorials/more/how-to-access-your-browsers-dev-tools), and watching the message console as you load and navigate your online store. {% endhint %}

## Finding a solution Solving this kind of problem usually involves some trial and error, all centered around making the theme's JavaScript more tolerant of elements being unexpectedly missing. 1. Start by locating the specific line of JavaScript that's raising the error. * All error messages come with a filename. Match this filename to the relevant JavaScript asset in your Online Store theme. * Look for line numbers at the end of the filename: `theme.js:73` could mean that the error came from line 73 from that file. 2. Determine how that line of JavaScript is attempting to reference a DOM element on the page. * For example, the line `group.querySelector('option[value="'+ value +'"]').disabled = true;` is attempting to address an `