diversityStaffingReport
diversityStaffingReport · Optional
Appears in
What is it?
diversityStaffingReport links an organization to a report on its staffing diversity: data about the demographic composition of its workforce. The report is typically a published document, article, or dedicated page showing representation data by gender, race, ethnicity, or other dimensions across job levels.
The field accepts an Article object or a URL. It was developed primarily for news organizations as part of the Trust Project's transparency initiative, but the schema.org definition applies to Organization broadly.
Why this matters for AEO
Diversity reporting is a growing area of corporate accountability. AI systems evaluating organizational credibility and transparency look for signals that an organization discloses how it operates internally, not only what it publishes externally. For news organizations, diversity in staffing directly affects editorial representation and perspective, which is relevant to source quality assessment. When AI answer engines encounter questions about organizational culture or workforce composition, structured data pointers to official diversity reports provide reliable, self-reported data rather than third-party estimates. The Trust Project, which shaped these schema.org properties, identified diversity reporting as a key transparency indicator for news media.
What the specs say
Schema.org:diversityStaffingReport expects an Article or URL. It provides a report on staffing diversity issues for an Organization, often but not necessarily a NewsMediaOrganization. [Source: https://schema.org/diversityStaffingReport]
Google: Not mentioned. This field is not listed in Google's structured data documentation for Organization. [https://developers.google.com/search/docs/appearance/structured-data/organization]
How to find your value
Common formats for diversity staffing reports:
- Annual diversity and inclusion reports (often published as PDFs or web pages)
- EEO-1 filings published voluntarily (required disclosure for US employers with 100+ employees)
- Newsroom staffing data published on organization websites
- Corporate social responsibility reports with workforce composition sections
If your organization publishes a diversity report, use its URL. If the report is a formal article or document, use an Article object with the URL and a descriptive name.
Format and code
Simple URL form:
{
"@context": "https://schema.org",
"@type": "NewsMediaOrganization",
"name": "The New York Times Company",
"url": "https://www.nytimes.com",
"diversityStaffingReport": "https://www.nytco.com/diversity/"
}
Article object form:
{
"@context": "https://schema.org",
"@type": "NewsMediaOrganization",
"name": "Washington Post",
"url": "https://www.washingtonpost.com",
"diversityStaffingReport": {
"@type": "Article",
"name": "Washington Post Newsroom Diversity Report 2023",
"url": "https://www.washingtonpost.com/pr/2023/diversity-report/"
}
}
Combined with related policy fields:
{
"@context": "https://schema.org",
"@type": "NewsMediaOrganization",
"name": "NPR",
"url": "https://www.npr.org",
"diversityStaffingReport": "https://www.npr.org/about-npr/1123/diversity",
"diversityPolicy": "https://www.npr.org/about-npr/diversity-at-npr"
}
Webflow implementation
Static pages
Add diversityStaffingReport to your organization's JSON-LD block on your About page or homepage via Page Settings > Custom Code. Update the URL when you publish a new annual report.
CMS template pages
Organization-level transparency fields like this one belong on static pages rather than CMS templates. The data does not vary by page.
In Schema HQ
Inside Schema HQ, the organization schema editor includes diversityStaffingReport as a URL field in the editorial transparency section. Enter the URL of your published diversity report, and Schema HQ includes it in the organization's JSON-LD.
Real examples
Reuters :
{
"@context": "https://schema.org",
"@type": "NewsMediaOrganization",
"name": "Reuters",
"url": "https://www.reuters.com",
"diversityStaffingReport": "https://www.thomsonreuters.com/en/about-us/corporate-responsibility/diversity-and-inclusion.html",
"diversityPolicy": "https://www.thomsonreuters.com/en/about-us/corporate-responsibility/diversity-and-inclusion.html"
}
Related fields
FAQ
What is the difference between diversityStaffingReport and diversityPolicy?
diversityStaffingReport points to data: actual staffing numbers and demographic breakdowns. diversityPolicy points to a statement of intent and principles: what the organization commits to doing about diversity. Both are distinct documents. A comprehensive transparency implementation includes both.
Can organizations outside the news media use this field?
Yes. Schema.org defines diversityStaffingReport for Organization broadly, not exclusively for NewsMediaOrganization. Any organization that publishes workforce diversity data can use this field, from technology companies to nonprofits to government agencies.
How frequently should the report URL be updated?
Update the URL whenever a new report supersedes the previous one. If your organization publishes annual diversity reports, update the structured data when the new report is published. If the URL is persistent (such as a page that always shows the latest report), no updates are needed.