百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
P

product-taxonomy

> 编程语言
开源

Shopify 的标准化产品分类。

330 stars0 点赞3 次浏览
访问官网GitHub

工具介绍

Shopify 的标准化产品分类。

Shopify's Standard Product Taxonomy

** Global Standard**: Our open-source, standardized product taxonomy establishes a universal language for product classification. Comprehensive and already empowering merchants on Shopify.

‍ Integration Friendly: With a stable structure and diverse formats our taxonomy is designed for effortless integration into any system.

** Industry Benchmark**: Spanning 25+ essential verticals, our taxonomy encompasses categories, attributes, and values, all thoughtfully integrated within Shopify and numerous marketplaces.

Learn more on help.shopify.com

️ Table of Contents

  • The Taxonomy
    • ️ Interactive explorer
  • Getting started
    • 1. Integrators: How to integrate with the taxonomy
      • ️ Mapping to other taxonomies
    • ‍ 2. Taxonomists: How to make changes to the taxonomy
    • ‍ 3. Developers: How to evolve the system
      • ️ Setup and dependencies
      • ⛰️ Common tasks
      • Navigating this repository
  • ‍ Contributing
  • Releases
  • License

The Taxonomy

Our taxonomy is an open-source comprehensive, global standard for product classification. It's a universal language that empowers merchants to categorize their products. Spanning 25+ essential verticals, our taxonomy encompasses categories, attributes, and values, all thoughtfully integrated within Shopify and numerous marketplaces.

️ Interactive explorer

Ready to dive in? Explore our taxonomy interactively to visualize and discover what's published across the many categories, attributes, and values.

Getting started

This repository is the home of Shopify's Standard Product Taxonomy. It houses the source-of-truth data, the distribution files for implementation, and the source code that makes this all sing.

You can think of this repository serving 3 primary users:

  1. Integrators: Those who integrate the taxonomy into other systems. You want stable distribution files.
  2. Taxonomists: Those who want to evolve the taxonomy itself. Submit a change request or work directly with the source-of-truth data files themselves.
  3. Developers: Those who want to evolve how this ETL pipeline works, or add richer tooling for other users. You work with the application files.

1. Integrators: How to integrate with the taxonomy

Distribution files are published as gzip-compressed assets on GitHub releases:

  • Stable (recommended): https://github.com/Shopify/product-taxonomy/releases/latest/download/, or pin a version with releases/download/v/.
  • Unstable (tracks main): https://github.com/Shopify/product-taxonomy/releases/download/unstable/.

Assets are named ...gz, with nested paths flattened using dots (categories.en.json.gz, integrations.all_mappings.en.json.gz). Decompress after downloading:

bash
curl -L https://github.com/Shopify/product-taxonomy/releases/latest/download/categories.en.json.gz | gunzip > categories.json

[!IMPORTANT] The committed dist/ directory is deprecated and will be removed on October 31, 2026. Migrate to the release-asset URLs above before then.

We offer txt and json formats to make it easy to integrate with your systems. If you have a specific format you'd like to see, please open an issue and let us know!

️ Mapping to other taxonomies

To make it easier to integrate with the taxonomy, we have also included a set of data called mappings. These are rules that can be used to convert between categories and attributes in the Shopify taxonomy to categories and attributes of another taxonomy. For more on mappings see documentaton in the integrations directory.

‍ 2. Taxonomists: How to make changes to the taxonomy

Submit a taxonomy tree change request to give us insight and evolve the taxonomy. This is the simplest way to effect change.

Alternatively, you may submit PRs directly yourself against the source-of-truth files in data/.

If you make changes to any files in data/, you'll need to update the distribution files by running:

bash
cd dev
bundle install
bin/product_taxonomy dist

Localization to other languages

Our taxonomy supports translations to various languages in the localizations directory. To report a translation issue (non-English text), submit a localization fix request.

‍ 3. Developers: How to evolve the system

Everything else is how we manage the taxonomy and generate distributions. This is where the magic happens.

In the dev/ subfolder is a simple ETL app composed of a few core models. Jekyll is used to serve the documentation locally and on GitHub pages.

️ Setup and dependencies

  • Install ruby, version matching dev/.ruby-version
  • Install cue, version 0.7.x or higher
  • Run cd dev && bundle install

⛰️ Common tasks

Here are the commands you'll use most often:

…

Navigating this repository

…

‍ Contributing

We welcome contributions! Before we can merge any changes you submit via PR, you'll need to sign the Shopify CLA (a friendly robot will help when you open your first PR ).

Releases

You can always find the current published version in VERSION. The changelog is available in CHANGELOG.md.

Versions are determined by CalVer, in sync with Shopify's API release schedule.

That means a stable release every 3 months at most, at the beginning of the quarter. Version names are date-based to be meaningful and semantically unambiguous (for example, 2024-07).

Formal releases are published as Github releases and available on the interactive docs site.

License

Shopify's Product Taxonomy is released under the MIT License. So go ahead, explore, play, and build something awesome!

Issues· 0 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

Ruby

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月18日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言