Taxonomy

ACF

Last Upated: Thursday, Feb 1, 2024

taxonomy

The Taxonomy field is a field native to ACF (free) that allows the selection of one or more taxonomy terms.

Resolve Type

Fields of the taxonomy field type resolve to a "AcfTermNodeConnection" in the GraphQL Schema. This supports singular and multiple selections, as a connection can return either one, or more than one values.

Field Settings

Below you will find information about how various ACF field settings can impact how the field will map to the GraphQL Schema and/or modify resolution of the field when queried.

Field Configuration

<?php
add_action( 'acf/include_fields', function() {
  if ( ! function_exists( 'acf_add_local_field_group' ) ) {
      return;
  }
  acf_add_local_field_group(
    [
      {
        "key": "my_field_group_",
        "title": "My Field Group with taxonomy",
        "show_in_graphql": 1,
        "graphql_field_name": "myFieldGroupWithTaxonomy",
        "map_graphql_types_from_location_rules": 0,
        "graphql_types": [
          "Page"
        ],
        "fields": [
          {
            "key": "my_field_",
            "label": "My Field",
            "name": "my_field",
            "type": "taxonomy",
            "show_in_graphql": 1,
            "graphql_field_name": "myFieldWithTaxonomy"
          }
        ],
        "location": [
          [
            {
              "param": "post_type",
              "operator": "==",
              "value": "page"
            }
          ]
        ]
      }
    ]
  );
});

Taxonomy

Resolve Type

Field Settings

Field Configuration

Querying the Taxonomy Field field