Docs

Switch from Locksmith

Import your Locksmith locks and keys into Shopbird, check them, and switch over without a gap.

Shopbird makes it as easy as possible to migrate from Locksmith. It imports your locks and keys, you check each one and turn it on, then you remove Locksmith. Your storefront doesn't change until you turn a lock on.

Choose how to switch

  • Import it yourself. Follow the steps below. Most of the time goes into checking each lock.
  • Have us do it. We import and check your locks, set up your theme, remove Locksmith's code and test checkout with you. Email support@shopbird.app for a quote.

What comes across

Every lock, key and condition shows in a preview before anything is created. Nothing is left out silently.

These need a change, and the preview marks them:

  • Custom Liquid, weekly schedules, dates mixed with other conditions in one key, store domain checks, regions or cities in a location, and condition types Shopbird doesn't recognize. Shopbird has no equivalent, so you remove them.
  • Input lists, Klaviyo and Mailchimp. You pick the Shopbird list or enter the list ID.
  • "Has a certain product variant in their cart". You remove it and add a Cart contains condition after the import.
  • Email and purchase conditions. They need customer data access, or you remove them.

Manual locking and hiding from navigation menus don't come across.

How Locksmith maps to Shopbird

Each lock becomes a Shopbird lock. Each key becomes an audience, and every condition in it must pass, as in Locksmith. Locks that share a key share one audience.

In Locksmith In Shopbird
Lock on a product, collection, page or blog Lock on the same item
Lock on the entire store Store lock
Key Audience linked to the lock
Is tagged with Customer tag
Is signed in Any signed-in customer
Gives the passcode Password, case-sensitive as in Locksmith. With a use limit, a code with the same limit
Gives one of many passcodes Codes, not case-sensitive. Single-use passcodes stay single-use
Arrives via a secret link Codes, each one also a ?unlock= link. Old Locksmith ?ls= links keep working while Shopbird's app embed is on
Confirms the prompt Age check
IP address Visiting from an IP address or range
Visitor location Visiting from a country. Regions and cities are left out, with a note
Input list A list you pick from your Shopbird lists
Klaviyo or Mailchimp Klaviyo or Mailchimp condition, with the list ID you enter
Has purchased (by product or tag) Has purchased, over the same number of days
Placed at least x orders Has placed at least x orders
Has a certain product in their cart Cart contains the product, tag or vendor
Has at least $x in their cart Cart subtotal of other items, at least $x
Key that unlocks after a date Lock schedule: locked until that date
Key that unlocks before a date Lock schedule: locked from that date
"Always permit" key Left out, with a note: the lock was open to everyone
Customer auto-tagging Tag customers on unlock
Redirect URL on your store Redirect after unlocking
Hide price, hide buy buttons What locked visitors see: price and buy buttons hidden
Hide from lists Unlisted while locked
Entire store lock that allows the home page Store lock that leaves the home page open

Import your locks

  1. Install Shopbird. Keep Locksmith running.
  2. In Locksmith, open Settings, scroll to the end and select Add access token. Copy the token.
  3. In Shopbird, go to Locks > Import from Locksmith. Paste the token and select Preview import.
  4. Fix or skip each lock marked Needs attention. You can rename a lock, pick a list, enter a list ID, remove a condition or key, or select Don't import this lock.
  5. Select Import. Locks arrive off. Running the import again skips locks it already made.

Shopbird uses the token for this import only and never stores it.

The token doesn't work

Select Paste JSON instead and paste Locksmith's API response:

curl "https://uselocksmith.com/api/unstable/locks.json" \
  -H "x-shopify-shop-domain: your-store.myshopify.com" \
  -H "x-locksmith-access-token: <your Locksmith token>"

Switch over

  1. On Shopbird's Home, turn on the app embed and add the unlock block from the setup card.
  2. Open each imported lock. Check what it covers and who can unlock it, and add what its notes say is missing.
  3. Turn on each lock you want to keep. Checkout enforces it after the next sync.
  4. In Locksmith, open Help and select Remove Locksmith. This takes its code out of your theme.
  5. In a private window, unlock a locked product and go through checkout.
  6. Delete the Locksmith access token, then uninstall Locksmith.

Locks you don't turn on are open once Locksmith is removed. Old Locksmith ?ls= links keep working.

Changed your mind before step 4? Turn your Shopbird locks off. Locksmith is unchanged.

If Locksmith's code is still in your theme

Uninstalling Locksmith without Remove Locksmith leaves its code in your theme. It keeps hiding prices, buy buttons and content.

In Shopbird, go to Settings > Theme compatibility and select Check for Locksmith code. Shopbird lists each file with Locksmith's code, gives you a cleaned copy to paste, and lists the snippets to delete last.

Remove the code by hand
  1. In Shopify, go to Online Store > Themes. Duplicate your live theme, so you can go back.
  2. On the duplicate, select Edit code.
  3. Search for locksmith. Delete every block that starts with {%- comment %}<locksmith: and ends with the matching </locksmith: comment, with the code between them. Some files use locksmith-lean:.
  4. Replace each locksmith_<id>_forloop__<name> with forloop.<name>. For example, locksmith_1a2b_forloop__index becomes forloop.index.
  5. Delete the block that starts with the comment "Code added automatically by the Locksmith app".
  6. Delete the snippets whose names start with locksmith.
  7. Preview the duplicate. When locked products look right, publish it.

A locksmith entry can stay in your theme's locale files. It does nothing.

Get help

Email support@shopbird.app with your store's myshopify.com address and where you're stuck. Screenshots help. Ask about hands-on migration if you'd rather we do the switch.