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.

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:

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:

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

Last updated