Skip to Content

ProductTaxonomy

Describes a product taxonomy, providing structured categorization and associated attributes for a product.

Type Definition

type ProductTaxonomy { category: ProductTaxonomyCategory attributes: [ProductTaxonomyAttribute] }

Fields

FieldTypeNullableDescriptionRelationship
categoryProductTaxonomyCategoryYesReturns the category.Links to the product’s category
attributes[ProductTaxonomyAttribute]YesReturns the attributes.List of taxonomy attributes

Relationships

  • category: Connects the product taxonomy to a single ProductTaxonomyCategory object, representing the category classification of the product.
  • attributes: Connects to a list of ProductTaxonomyAttribute objects, representing various attributes associated with the taxonomy.

Usage Examples

Basic Query

query { product(id: 12345) { taxonomy { category { id name } attributes { id name value } } } }

Field Selection

query { product(id: 12345) { taxonomy { category { name } attributes { name } } } }

Nested Queries

query { product(id: 12345) { taxonomy { category { id name description } attributes { id name value description } } } }

Filtering and Sorting

Note: The ProductTaxonomy type itself does not define filtering, sorting, or pagination fields. Filtering and sorting should be applied at the query level on the parent objects or lists that include ProductTaxonomy.

Implements

This type does not implement any interfaces.

Connections

No direct connections are defined on ProductTaxonomy. It is typically accessed as a nested object within a Product.

  • ProductTaxonomyCategory: Represents the category classification linked via the category field.
  • ProductTaxonomyAttribute: Represents attributes linked via the attributes field.

Best Practices

  • Query only the fields you need within category and attributes to optimize response size.
  • When querying multiple products, consider batching requests or using pagination on the product list to manage performance.
  • Use nested queries to access detailed category and attribute information in a single request.

Notes

  • The API currently requires no authentication; however, this may change in future versions.
  • category and attributes fields are optional and may return null if no taxonomy data is available for a product.
  • Since attributes is a list, be mindful of potentially large datasets when querying all attributes.
  • No computed or derived fields are defined on ProductTaxonomy.
  • No field arguments are defined on this type.
Last updated on