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
- Install Shopbird. Keep Locksmith running.
- In Locksmith, open Settings, scroll to the end and select Add access token. Copy the token.
- In Shopbird, go to Locks > Import from Locksmith. Paste the token and select Preview import.
- 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.
- 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
- On Shopbird's Home, turn on the app embed and add the unlock block from the setup card.
- Open each imported lock. Check what it covers and who can unlock it, and add what its notes say is missing.
- Turn on each lock you want to keep. Checkout enforces it after the next sync.
- In Locksmith, open Help and select Remove Locksmith. This takes its code out of your theme.
- In a private window, unlock a locked product and go through checkout.
- 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
- In Shopify, go to Online Store > Themes. Duplicate your live theme, so you can go back.
- On the duplicate, select Edit code.
- 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 uselocksmith-lean:. - Replace each
locksmith_<id>_forloop__<name>withforloop.<name>. For example,locksmith_1a2b_forloop__indexbecomesforloop.index. - Delete the block that starts with the comment "Code added automatically by the Locksmith app".
- Delete the snippets whose names start with
locksmith. - 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.