This guide contains steps on how to implement the Route Protect asset on the checkout option(s) on your Shopify store. It includes steps to create a test theme, install the Route asset on the test theme, and ultimately, install the Route asset on the Live theme.
Prefer a video tutorial? Watch VIDEO: How to self-install Route package protection on your Shopify store.
For best results, use Google Chrome. If you don't have Google Chrome on your computer, install it here.
Need some help? Not to worry! All merchants have access to free, expert implementation from the Route team. You can use this form and our merchant support team will file a request on your behalf.
-
Log in to Shopify and click on Products.
- Search for Route and select it.
- On the Route Shipping Insurance page, click on Manage at the top right.
- Ensure Online Store is checked and click Done.
Note
Since Route is listed as a product, it may show up on your site as a product. To hide Route as a product on your site, follow these instructions.
Create a test theme
Creating a test store theme allows you to safely make changes and test the Route asset. Any changes made in the test theme will not affect the live theme on your store.
- In Shopify, click on Online Store > Themes on the left side of the page.
- On the live theme, click Actions > Duplicate.
- The duplicate theme will show as Copy of.... Click Actions > Rename and name it Route Test.
Install Route asset on test theme
For best results, use Google Chrome.
- On the test theme, click Actions > Preview.
- In the Preview, add an item to your cart to test the checkout.
- Note where all the checkout options are located on the website. The Route Asset should be placed above all checkout options that are on your website.
Checkout options are the sections on your site where customers can checkout and pay for their items. They are not pop-ups on your site that say View Cart.
Note
Repeat the steps below for each checkout option on the website
- To test the placement of the Route asset before going to the Shopify theme, right-click on the checkout button and click Inspect to show the code for that checkout line.
-
In the Inspect window, the line of code for the checkout button will be highlighted.
-
Right-click on highlighted the line of code, and click Edit as HTML.
- Above the line of code for the checkout button, press enter/return and insert the div code <div class="route-div"></div>.
This will show in the checkout where the Route asset will be placed, and it will not permanently change your checkout. - Once you place the code, click in the blank space to the left of the code.
- When you click into the blank space, the Route asset will appear. The Route asset should appear above the checkout option.
-
If the placement isn't above the checkout button, it's in the wrong location.
-
To fix the placement of the Route asset, first, find the Route div code <div class="route-div"></div> in the Inspect window. Right-click on it and click Delete element.
-
Then right-click the line above the line of code for the checkout button. Click Edit as HTML.
- Above the line of code, press enter/return and insert the div code <div class="route-div"></div>.
Note
If it still doesn't work, follow steps 11-13 again with another line of code above the line of code for the checkout button.
- If the placement is above the checkout button, take note of the lines of code around where you placed the Route div code or take a screenshot of where you placed the Route div code. You can go back to the note or screenshot when you add the Route asset to the Shopify theme!
Note: If the Route asset is appearing above the checkout but is aligned too far to the left or right, is not visible due to a dark background or has too much whitespace between other elements, read the Shopify Self-Install Troubleshooting FAQ. - Go back to the test theme in Shopify partners, click Actions > Edit code.
-
In the new page, click on the Sections folder.
-
In the sections folder, choose the theme file that has code for your checkout option. Depending on the type of checkout option, the file will likely show as:
- Main Cart Page
- This is a standard checkout option on the main cart page when customers check out. Common files that contain this code are:
- cart.liquid, cart-template.liquid
- Header Cart
- This checkout option appears at the top of the page under the cart icon on websites. Common files that contain this code are:
- header.liquid
- Modal Cart
- This checkout option appears in the middle of the screen when a customer adds an item to their cart. Common files that contain this code are:
- modal-cart.liquid, ajax-cart-template.liquid
- Drawer Cart
- This checkout option appears on the side of the screen when customers add an item to their cart or clicks on the cart icon. Common files that contain this code are:
- drawer-cart.liquid, ajax-cart-template.liquid
Note
The file name can vary. The file names are based on typical examples.
- Look at the note or screenshot you took to figure out where you need to place the Route div code. Then use the Ctrl and F buttons to search for keywords and find the lines of code where you placed the Route div code successfully.
-
Once you find the line of code to place the Route div code above, click on the line above it, press enter/return and insert the div code <div class="route-div"></div>.
- Click Save at the top right.
- Open the Preview in Google Chrome's incognito mode and test the checkout to see if the Route asset appears in the designated checkout location.
- Add an item to your cart and checkout. In the checkout, keep the Route asset checked and proceed to the payment page to see if Route appears.
- Go back to the checkout and de-select the Route asset and proceed to the payment page to ensure Route doesn't show.
- If the Route asset appears in the right spot and works correctly, repeat steps for any additional checkout options.
Once you've confirmed that the Route asset is showing and working correctly for all checkout options, go to the live theme in Shopify partners.
Install Route asset on live theme
To install the Route asset on your Live theme, follow the same steps as above:
- On the live theme, click Actions > Edit code.
- Choose the same theme file(s) from the test theme.
- In the file, search for the line of code that matches where you placed the code on the test theme.
-
Once you find the line of code to place the Route div code above, click on the line above it, press enter/return and insert the div code <div class="route-div"></div>.
- Click Save at the top right.
- Open the Preview in Google Chrome's incognito mode and test the checkout to see if the Route asset appears in the designated checkout location.
- Add an item to your cart and checkout. In the checkout, keep the Route asset checked and proceed to the payment page to see if Route appears.
- Go back to the checkout and de-select the Route asset and proceed to the payment page to ensure Route doesn't show.
Success
The Route asset is now live on your site!
Running into issues? Please feel free to reach out to our tech support via this form.