Taxonomies and Taxons

Taxonomies are the Spree system’s approach to category trees. The heading of a tree is called a Taxonomy. Any child branches are called Taxons. Taxons themselves can have their own branches, meaning you could have something like the following categories structure:
Taxonomy Tree
In this example, “Categories” is the name of the Taxonomy. It has three child branches: “Luggage”, “Housewares”, and “Clothing”. The last two branches each have three of their own child branches. Thus, “Clothing” is a child taxon to “Categories” and a parent taxon to “Men’s”.
To reach the Taxonomies list, first go to your Admin Interface, then click “Configurations” and “Taxonomies”.
To create a new taxonomy, click the “New Taxonomy” button. Enter a name for the taxonomy and click “Create”.
New Taxonomy
You can then add child taxons to your new taxonomy.
To edit an existing taxonomy, click the “Edit” icon next to the name in the Taxonomies list.
Edit Taxonomy Icon
Here, you can change the name of the Taxonomy. You can also reorder the child taxons, delete a taxon, add a new taxon, or edit a taxon. Make your changes, then click the Update button.
Edit Taxonomy
Delete Taxonomy Icon
To delete a taxonomy, click the “Delete” icon next to the name in the Taxonomies list. Click “OK” to confirm.
Once you have created a taxonomy, you may want to add child taxons to it. To do this, right-click the name of the Taxonomy, and click “Add”.
Add Taxon to Taxonomy
Add Taxon to Taxonomy
This will cause a new input field to open up, with “New node” in it. Replace this text with the name of your new taxon, and hit Enter. You’ll now see the child tax in the taxonomy tree.
New Taxon
Click “Update” to save your addition.
If your site needs sub-trees, just add taxons to other taxons. To do so, right-click the name of what will become the parent taxon and then click “Add”.
Add Taxon to Another Taxon
Enter the name of the child taxon and click enter. Repeat this process for any sub-trees you need.
Complex Taxonomy Tree
Remember to save your changes by clicking the “Update” button after you have added any taxons.
When you navigate away from your taxonomy's page, then navigate back to it, sub-trees will be collapsed by default. To see child taxons, just click the arrow next to the parent taxon.
Taxons are displayed, by default, in the order in which you add them. To reorder them, just drag and drop them to their correct location in the tree.
Let’s assume, for example, that we want the “Children’s” taxon to be listed first, above “Women’s” and “Men’s”. Just drag and drop the taxon to its new location.
Reordering Taxons
You can even drag a parent taxon into the tree of a different parent taxon, merging it into the second taxon’s sub-tree.
Parent-to-Parent Taxon Merge
To edit a taxon’s name, just right-click it and select “Edit”.
Edit Taxon Form
Here, you can edit several aspects of the taxon:
  • Name - A required field for all taxons. The name determines what the user will see when they look at this product in your store.
  • Permalink - The end of the URL a user visits in order to see all products associated with this taxon. This field is also required, and a value is automatically generated for you when you create the taxon. Be careful with arbitrarily changing the permalink; if you have two taxons with the same permalink you will run into issues.
  • Description - A short text describing the category that will be visible above the header banner.
  • Hide from subcategories navigation checkbox - Checking this checkbox will make the category invisible in the Subcategories navigation in the Products listing page.Hide From Subcategories
  • Header Banner - This option lets you upload a header image for the desired category
  • Meta Title - Overrides the store’s setting for page title when a user visits the taxon’s page on the front end of the website.
  • Meta Description - Overrides the store’s setting for meta description when a user visits the taxon’s page on the frontend of the website.
  • Meta Keywords - Overrides the store’s setting for meta keywords when a user visits the taxon’s page on the frontend of the website.
  • Description - This option is currently not functional.
Hide From Subcategories
Remember to click “Update” after you make your changes.
To delete a taxon, right-click it in the taxonomy tree and click “Remove”.
Remove a Taxon
Press “OK” to confirm.
To associate a product with one or more taxons, go to the Admin Interface, and click the “Products” tab. Locate the product you want to edit and click its “Edit” icon. Select the taxons for the product in the Taxons field.
Add Taxons to a Product