If you are already using a zip code validator on your store and wish to using it on Online Store 2.0 compatible theme, there are series of steps you need to follow based on your current setup.


Before you migrate, please make sure your theme supports app embeds. You can follow this tutorial to lean how to verify that. : Click here


Use case 1: Currently you are using a pop-up to validate customers.


Step 1: Customize your theme to enable pop-up app embed widget.


Navigate to Online store > Themes > Customize > Theme Settings > App Embeds > Enable Zip Code Validator > Save



You should immediately see a zip code validator pop-up appearing in preview section.


Step 2: Disable dynamic script embed


This step would basically disable old way of rendering pop-ups which Online store 2.0 doesn't require. If at any step you wish to switch back to previous theme, you will need to undo this step.


Navigate to our zip code check app > Global Settings > Scroll down to "Dynamic script embed" section > Click "Deactivate".



Now navigate to your store and you should see a pop-up as you used to see earlier. Only different is, you've moved to using Online Store 2.0 embed feature.


If you fail to see a pop-up, you can follow Step 2 again to "Activate: dynamic script embed". Then please contact our support and we are more than happy to take a look for you.


Use case 2 : Currently you are using a section to validate customers


Step 1: Customize your theme to insert app embed block.


Navigate to Online store > Themes > Customize >


Once you are on customize page, follow these steps.


1. Select a page where you would like to add this section.

2. Click on "Add Block" from left side panel.

3. Choose "Zip code check widget" from available apps list & save settings.



Step 2: Verify widget


Upon selection, you should immediately see a widget appearing in your theme preview. You can drag and move it to appropriate area based on your requirements.



Step 3: Disable dynamic script embed


This step would basically disable old way of rendering pop-ups which Online store 2.0 doesn't require. If at any step you wish to switch back to previous theme, you will need to undo this step.


Navigate to our zip code check app > Global Settings > Scroll down to "Dynamic script embed" section > Click "Deactivate".



Now navigate to your store and you should see a pop-up as you used to see earlier. Only different is, you've moved to using Online Store 2.0 embed feature.


If you fail to see a pop-up, you can follow Step 2 again to "Activate: dynamic script embed". Then please contact our support and we are more than happy to take a look for you.


Step 4: Follow this only if you are showing warning pop-up on cart page.


Tutorial to follow: https://avocadoslab.freshdesk.com/support/solutions/articles/63000266904