Changelog

The changelog is a chronological record of retailer-facing changes to the catalog inventory file and catalog API.

October 3, 2025

• Updated the nutrition information specification with information about the two available formatting options, multi-block and single block.

October 1, 2025

• Correction: The changelog for Sepetember 30, 2025 incorrectly states that the blackout period requirements functionality was removed. This functionality is still supported.
• Removed references to the message field from the blackout period requirements specification.

September 30, 2025

• Added the ability to send data for the following promotion types using your inventory file:

  • Buy M Units, Get $X Off per Measurement Unit
  • Buy M or More Units, Get $X Off per Measurement Unit
  • Buy M Units for $X per Measurement Unit
  • Buy M or More Units for $X per Measurement Unit

  For more information, see Promotion types and metadata examples.

• Removed the ability to send data for availability blackout periods using your inventory file. You can still send availability blackout period data using the Item API.

August 26, 2025

• Added the tare_packaging Caper attribute.

July 17, 2025

• Added the stock_level attribute to the Item API.

July 4, 2025

• Updated the Configurable products and Configurable products specifications topics to include the following note about text options:

  Note: The Shopper App doesn't support the text and text_field options, which means that the text is not visible to shoppers.

June 12, 2025

• The Catalog documentation site has moved from https://partner-docs.instacart.com/catalog to https://docs.instacart.com/catalog and no longer requires a login. All future changes to the documentation will be made in the new location only. The partner site will be removed at the end of July 2025. Please update your bookmarks.

  Tip: To update bookmarks, edit your bookmarks to remove partner- from the URL.

May 1, 2025

• Added documentation for Flyers data ingestion.

March 21, 2025

• Increased the big and bulky product weight limitation from 60 lbs to 63 lbs. For more information, see the description of the sold_weight and sold_weight_uom columns in Additional dimensions.

March 17, 2025

• Added a list of Caper attributes to the inventory file specifications.

January 30, 2025

• Fixed the Buy_M_Or_More_For_X_Dollars_Each promotion type, which incorrectly used Get instead of For.

January 8, 2025

• Added the following promotion types:

  • Buy 2 or more, Get $2 off each
  • Buy 2 or more, Get each for $10

  For more information, see Promotion types and metadata examples.

• Updated the Promotion requirements topic to describe promotion groups.

July 26, 2024

• Added a promotion type Buy 1, Get 50% Off an Item. For more information, see Promotion requirements.

May 27, 2024

• Updated the item_details column description to mention that you can use HTML ul tags to display bullet points.

May 3, 2024

• Added documentation for logo requirements on Instacart Marketplace. For more information, see Logo requirements.

April 16, 2024

• Added support for the Buy_M_Dollars_Get_X_Dollars_Off promotion type, such as Buy $45, Get $10 off. For more information, see Promotion requirements.

February 27, 2024

• Added documentation for the exclude_markup column. Use this column to exclude specific products from universal markup. For more information, see Special integrations.
• Added documentation for the location_data column. Use this column to provide in-store locations of your products. For more information, see In-store locations.