listTags - Product Module Reference

Beta

This documentation provides a reference to the listTags method. This belongs to the Product Module.

This method is used to retrieve a paginated list of tags based on optional filters and configuration.

Example

To retrieve a list of product tags using their IDs:

import {
  initialize as initializeProductModule,
} from "@medusajs/product"

async function retrieveProductTag (tagIds: string[]) {
  const productModule = await initializeProductModule()

  const productTags = await productModule.listTags({
    id: tagIds
  })

  // do something with the product tags or return them
}

To specify relations that should be retrieved within the product tags:

import {
  initialize as initializeProductModule,
} from "@medusajs/product"

async function retrieveProductTag (tagIds: string[]) {
  const productModule = await initializeProductModule()

  const productTags = await productModule.listTags({
    id: tagIds
  }, {
    relations: ["products"]
  })

  // do something with the product tags or return them
}

By default, only the first 15 records are retrieved. You can control pagination by specifying the skip and take properties of the config parameter:

import {
  initialize as initializeProductModule,
} from "@medusajs/product"

async function retrieveProductTag (tagIds: string[], skip: number, take: number) {
  const productModule = await initializeProductModule()

  const productTags = await productModule.listTags({
    id: tagIds
  }, {
    relations: ["products"],
    skip,
    take
  })

  // do something with the product tags or return them
}

You can also use the $and or $or properties of the filter parameter to use and/or conditions in your filters. For example:

import {
  initialize as initializeProductModule,
} from "@medusajs/product"

async function retrieveProductTag (tagIds: string[], value: string, skip: number, take: number) {
  const productModule = await initializeProductModule()

  const productTags = await productModule.listTags({
    $and: [
      {
        id: tagIds
      },
      {
        value
      }
    ]
  }, {
    relations: ["products"],
    skip,
    take
  })

  // do something with the product tags or return them
}

Parameters

filtersFilterableProductTagProps

The filters applied on the retrieved product tags.

configFindConfig<ProductTagDTO>

The configurations determining how the product tags are retrieved. Its properties, such as select or relations, accept the attributes or relations associated with a product tag.

sharedContextContext

A context used to share resources, such as transaction manager, between the application and the module.

Returns

PromisePromise<ProductTagDTO[]>Required

The list of product tags.