DOCS

Creating and managing taxonomies

Taxonomies are is a way of grouping and organizing content within your CPT making it easier for users to navigate a website.

Some taxonomies are included with WordPress such as Post Categories, and Post Tags.

Voxel lets you create additional taxonomies, which we refer as Custom Taxonomies

Custom Taxonomies can be created in two ways

  • WP Admin Structure Taxonomies Create taxonomy
  • WP Admin ➝ Structure ➝ Edit post type ➝ Fields ➝ Add a Taxonomy field
    When adding a taxonomy field to the CPT, you can choose an existing one or quickly create a new taxonomy

When creating a taxonomy, the following details have to be provided

  • Singular and plural name:
    These are used to reference terms of this taxonomy throughout the site
  • Key:
    Unique identifier
  • Post type:
    The post type(s) that this taxonomy is assigned to

Editing a taxonomy

To edit a taxonomy, you can go to WP Admin Structure Taxonomies and press “Edit taxonomy” button.

On the edit screen, you can view and update basic details

Basic details

  • Singular name
  • Plural name
  • Select the post types it is available for
  • View taxonomy key (key cannot be changed after creation)

Permalinks

  • Set permalink base for this taxonomy
    e.g http://yoursite.com/category/sample-term
  • Hierarchical: If enabled, ancestor term slugs will be prepended to the term permalink
    e.g http://yoursite.com/category/parent-term/sample-term

Advanced settings

  • Enable hierarchical structure: Hierarchical structure lets you arrange terms into parent-child groups.
  • Is this taxonomy publicly queryable: Enable if this taxonomy is important to your SEO structure. If enabled, you can design the Single term templates and the taxonomy appears in your sitemap
  • Show this taxonomy in admin quick edit form for posts: Make this taxonomy available for bulk-editing through the post list table in WP Admin
  • Show this taxonomy in REST API: Whether to include the taxonomy in the REST API. Set this to Yes for the taxonomy to be available in the block editor.
  • Display a column for this taxonomy in the admin post list table
  • Native archive query: If enabled, the native WordPress post query will run in the single term page if you use Post feed widget with source set to WP default archive.

Note: The value “Auto” instructs Voxel not to modify the original behavior for that setting.
For taxonomies registered manually (through the child theme or a 3rd-party plugin), “Auto” preserves the original configuration used during the registration of the taxonomy.

Adding terms

You can add terms to a taxonomy through WP Admin Your post type ➝ Your taxonomy

Default WordPress taxonomy term fields

  • Name
  • Slug
  • Parent
  • Description

Taxonomy term custom fields added by Voxel

  • Icon
  • Image
  • Area
  • Accent color

Reordering terms

Terms can be reordered in WP Admin Structure Taxonomies Press “Reorder terms” button

This order can be utilized by the Terms filter, as well as when displaying terms in your templates

Continue reading