CHANGELOG.md

2025-01 (unstable)

📚 Taxonomy Updates

Expanded taxonomy with new categories, attributes and values, along with relocated categories for better product discoverability.

Apparel & Accessories

• Relocates Uniforms and its subcategories into Uniforms & Workwear.
• Relocates Scrubs from Business & Industrial into Uniforms & Workwear.

Arts & Entertainment

• Adds Perfume Making Kits with the attribute Perfumery instruments included.
• Adds an Olfactory Arts Materials area, including Candle Making Materials and Perfumery Ingredients (Bases and Fragrance Ingredients, with the attributes Olfactory family and Ingredient pathway).
• Relocates Raw Candle Wax, Wick Tabs and Wicks with their subcategories into Candle Making Materials; replaces Pre-Tabbed Wick Tabs with Pre-Tabbed Wicks.
• Adds Olfactory Arts Tools (Candle Making Tools, Incense Making Tools and Perfume Making Tools).
• Adds Banjos (4-String, 5-String and 6-String).
• Adds Mandolins (A-Style, F-Style and Electric) with the attribute Mandolin back shape.
• Adds Ukeleles (Baritone, Bass, Concert, Electric, Pocket, Soprano and Tenor).

Baby & Toddler

• Relocates Baby Bottle Nipples & Liners and Baby Bottles with their subcategories, along with Bibs and Sippy Cups, into Feeding Essentials.

Furniture

• Adds Closet Parts & Accessories, and relocates into this area Closet Baskets, Closet Bins, Closet Doors, Closet Drawers, Closet Rods and Closet Shelves.

Health & Beauty

• Adds a Weight Loss area, including Weight Loss Detox & Cleanse Products, Weight Loss Meal Replacements and Weight Loss Supplements.
• In the Medical Tests area, adds COVID-19 Tests, Flu Tests and Helicobacter Pylori Test Kits.
• Adds Hand Creams and Feminine Intimate Wash.
• Renames Makeup color/shade as Makeup shade and Hair color/shade as Hair color.

Home & Garden

• Adds Outdoor Kitchens.

Services

• Adds an Environmental Services area, including Waste Management Services.
• Adds Tax Services.

Software

• Adds the attribute Video game format in the Video Game Software area.

Sporting Goods

• Adds Racing Canoes and relocates Marathon Canoes and Sprint Canoes into this area.
• Adds Racing Kayaks.
• Adds Boating & Water Sport Protective Gear, including Boating & Water Sport Eye Protection; relocates Water Sport Helmets into this area.
• Adds a Windfoiling area, including Boards, Foils, Parts (Foil Fuselages, Foil Masts and Foil Stabilizers), Sails and Accessories (Carry Bags & Covers and Protective Gear).
• Adds a Wingfoiling area, including Boards, Foils, Parts (Foil Fuselages, Foil Masts, Foil Stabilizers and Wing Parts), Wings and Accessories (Carry Bags & Covers and Protective Gear).
• Adds Archery Accessories and relocates Archery Armguards, Archery Gloves & Releases, Archery Range Accessories, Archery Targets and Quivers into this area.
• In the E-Scooters area, adds Commuter E-Scooters, Off-Road E-Scooters, Performance E-Scooters and Youth E-Scooters.
• Adds an E-Scooters Parts area, including Batteries & Chargers, Braking Systems, Electric Motors, Electrical Components, Frames & Body Parts, Handlebars & Controls and Wheels & Tires, with the attributes Scooter brake type and Electric scooter motor type.

Vehicles & Parts

• In the Motor Vehicle Braking area, adds Back Plates, Brake Drums, Brake Hoses, Brake Light Switches, Brake Shoes and Wheel Cylinders.
• Adds a Motor Vehicle Cooling Systems area, including Expansion Tank Caps, Expansion Tanks, Fan Shrouds, Hose Fittings, Radiator Caps, Radiator Fans, Radiator Hoses, Radiator Overflow Tanks, Radiator Panels, Radiators, Thermostats, Water Necks and Water Pumps.
• In the Motor Vehicle Engine Parts area, adds Distributor Parts, Distributors, Glow Plugs, Ignition Coils and Ignition Leads.
• In the Motor Vehicle Frame & Body Parts area, adds Door Handles, Door Seals, Fuel Doors, Gas Struts and Side Panels.
• In the Motor Vehicle Power & Electrical Systems area, adds Alternator Parts and Ignition Switches.
• In the Motor Vehicle Sensors & Gauges area, adds Air Intake Temperature Sensors, Coolant Temperature Sensors, Knock Sensors, Manifold Absolute Pressure (MAP) Sensors, Mass Air Flow (MAF) Sensors, Parking Sensors and Rain Sensors.
• In the Motor Vehicle Transmission & Drivetrain Parts area, adds CV Boots, CV Joints, Clutch Discs, Clutch Lines, Clutch Master Cylinders, Clutch Pressure Plates, Clutch Release Bearings, Clutch Slave Cylinders, Flywheels, Propshafts and Transmission Filters.
• In the Motor Vehicle Window Parts & Accessories area, adds Window Glass, Window Regulators, Window Seals and Windshield Wiper Systems & Components (Wiper Systems, Arms, Blades and Motors).
• Adds an Aircraft Protective Gear area, including Aircraft Anti-G Suits, Aircraft Emergency Oxygen Systems, Aircraft Emergency Parachutes, Aircraft Fire Suppression Gear, Aircraft Safety Flight Suits, Airline Life Vests and Pilot Helmets.
• Adds an Off-Road & Motor Sports Vehicle Protective Gear area, including Racing Balaclavas, Chest Guards, Gloves, Googles, Helmets, Impact Guards, Neck Supports, Protective Shorts and Racing Suits, along with ATV & UTV Body Armor, Boots, Gloves, Googles and Helmets.
• Relocates Off-Road & All-Terrain Vehicle Protective Gear and its subcategory under Off-Road & Motor Sports Vehicle Protective Gear.
• Adds a Watercraft Safety Equipment area, including Distress Beacons and EPIRBs, Emergency Marine Flares, Life Rafts, Lifebuoys, Man Overboard Systems and Throw Ropes.
• In the Aircraft area, adds:
  • Heavier-Than-Air Aircraft (Autogyros, Drones, Gliders, Helicopters, Large Jets, Light Aircraft, Light Jets, Long Range Jets, Mid-Size Jets, Super Mid-Size Jets, Ultralights and Very Light Jets) with the attributes Aircraft engine type, Aircraft engine configuration, Cockpit type and Drone features; and
  • Lighter-Than-Air Aircraft (Airships & Dirigibles and Hot Air Balloons).
• In the Motor Vehicles area, adds:
  • Commercial Vehicles, including Taxis and Buses (Articulated, City Buses, Coaches, Double Decker, Minibuses, School Buses and Trolleybuses, with the attribute Vehicle floor configuration);
  • Motor Sports Vehicles, including Race Cars (Drag Racing, Drift Cars, Formula Cars, GT Cars, Rally Cars, Sports Prototypes, Stock Cars and Touring Cars), Racing Karts, Racing Motorcycles (Enduro Bikes, Motocross Bikes, Speedway Bikes and Trials Bikes), Racing Sidecars and Racing Trucks; and
  • Service & Utility Vehicles, including Emergency Vehicles (Ambulances, Fire Trucks and Police Vehicles with subcategories Police Cars, Police Trucks and Police Vans) and Military Vehicles.
• In the Cars, Trucks & Vans area, adds:
  • Hybrid Vehicles (Hybrid Cars, Hybrid Trucks and Hybrid Vans); and
  • Vintage & Classic Vehicles (Vintage & Classic Cars, Vintage & Classic Trucks and Vintage & Classic Vans) with the attributes Antique car era and Antique car design.
• In the Off-Road and All-Terrain Vehicles area, adds Monster Trucks.

Miscellaneous

• Introduces Bundles as a new overarching category.
• Extends existing attributes to additional categories.
• Includes other value additions.

2024-10

📚 Taxonomy Updates

Expanded taxonomy with new categories, attributes and values to enhance coverage and categorization accuracy, informed by user feedback and market insights.

Apparel & Accessories

• Adds Leotards & Unitards, Fashion Face Masks and Hair Bands.

Arts & Entertainment

• Adds Comic Books with the attributes Comic tradition and Comic edition in the Collectibles area.
• Adds Guitar Pedals.
• Adds Clothing Sewing Materials.
• Adds the attribute Mesh type in the Fabrics area.

Baby & Toddler

• Adds Feeding Essentials (Feeding Bowls, Plates, Spoons and Flatware Sets).

Business & Industrial

• Adds Raw Structural Components in the Construction area.
• Adds Heavy Machinery Parts & Accessories.

Electronics

• Adds Gaming Computers.
• Adds the attribute Microphone design in the Microphones category.

Food, Beverages & Tobacco

• Adds the attributes Grind size and Caffeine content in the Coffee area.
• Adds the attribute Chocolate type in the Chocolate category.

Hardware

• Adds Micrometers and Micrometer Accessories.
• Adds the attribute Micrometer type in the Micrometers category.

Health & Beauty

• Adds Medical Face Masks.

Home & Garden

• Adds Paintings with the attributes Art medium, Art movement and Artwork authenticity in the Visual Artwork area.
• Adds Diffusers (Electric, Plug-In, Ultrasonic, Reed Diffusers) and Reed Diffuser Sticks.
• Adds Air Fryers with the attributes Cooking compartment and Air fryer functions.
• Adds Food Processors.
• Adds Champagne, Cocktail and Wine Glasses with the attribute Drinkware shape in the Stemware area.
• Adds a Hydroponics area, including:
  • Growing Media (Clay Pebbles, Coconut Coir, Perlite, Rockwool and Vermiculite) with the attributes pH level and Plant stage;
  • Grow Lights (Fluorescent, HID and LED);
  • Hydroponic Systems (Aeroponics, Aquaponics, DWC, Drip Systems, Ebb & Flow and NFT); and
  • Nutrients & Supplements (Nutrient Solutions, pH Adjusters and Supplements).
• Adds Irrigation Systems.
• Adds Head Towels and Hand Towels.

Luggage & Bags

• Adds Hiking Backpacks, Military Backpacks, Laptop Backpacks and Laptop Bags.

Sporting Goods

• Adds American Football Shoes, Basketball Shoes, Cricket Shoes, Dancing Shoes (with the attribute Dance style), Field Hockey & Lacrosse Shoes, Racquetball & Squash Shoes, Rugby Shoes, Soccer Shoes, Tennis Shoes, Cycling Shoes, Golf Shoes, Badminton Shoes and Climbing Shoes.
• Adds Camping Hammocks and Camping Hammock Accessories.
• In the Archery area, adds Arrow Shafts, Arrow Rests, Bow & Crossbow Cases & Covers, Hardware & Parts, Scopes & Sights, Stabilizers, Range Accessories and Tools & Equipment (including Tool Accessories, Tools and Bow Presses), along with the attributes Archery target type and Broadhead design.
• Adds the attributes Racket balance and Racket head shape to Racket Sports categories.

Miscellaneous

• Expands the Language version attribute to include more languages and regional variations.
• Expands the Size attribute to include options for babies and toddlers.
• Extends existing attributes to additional categories.
• Includes other value additions.

2024-07

• The first stable release of "Shopify's Standard Product Taxonomy".

Pre-Stable Changelog

0.18.0 (May 17, 2024)

• Importing attribute descriptions
• Importing latest localizations
• Updating country attribute

0.17.0 (Apr 26, 2024)

Updated Attribute Data format

• The attributes data file has two new root level properties, base_attributes and extended_attributes
  • The base_attributes represent the base level attribute that contain an id and values.
  • The extended_attributes property contain attributes that have extended a base_attribute. They do not have an id and indicate their parent via the values_from property.

Updated Attribute Distribution format

• Attributes that extend another attribute have been removed and placed under a extended_attributes property.
• Categories that contain an extended attribute have these attributes indicated by an extended property.

0.16.0 (Apr 15, 2024)

Taxonomy Mappings

• Add mapping data from shopify/2022-02 to new shopify categories

0.15.0 (Apr 12, 2024)

Taxonomy Attribute Updates

• Product attributes in the taxonomy have been further refined, adding new 'Features'-based attributes
• Nested data within data/ directory files are now sorted alphabetically
  • data/categories/*.yml: category.attributes array
  • data/attributes.yml: attribute.values array

0.14.0 (Apr 9, 2024)

• Add parent_id field to attributes.json dist output

0.13.0 (Apr 5, 2024)

Add 2 more verticals.

📚 Taxonomy

• Adds Gift Cards vertical
• Adds Product Add-Ons vertical

0.12.0 (Apr 3, 2024)

• Shift attribute and attribute value friendly_ids to be consistent.
• Text distribution for values includes primary property.

0.11.0 (Apr 2, 2024)

Making GIDs spec-compliant.

👩🏼‍💻 Structure

• Category GID from gid://shopify/Taxonomy/Category/* → gid://shopify/TaxonomyCategory/*
• Attribute GID from gid://shopify/Taxonomy/Attribute/* → gid://shopify/TaxonomyAttribute/*
• Attribute Value GID from gid://shopify/Taxonomy/Value/* → gid://shopify/TaxonomyValue/*

0.10.0 (Mar 14, 2024)

📚 Taxonomy Attribute Updates

• Product attributes in the taxonomy have been refined, splitting the general 'material' attribute into more specific categories such as 'fabric', 'cocktail decoration material', 'safety equipment material' etc.

0.9.0 (Mar 4, 2024)

Changed GID structure for Attribute Values and added more txt distributions.

👩🏼‍💻 Structure

• Attribute GID from gid://shopify/Taxonomy/Attribute/123/12 → gid://shopify/Taxonomy/Value/12
• Added both dist/attributes.txt and dist/attributes_values.txt

💅🏼 Enhancement

• DB is now in a file instead of in-memory to save unnecessary seeding

0.8.0 (Mar 1, 2024)

Adds 3 more verticals.

📚 Taxonomy

• Adds Mature vertical
• Adds Religious & Ceremonial vertical
• Adds Services vertical

0.7.0 (Feb 29, 2024)

Adds 2 more verticals.

📚 Taxonomy

• Adds Toys & Games vertical
• Adds Vehicles & Parts vertical

0.6.0 (Feb 23, 2024)

Adds 2 more verticals.

📚 Taxonomy

• Adds Business & Industrial vertical
• Adds Software vertical

0.5.0 (Feb 23, 2024)

Adds 6 more verticals.

📚 Taxonomy

• Adds Animals & Pet Supplies vertical
• Adds Arts & Entertainment vertical
• Adds Baby's & Toddlers vertical
• Adds Cameras & Optics vertical
• Adds Media vertical
• Adds Office Supplies vertical

0.4.0 (Feb 23, 2024)

Adds 2 more verticals.

📚 Taxonomy

• Adds Hardware vertical
• Adds Luggage & Bags vertical

0.3.0 (Feb 21, 2024)

Adds electronics and simplifies existing verticals.

📚 Taxonomy

• Adds Electronics vertical
• Simplifies Food, Beverages, & Tobacco vertical
• Simplifies Health & Beauty vertical
• Simplifies Sporting Goods vertical

0.2.0 (Feb 14, 2024)

Adds the next vertical.

📚 Taxonomy

• Adds Health & Beauty vertical
• Adds Uncategorized category

0.1.0 (Feb 6, 2024)

Structure CHANGED for dist/attributes.json. Adds schema validation.

📚 Taxonomy

• Attribute distribution JSON is now normative, with top-level attributes and version keys

💅🏼 Enhancement

• cue added to validate dist/ while providing a clear spec of the distribution files

0.0.3 (Feb 2, 2024)

Adds the next vertical.

📚 Taxonomy

• Adds Furniture vertical

0.0.2 (Feb 2, 2024)

Sort output and improve the developer experience.

📚 Taxonomy

• Category distribution files are now sorted by name
• Attribute distribution files are now sorted by name

💅🏼 Enhancement

• Add an additional output, taxonomy.json that gives you all the data in one file

0.0.1 (Jan 31, 2024)

Initial public release.

📚 Taxonomy

Adds verticals:

• Apparel & Accessories
• Food, Beverages, & Tobacco
• Home & Garden
• Sporting Goods