Custom Tags

📣 Note: Read more in guide Working with Custom Tags.

These are examples of queries to fetch custom tag taxonomy data.

Taxonomies unmapped to the schema permalink

Retrieve tags with taxonomy "product-tag":

query {
  tags(taxonomy: "product-tag") {
    __typename

    ...on Tag {
      count
      description
      id
      name
      slug
      url
    }
    
    ...on GenericTag {
      taxonomy   
      customPostCount
      customPosts {
        __typename
        ...on CustomPost {
          id
          title
        }
      }
    }
  }
}

Retrieving tags associated to a custom post permalink

Type GenericCustomPost has field tags, to retrieve the custom tags added to the custom post:

query {
  customPosts(
    filter: { customPostTypes: "product" }
  ) {
    __typename

    ... on GenericCustomPost {
      tags(taxonomy: "product-tag") {
        __typename
        id
        name
        taxonomy
      }
    }
  }
}

Filtering custom posts by tag permalink

To retrieve the custom posts with a given tag or tags, we can use inputs filter.tagIDs or filter.tagSlugs and filter.tagTaxonomy:

query {
  customPostsByTagIDs: customPosts(
    filter: {
      tagIDs: [26, 28],
      tagTaxonomy: "product-tag"
    }
  ) {
    id
    title
  }

  customPostsByTagSlugs: customPosts(
    filter: {
      tagSlugs: ["tango", "rock"],
      tagTaxonomy: "product-tag"
    }
  ) {
    id
    title
  }
}