Most of Locksmith's keys work via special Liquid code that we automatically bake into your shop's theme. This method is super fast, because all the magic happens on Shopify's servers, using Shopify data - very, very minimal overhead.
There's another category of keys, though, that we call server keys: these are special, because they usually require the user's web browser to make a background request to Locksmith's servers. (Hence the term!)
Usually, this is a nearly transparent distinction. (Server keys do involve a loading screen, because they take a tad longer to load.) There are a few limitations, though - scroll down to learn more.
Types of server keys
- Secret links
- IP address
Note: The below limitations apply to version 5 and below. Upgrade to version 6 for a far more streamlined version of server keys. :)
Remember, you can always change your Locksmith version!
- For some themes, Locksmith may be unable to auto-reveal individual pages, products, collections, links, or search results when they appear in a list and are protected by a lock having a server key. This is because, in the context of those lists, Shopify may not permit Locksmith to detect whether or not the visitor qualifies for access. (Developers: this either happens when theme sections are in play, or when the resource in the list is protected with a lock other than the one(s) used for the current url's primary resource.)
To work around this, modify your key to also require that the customer be signed in. This allows Locksmith to flag the customer's record as approved for access, giving it the information it needs to grant the customer access within the restricted context of those lists.
- In this version, server keys are completely incompatible with manual mode.
- This version uses an iframe, layered over your shop's content, to display content protected by server keys. There are some pretty significant limitations here, so we created a dedicated guide: read more here.