Why do I not see my existing collections in the Add Existing Collections list?

Created on 12/28/16

The collections are most likely created as custom collections. The Categories by BTP application currently only works with smart collections. A new smart collection would need to be created per custom collection and the products added via tags. An easy way to accomplish this is to obtain the original custom collection id from the URL bar of the edit page:

Go to the products page and append “?collection_id=<id>” with the id number.

Here you will see all of the products in the custom collection and you may select all and add the tags in bulk for them to appear on the new smart collection.

How do I revert the tree (or any other categories related snippet) to a previous version?

Created on 01/05/17

This is a problem you may run into while using the application. Let’s say we released an update to our tree snippet which you installed through the Install/Update/Repair Status tab within the application, however it wasn’t to your liking and you would like to revert it back to the previous version. The best way to handle this would be to edit your theme in Shopify and locate the appropriate snippet (btp-categories-tree.liquid in this case), and click on the “Older versions” link across the top:

Here you will be able to select any of the previous versions that have been saved by Shopify via the dropdown:

Here’s a list of possible situations that you may need to do this and the related snippets:

What does the “Generate Product Tags” setting do and how do I use it?

Created on 01/13/2017

When the Generate Product Tags option is selected within your Settings tab, saving your categories will cause two tags to be added to the list of rules for your smart collections. These two tags are formatted like so: btp_main_<id> and btp_other_<id> where <id> is the ID of the collection itself. Since we are adding two tags here, we will also need to change the match condition to any. If you are using existing smart collections that have multiple conditions already set and are configured to match all, this may have unexpected results as it will now include any of the conditions. In these situations we recommend creating a new smart collection altogether to replace the existing one. You may follow the instructions in the previous FAQ question (Why do I not see my existing collections in the Add Existing Collections list?) to find all of the products in your existing collection that you will be replacing and bulk-add the tags we generated for your new collection:

The difference between the two tags we generate is only noticeable when using the product breadcrumbs snippet. When a product tagged with this application’s generated tags is visited, the product breadcrumbs snippet will automatically show breadcrumbs back to the btp_main_<id> collection that the product belongs to. As such, you should limit one main tag per product. The btp_other_<id> tag should be used when you want the product to appear in a different collection than the one it actually belongs in (e.g. when you’re featuring the product in another collection or if you want the product to also appear in the parent collections. For more details, please see our Product Tagging FAQ.

What does the “Update Handle to Match Hierarchy” setting do?

Created on 01/13/2017

When this option is checked within your Settings tab, saving your categories will cause the handle for your collections to change to include their parents handles. For example, suppose we have the following structure:

Before saving these categories with this option, the handles for these three collections are inventory, computers, and desktops respectively. Upon saving, the handles will be updated as follows:

Old Handle

New Handle

inventory

inventory

computers

inventory-computers

desktops

inventory-computers-desktops

This will make your categories more SEO friendly by allowing the handle therefore the URL for the collections to match the hierarchy. We will also automatically add redirects to any collection whose handles get updated to make sure the old handles are not dead.

What does the “Update Collections’ Titles to Match Hierarchy” setting do?

Created on 01/13/2017

When this option is checked within your Settings tab, your subcollections will be renamed to include the names of their parents, separated by the Title Delimiter. For example, the previously mentioned collections:

Will be renamed as follows:

This will also help improve your collections’ SEO by matching the titles to the hierarchy. The default delimiter used is “ > “ but you may change it to whatever you like. There is a button that you have access to as well when this option is checked and in effect, called Clean Titles. This allows you to clean the titles of all your collections, removing the names of the parents and in effect reversing the process. We recommend you run this routine if you have already saved your categories with this option checked and are wanting to change the delimiter.