ACPT v2
  • General
    • Minimum requirements
    • Download the plugin
    • Install ACPT
    • Install ACPT with Composer
    • Managing your license
    • Migrating from v1
      • Fix data loss after migration from V1
    • Settings
    • Translations
    • How to open a ticket
  • Basics
    • Custom post types
    • Taxonomies
    • Post type-Taxonomy association
    • Option pages
  • Meta fields
    • Field groups
    • The meta fields manager
      • Group settings
      • Basics
      • Advanced options
      • Conditional rendering
      • Validation rules
    • Field types
      • Address field
      • Audio field
      • Audio multiple field
      • Color field
      • Country field
      • Currency field
      • Date field
      • Datetime field
      • Date range field
      • Editor field
      • Email field
      • Embed field
      • File field
      • Gallery field
      • HTML field
      • Icon field
      • Image field
      • Length field
      • List field
      • Number field
      • Password field
      • Phone field
      • QR Code field
      • Select, checkbox, and radio
      • Rating field
      • Repeater field
      • Relational field
      • Range field
      • Table field
      • Textarea field
      • Text field
      • Time field
      • Toggle field
      • URL field
      • Video field
      • Weight field
  • Permissions manager
    • Custom post types permissions
    • Taxonomies permissions
    • Option pages permissions
    • Meta fields permissions
  • Tools
    • Custom APIs
    • Health check
    • Datasets
    • Export data
    • Import data
  • Forms
    • Manage forms
    • The form builder
    • Examples of form usage
      • Create a new post type
      • Modify an existing post type
      • Create a new term
      • Modify an existing term
      • Create a new user
      • Modify an existing user
    • Form submissions log
  • Dynamic blocks
    • Create your first block
  • Developers
    • Functions
      • register_acpt_post_type
      • delete_acpt_post_type
      • register_acpt_taxonomy
      • delete_acpt_taxonomy
      • assoc_acpt_taxonomy_to_acpt_post
      • remove_assoc_acpt_taxonomy_from_acpt_post
      • register_acpt_option_page
      • delete_acpt_option_page
      • save_acpt_form
      • delete_acpt_form
      • save_acpt_form_field
      • delete_acpt_form_field
      • get_acpt_form_object
      • get_acpt_form_field_object
      • save_acpt_meta_group
      • delete_acpt_meta_group
      • get_acpt_meta_group_objects
      • get_acpt_meta_group_object
      • save_acpt_meta_box
      • delete_acpt_meta_box
      • get_acpt_box_object
      • save_acpt_meta_field
      • delete_acpt_meta_field
      • get_acpt_meta_field_objects
      • get_acpt_meta_field_object
      • save_acpt_meta_field_value
      • delete_acpt_meta_field_value
      • get_acpt_fields
      • acpt_field_has_rows
      • acpt_field_has_blocks
      • get_acpt_field
      • get_acpt_child_field
      • get_acpt_block
      • get_acpt_block_child_field
      • acpt_field
      • is_acpt_field_visible
    • Shortcodes
  • Integrations
    • API Rest field integration
    • Breakdance
      • Build a real estate website
      • Working with nestable fields
    • Bricks builder
      • Build a real estate website
      • Working with nestable fields
      • Working with Slider (Nestable) and Gallery field
      • Working with relational fields inside query loops
      • Additional options
      • Working with text links
    • Divi
    • Elementor
      • Basic field blocks
      • Nestable field blocks
      • Dynamic tags
    • Gutenberg
      • Basic fields block
      • Relational fields block
      • Repeater fields block
      • Working with FSE
    • Oxygen builder
    • Rank Math
    • SEOPress
    • Slim SEO
    • WooCommerce
    • WP All Import/Export
    • WP Grid Builder
    • WPGraphQL
    • WPML
    • Yoast
    • Zion builder
Powered by GitBook
On this page
  • Manage taxonomies
  • Register a new taxonomy
  • Reserved Terms
  • Update an existent taxonomy
  • View a registered taxonomy
  • Delete a taxonomy
  1. Basics

Taxonomies

Manage taxonomies

PreviousCustom post typesNextPost type-Taxonomy association

Last updated 1 year ago

Manage taxonomies

The main taxonomy dashboard looks like this:

From the main dashboard you can run these operations:

  • Create new taxonomy

  • Update an existent taxonomy

  • View a registered taxonomy

  • Delete a registered taxonomy

Once you install ACPT or ACPT Lite plugin, a sync process with already registered taxonomies is performed automatically.

Please note that ACPT imports category and post_tag taxonomies labeled as "Native".

Register a new taxonomy

From the main dashboard click on the "Register new Taxonomy" button to create a new taxonomy:

The creation of a new taxonomy is a three steps process:

  • STEP 1: Basic

  • STEP 2: Labels

  • STEP 3: Settings

Basic (Minimum configuration)

This is the most important step. Define here:

  • Slug: The post name/slug. Used for various queries for taxonomy content. ACPT automatically escapes the slug for you.

  • Singular label: Used only in the admin panel when a singular label is needed

  • Plural label: Used only in the admin panel for the post type admin menu item

Labels (Additional labels)

Here you can find the labels used only in the admin panel for ordinary Wordpress operations.

The default settings are good in most situations, but feel free to change what you want.

Settings (Other settings)

Other important taxonomy settings.

Don't touch the default settings if you don't know what you doing :)

Once you complete the three steps you'll be able to associate the new taxonomy to a post type.

Reserved Terms

For this reason, ACPT will not allow you to use any of those reserved terms:

Update an existent taxonomy

You have two ways to update a taxonomy:

  • by clicking the Edit link in the taxonomy dashboard

  • by clicking the Edit link in the View mode (it takes you directly to the selected step)

The update process is pretty identical to the creation one. The only remarkable difference is that in the update process, you can't modify the post slug.

View a registered taxonomy

By clicking the View link in the dashboard you can view a taxonomy.

The View mode is divided into three tabs, like the 3-step creation process.

Delete a taxonomy

By clicking the Delete link in the dashboard you can delete a taxonomy.

It's very important to understand that this operation DOES NOT DELETE anything on the terms WordPress DB table, but only the ACPT settings. After deleting a taxonomy you will no longer display it in the admin panel, even if the taxonomy records are still present. If you try to re-create the same taxonomy you will see the old data.

Please note that you cannot delete Native taxonomy.

Please refer to the to get more info about registering new taxonomies.

According to WordPress documentation, avoiding the following is particularly important, because it can cause WordPress to respond with a 404 error without any other hint or explanation.

official WordPress documentation
reserved terms