This page details the major updates made to the Google Search Central documentation.
January 2021
- January 5: updated the list of recommended hreflang checker tools and removed those that don't work anymore.
December 2020
- December 4: Migrated the following guides from the Search Console Help Center (the content hasn't changed):
November 2020
- November 19: Migrated the Google Webmaster blogs to the new Google Search Central Blog.
- November 16: Added a new guide about how to join the Google Search Central office hours.
- November 12:
- Added a new guideline for STEM-education related Q&A pages.
- Added information about Googlebot's ability to crawl through HTTP/2 to the Googlebot help page.
- November 11: Published a redesign of the entire site. Reorganized the
navigation to account for a migration of over 100 new pages from the
Search Console Help
Center. The notable additions include:
- Home page: Expanded the focus to include our entire audience, not just web developers.
- Events landing page: Get an overview of upcoming events, including events that we host and attend as speakers.
- What's new on Google Search Central: Check out the latest updates on Google Search, including changes to our blog, documentation, new Search events, YouTube videos, and podcast episodes.
- Blog landing page: Added a new home page for our blog, previously known as the Google Webmaster Central blog. We plan to move archived posts soon.
- Help landing page: Updated to include all of our help resources. Refreshed and simplified the Webmaster FAQ into 4 pages:
- Documentation landing page: Get an overview of the different learning paths in our documentation, including new Quickstart guides, beginner SEO guides, and advanced SEO guides.
- Quickstart guides: A new set of guides for those that don't have much time to manage their site.
- Beginner SEO guides: A new set of guides for beginners who want to learn about SEO. New pages include: Beginners guide to Search Console.
- Advanced SEO guides: A new set of guides for advanced SEO topics. Most of the pages previously existed in the Search Console Help Center. New pages include:
- November 10: Updated the timeline information for the upcoming page experience ranking change. The changes are planned to go live in May 2021.
October 2020
- October 30:
- Updated the
librarySystem
additionalProperty.value
property in theBook
documentation, replacing thenational
value with thegovernment
value. - Updated the timeline for data-vocabulary.org support on intro to structured data and breadcrumb page. As of January 29, 2021, data-vocabulary.org markup will no longer be eligible for Google rich result features. To be eligible after January 29, 2021, you need to replace data-vocabulary.org markup with schema.org markup. Learn more about sunsetting support for data-vocabulary.
- Updated the
- October 29: Added image ratio specifications to the
hiringOrganization.logo
property and the Logo is incorrect troubleshooting section. - October 22: Changed the API requirement for package tracking documentation to state that we only accept POST requests.
- October 6: Added new examples of Web Stories, best practices for creating Web Stories, and Web Story content policy.
September 2020
- September 22: Added support for
shippingDetails
to theProduct
structured data documentation. - September 21: Added new episodes about Indexing (JavaScript) comments and Google's Honest Results Policy to the Search Off the Record podcast page.
- September 18: Updated the
fact
check guidelines to include all relevant eligibility guidelines in one place (some guidelines were previously mentioned only in the Publisher Center article about fact-checked content). Added the following new guidelines:
- You must have a corrections policy or have a mechanism for users to report errors.
- Websites for political entities (such as campaigns, parties, or elected officials) aren't eligible for this feature.
- You must clearly attribute the specific claim that you're assessing to a distinct origin (separate from your website), whether it's another website, public statement, social media, or other traceable source.
- September 15:
- Added support for
regionsAllowed
in the Video documentation. Added Microdata examples. - Updated the
EmployerAggregateRating
and Review snippet documentation to clarify thatbestRating
andworstRating
are recommended if you want to specify a different scale than the default 5-point system.
- Added support for
August 2020
- August 31: Updated the Image License documentation to state that the Licensable badge is now out of beta.
- August 27: Clarified merging of user-agent groups in the file robots.txt documentation.
- August 26: Added new documentation about the Home activities rich result.
- August 21: Added section to the Fix Search-related JavaScript problems guide to explain how to deal with non-HTTP network connections.
- August 10: Clarified that there are different
Article
requirements for AMP and non-AMP pages. Added an example of a non-AMP page withArticle
structured data. - August 5: Clarified in all relevant documentation that images referenced in structured data must be in one of the image file formats that are supported by Google Images.
- August 3:
- Added a new episode about Indexing (JavaScript) comments to the Search Off the Record podcast page.
- Added the optional
jobBenefits
andindustry
properties to the Estimated salary documentation, to match the existing requirements in the Rich Results Test.
July 2020
- July 24: Added new episodes to the Search Off the Record podcast page.
- July 23: Clarified that Google Search is still working on way to display multiple fact checks for a single page, and that you may not see a rich result that features multiple fact checks in Google Search right away.
- July 21: Added a new optional property to the Dataset documentation,
measurementTechnique
, and clarified that thename
property should be unique for distinct datasets. - July 20: Added the
reviewCount
property to theEmployerAggregateRating
documentation, to match the existing requirements in the Rich Results Test. EitherreviewCount
orratingCount
is required. - July 16:
- Updated the
Book
documentation to explain how select book providers can provide a feed of data to Google with the structured data schema. - Clarified that product rich results only support pages that are about a single product, not category pages or lists.
- Based on Lighthouse recommendations, specified what small font size means on the Common mistakes page of the Mobile SEO guidelines.
- Updated the
- July 8: Clarified that Google Search understands when you specify multiple items on a page with structured data, whether you nest the items or specify each item individually.
- July 1: Clarified in the AMP logo guidelines in the
Article
documentation that the logo can be in any format supported by Google Images.
June 2020
- June 30: Added more examples to the Carousel documentation, and clarified the supported types and how to add them.
- June 23: Added a note to differentiate between guidelines applicable to
Article
AMP logo guidelines and genericLogo
guidelines. - June 19: Added a
contentUrl
requirement to the Image License documentation to make it clear that the feature needs a specific image URL to apply the license to. - June 16: Added native lazy-loading to the lazy-loading guide.
- June 15: Added monitoring rich results video
and more detailed information on using Search Console to monitor rich results to structured data reference pages
(for example Product,
Recipe
, FAQ). - June 12: Added
.webp
, too, to the list of supported image file formats forLogo
structured data. - June 10: Added
.svg
to the list of supported image file formats forLogo
structured data. - June 8: Clarified that the recognized values for an
applicationCategory
on a Software App are of typeText
. - June 4: Clarified in the
Sitelinks search box documentation that the
search query parameter key can be any string permitted by
RFC 3986; it
doesn't have to be
q
.
May 2020
- May 28: Add new documentation that explains page experience in Google Search results.
- May 27: Updated the Job
training developer documentation to require the
occupationalCategory
property, recommend thedescription
property, and remove the requirement of theurl
property. Also updated theeducationalProgramMode
andfinancialAidEligible
fields to have more precise value specifications. - May 19: Added new guidance on how to enable Web Stories on Google.
- May 15: Added a note to the
Product
structured data documentation about how to be eligible for the Google Shopping tab. Learn more about the data and eligibility requirements. - May 12: Extended the JavaScript SEO basics guide to include guidance on JavaScript-generated links, History API instead of fragment URLs, and avoiding soft 404 errors.
- May 11:
- Added guidance on how to reduce the Googlebot crawl rate.
- Removed the following documentation that has been deprecated
since June 2019:
- Social Profile structured data: We now automatically discover social profiles to include in Google knowledge panels. If you're verified as an official representative, you can suggest a change directly. Learn more at Update your Google knowledge panel.
- Corporate Contact structured data: We now automatically discover corporate contact information to include in Google knowledge panels. If you're verified as an official representative of a Google knowledge panel, you can suggest a change directly. Learn more at Update your Google knowledge panel.
- Place Actions structured data: Instead, scheduling providers can use the Maps Booking API. Google Search continues to support existing partners that added Place Action structured data prior to June 17, 2019.
- May 7:
- The Rich Result Test now supports
Article
structured data on AMP pages. Removed the following recommended fields from the documentation because we no longer need these signals:description
,publisher.logo.height
,publisher.logo.width
. - Added a video to the Submit URLs guide that explains what a sitemap is, whether you need one or not, and how to submit a sitemap and track its status using Search Console.
- Removed the page about joining the Mini-apps Early Adopters Program. The program is no longer accepting submissions.
- The Rich Result Test now supports
- May 6: Added information about how to test robots.txt markup.
- May 5:
- Updated the Job posting
content policies to have a clear structure and language that describes what Google
will enforce. Added the following new policies:
- Irrelevant content
- Incomplete content
- We don't allow job postings on behalf of an organization or company without authorization.
- Advertisements disguised as a job posting
- Updated
SpecialAnnouncement
structured data to include information on how to use Search Console to troubleshoot markup and analyze the rich result performance. - Podcasts on Google information has migrated to the new Podcasts Manager help center. Visit the help center to learn how to get your podcast on Google.
- Updated the Job posting
content policies to have a clear structure and language that describes what Google
will enforce. Added the following new policies:
- May 1: Updated the Indexing API documentation
to include the
<meta name="robots" content="noindex" />
tag as an option for removing a URL.
April 2020
- April 30:
- Added a note to explain that it isn't reliable to use cached links for debugging purposes. Instead, use the URL Inspection Tool because it has the a most up-to-date version of your page. The note was added to the general debugging guide, JavaScript debugging guide, and the structured data debugging guide.
- Updated the Breadcrumb structured data documentation to have some explanatory text on how breadcrumbs relate to URL paths.
- April 27: Updated the Job training structured data documentation to require 2-letter country codes for provider addresses.
- April 23: Added missing meta description issue to the list of error messages in the mobile-first indexing best practices.
- April 22: Updated the Paywalled content structured data documentation to include a list of supported types.
- April 20: Added COVID-19 resources for sites from Google Search and Best practices for education sites
- April 16:
- Added a new example and optional properties to support COVID-19 announcements about government benefits:
- Updated the
JobPosting
structured data documentation to highlight markup for work from home jobs. Added a screenshot of the feature in Google Search, a code example, and a banner at the top of the documentation.
- April 14: Added optional properties to the
Event
structured data documentation:organizer
,organizer.name
,organizer.url
. - April 10: Updated the COVID-19 announcements documentation. The Rich Results Test now supports
SpecialAnnouncements
. - April 8:
- Added a note to COVID-19
announcements documentation to clarify that businesses should use
LocalBusiness
markup or Google My Business to update store hours and post updates. - Added a new case study that showcases how Saramin increased organic Search traffic 2x by investing in SEO.
- Added a note to COVID-19
announcements documentation to clarify that businesses should use
- April 7: Updated the
Event
structured data documentation to state that the timezone UTC/GMT offset is required for online events, since there is no location information that Google can use to understand when the event starts. - April 3:
- Removed the caution note about the Structured Data Testing Tool from the
COVID-19
announcements documentation. The Structured Data Testing Tool now supports
announcementLocation
. Added a new screenshot of an announcement in Search results. Added a new example that shows a page with multiple announcements, and added Microdata examples. - Added new guidance on how to add structured data with JavaScript.
- Removed the caution note about the Structured Data Testing Tool from the
COVID-19
announcements documentation. The Structured Data Testing Tool now supports
- April 2: Added new guidance on how to submit COVID-19 announcements in Search Console. Added information on how to sign up for the technical support group. At first, we'll be accepting only national government domains and US state level agencies. For more information about the group, read our announcement.
March 2020
- March 31: Added new guidance for how to add structured data to COVID-19 announcements. This feature is still under development, and you may see changes in requirements, guidelines, and how the feature appears in Google Search.
- March 26: Added new guidance for how to pause your online business.
- March 24:
- In the Estimated Salary
documentation, replaced the
unitText
property with theduration
property. Starting March 24, 2020, we updated the documentation to requireduration
instead ofunitText
. While we continue to supportunitText
, we requireduration
moving forward. We recommend that you switch over to usingduration
, if possible. - Updated the Google Podcasts brand assets to include localized Google Podcasts badges in 49 languages.
- In the Estimated Salary
documentation, replaced the
- March 23: Added a new recommended field to the Package tracking developer documentation:
CanReschedule
. - March 20:
- Added the Latest updates page (this page), which includes the major updates made to the Google Search developer documentation in March 2020.
- Added a new recommendation to the JavaScript best practices about using long-lived caching to avoid caching issues with Googlebot. Added a new step about using content fingerprinting to the JavaScript troubleshooting documentation.
- Added a note to the
Event
structured data documentation about the new optional properties that were added on March 16-17, 2020. The Rich Results Test now supports the new properties.
- March 17:
- Added optional properties to the
Event
structured data documentation:eventAttendanceMode
,VirtualLocation
type forlocation
,location.url
for online events. For more information about this change, check out our blog post. - Added general
troubleshooting info to the Sitelinks search box documentation. Clarified that
while Google Search may automatically display a search box scoped to your website,
it's still helpful to explicitly provide information by adding
WebSite
structured data, which can help Google better understand your site. - In the Job training developer documentation,
removed the
hasCredential
property from the list of recommended properties forEducationalOccupationalProgram
. This is becausehasCredential
is only recommended for theOrganization
type on schema.org, notEducationalOccupationalProgram
.
- Added optional properties to the
- March 16: Added optional properties to the
Event
structured data documentation:eventStatus
andpreviousStartDate
. For more information about this change, check out our blog post. - March 5:
- In the
Product
structured data documentation, clarified that one of the following properties is required:review
,aggregateRating
,offers
. Changed the expected type forbrand
to beBrand
orOrganization
(Thing
is still accepted). - Added new recommended fields to the Package
tracking developer documentation:
TimestampEvent
andLocationEvent
.
- In the
- March 3: Added hostload issues to the list of error messages in the mobile-first indexing best practices.