Manage product tags

Use saved tags to group products for storefront discovery.

​

Choose the tag identity

Tags belong to a company. A tag’s source records its origin; it does not restrict which resource types can use that tag. Use the tag ID when selecting a filter or deleting a tag. Two tags with the same name remain separate when their IDs differ. Review the saved tag list before changing an existing tag.

​

Grant deletion access

Deleting a tag requires company-admin access and the tags.delete permission. Existing Admin, Partner Token, Droplet, and Company API Token roles receive the new grant automatically. Limited and custom roles require an explicit grant. An existing role named Developer is not automatically upgraded because that name can belong to a custom role. In the role editor, find Tags and enable Delete for the role that needs it. A role with tags.delete can list saved tags without also holding categories.view; this does not grant category access.

​

Delete with the assignments in mind

Deleting a saved tag removes its assignments across resource types. It preserves the tagged products and media, and it leaves same-name tags with other IDs unchanged. System-generated tags are protected from deletion. Review how your theme uses the tag before deleting it. A saved filter link that refers only to a deleted tag no longer matches products. Use the Delete a saved tag reference for authentication, request details, and responses. This API does not add a tag-deletion screen to Fluid Admin.

​

Connect tags to product filters

Selecting several tags matches products assigned to any selected tag. Other product filters narrow those matches further, and a product appears only once even when several selected tags match it. Tag filtering preserves the catalog’s company and visibility rules. A tag assignment does not make a hidden product public. For API integrations, use the tag filter documented in the Public Products catalog or the Company Products index. For Liquid themes, follow Build shop tag filters to render the available choices and preserve selected values.