You might have to migrate to v9 to upload Structured Data Files after September 8, 2025. See our deprecations page for more details and our v9 migration guide for step-by-step instructions.
Stay organized with collections
Save and categorize content based on your preferences.
There will generally be three supported versions of Structured Data Files (SDF)
at any given time. When a new version is released, a sunset date is announced
for the previous version. A version is considered deprecated once a sunset date
has been announced for it.
The minimum deprecation period for most versions will be 6 months. While
deprecated versions remain available until the scheduled sunset date, users are
encouraged to use the deprecation period to migrate to a newer version. After
the sunset date, deprecated versions will no longer be available.
The schedule of the announced deprecation and sunset dates:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-21 UTC."],[[["\u003cp\u003eThree versions of Structured Data Files (SDF) are generally supported, with older versions being deprecated and eventually sunsetted when new versions are released.\u003c/p\u003e\n"],["\u003cp\u003eDeprecated SDF versions remain available for a minimum of 6 months after the announcement, allowing users time to migrate to newer versions before the sunset date.\u003c/p\u003e\n"],["\u003cp\u003eAfter the sunset date, deprecated SDF versions will no longer be supported or available for use.\u003c/p\u003e\n"],["\u003cp\u003eA schedule of deprecation and sunset dates for various SDF versions is provided for user reference and planning.\u003c/p\u003e\n"],["\u003cp\u003eThe default SDF version will automatically update to the next oldest version 4 weeks before the sunset date of the current default.\u003c/p\u003e\n"]]],["Structured Data Files (SDF) maintain three supported versions. New versions trigger a sunset date announcement for the previous version, initiating a minimum six-month deprecation period. During deprecation, users should migrate to newer versions, although deprecated versions remain available until sunset. After sunset, those versions are removed. Four weeks before sunset, the default version increases. Deprecation and sunset dates for versions 3.1 to 6 are outlined, with dates ranging from 2019 to 2025.\n"],null,["# Deprecation Schedule\n\nThere will generally be three supported versions of Structured Data Files (SDF)\nat any given time. When a new version is released, a sunset date is announced\nfor the previous version. A version is considered deprecated once a sunset date\nhas been announced for it.\n\nThe minimum deprecation period for most versions will be 6 months. While\ndeprecated versions remain available until the scheduled sunset date, users are\nencouraged to use the deprecation period to migrate to a newer version. After\nthe sunset date, deprecated versions will no longer be available.\n| **Note:** The default SDF version will be increased to the next oldest version 4 weeks before sunset.\n\n*** ** * ** ***\n\nThe schedule of the announced deprecation and sunset dates:\n\n| SDF Version | Deprecation Date | Sunset Date |\n|-------------|-------------------|-------------------|\n| v3.1 | August 26, 2019 | March 2, 2020 |\n| v4 | August 26, 2019 | March 2, 2020 |\n| v4.1 | August 26, 2019 | March 2, 2020 |\n| v4.2 | August 26, 2019 | March 2, 2020 |\n| v5 | January 11, 2021 | July 12, 2021 |\n| v5.1 | January 11, 2021 | July 12, 2021 |\n| v5.2 | September 8, 2022 | March 8, 2023 |\n| v5.3 | September 8, 2022 | March 8, 2023 |\n| v5.4 | August 24, 2023 | February 27, 2024 |\n| v5.5 | March 27, 2024 | October 3, 2024 |\n| v6 | July 30, 2024 | April 30, 2025 |\n| v7 | May 7, 2025 | November 4, 2025 |\n| v7.1 | August 21, 2025 | March 3, 2026 |\n| v8 | August 21, 2025 | March 3, 2026 |\n| v8.1 | August 21, 2025 | March 3, 2026 |"]]
