Skip to main content

Additional Resources

Trust MVP Markup Code Examples

Note: All markup examples on this page are in JSON-LD format. The examples are for illustration only.

Best Practices Indicator

This indicator is ready for markup on your website when the individual policy pages for each of the BP policies are ready and you have collected the URLs for each of the pages.

Markup 1: General example

Where should the markup be added? 

Your news website's home page and/or about page.

Note: The links on this markup are examples for illustration only. Empty quotes ("") values for BP policy attributes signal that the policy is absent for this newsroom. 

<script type="application/ld+json">
{
<!-- TRUST PROTOCOL: BEST PRACTICES INDICATOR -->
"@context"   : "http://schema.org",
"@type"   : "NewsMediaOrganization",
"name"   : "Economist",
"ethicsPolicy"                    : "http://www.economistgroup.com/results_and_governance/governance/guiding_principles.html",
"masthead"              : "http://mediadirectory.economist.com/",
"missionCoveragePrioritiesPolicy"   : "http://www.economistgroup.com/what_we_do/our_mission.html",
"diversityPolicy"                    : "",
"correctionsPolicy"              : "",
"verificationFactCheckingPolicy"  : "",
"unnamedSourcesPolicy"               : "",
"actionableFeedbackPolicy"          : "",
 "foundingDate"                       : "1917-07-25",

"ownershipFundingGrants"          : "http://www.economistgroup.com/results_and_governance/ownership.html",

"diversityStaffingReport"            : "",

"refLocalNationalRequirements"       : "",
}
</script>

View/Validate this snippet using Google's structured data tool

 

Markup 2: How do I show that a policy is absent?

The Trust Protocol requires newsrooms to signal both policies that are present (i.e. in use) and that are absent. Use empty quotes (""). 

<!-- NULL STRING VALUES mean no policy exists to signal out -->

"diversityPolicy"                    : "",

"correctionsPolicy"                : "",

"verificationFactCheckingPolicy"  : "",

"unnamedSourcesPolicy"               : "",

"actionableFeedbackPolicy"         : "",

 

Relevant Schema.org specifications:

NewsMediaOrganization, actionableFeedbackPolicy, correctionsPolicy,diversityPolicy, ethicsPolicy, masthead, missionCoveragePrioritiesPolicy,unnamedSourcesPolicy, verificationFactCheckingPolicy

 

Type of Work Indicator

 

Markup 1: General

This indicator will be ready for markup on your website when you have mapped the types of content in your CMS to the Trust Protocol Type of Work indicator types and sub-types.

Where should the markup be added?

To the Article or Piece of Work (PoW).

Note: This markup offers examples for illustration only. The highlighted line is the type.

<script type="application/ld+json">
{
"@context": "http://schema.org",
"@type": "ReportageNewsArticle",
 "url": "http://www.bbc.com/news/world-us-canada-39324587",
 "publisher": {
"@type": "NewsMediaOrganization",
"name": "BBC News",
"logo":     "http://www.bbc.co.uk/news/special/2015/newsspec_10857/bbc_news_logo.png?cb=1"
},
"headline": "Trump Russia claims: FBI's Comey confirms investigation of election 'interference'",
"mainEntityOfPage": "http://www.bbc.com/news/world-us-canada-39324587",
"articleBody": "Director Comey says the probe into last year's US election would assess if crimes were committed."
   <!-- Note: more properties/key-value pairs follow as per your existing markup -->
}
</script>

View/Validate this snippet using Google's structured data tool 

 

Markup 2: Dual-typing or sub-typing (for occasional use only)

When an article is more than one type (e.g., News and Analysis), slap multiple types on it as below.


<script type="application/ld+json">
{
"@context": "http://schema.org",
"@type": ["ReportageNewsArticle", "AnalysisNewsArticle"],
 "url": "http://www.bbc.com/news/world-us-canada-39324587",
 "publisher": {
"@type": "NewsMediaOrganization",
"name": "BBC News",
"logo":     "http://www.bbc.co.uk/news/special/2015/newsspec_10857/bbc_news_logo.png?cb=1"
},
"headline": "Trump Russia claims: FBI's Comey confirms investigation of election 'interference'",
"mainEntityOfPage": "http://www.bbc.com/news/world-us-canada-39324587",
"articleBody": "Director Comey says the probe into last year's US election would assess if crimes were committed."
   <!-- Note: more properties/key-value pairs follow as per your existing markup -->
}
</script>

View/Validate this snippet using Google's structured data tool 

 

Schema.org background on the new News types:News overview document.

 

Author/Reporter Expertise Indicator  

Note: As of July 2017, Author/Reporter Info attributes for Languages and Expertise are pending review at Schema.org. The rest of the attributes for the tech MVP are illustrated here.


Markup 1:
For the Author/Reporter home page, or the publisher profile page. 

<script type="application/ld+json">
{
"@context": "http://schema.org",
"@type"   : "Person",
"name"    : "Maggie Haberman",
"image"   : "URL to author image on the publisher's website",
"workLocation" : {
"@type": "Place",
"name" : "New York, New York, USA"
},
"description" : "Maggie Lindsy Haberman is an American journalist who is a White House correspondent for The New York Times and a political analyst for CNN. She previously worked for Politico and the New York Daily News, where she was a political reporter.",
"contactPoint"     : {
"@type"        : "ContactPoint",
"telephone"    : "+1-425-123-4567",
"contactType"  : "Public Engagement",
"email"        : "mhaberman@nytimes.com",
"url"          : "http://www.nytimes.com/help/index.html"

},
"sameAs" : ["https://twitter.com/maggieNYT", "https://www.nytimes.com/by/maggie-haberman"],
"jobTitle" : "Reporter"    
}
</script>

View/Validate this snippet using Google's structured data tool

 

Markup 2: On the Article or PoW pages by an author. 

This is the very limited markup that goes on any and all pages that have content produced or authored by this reporter or author.

<script type="application/ld+json">
{
"@context": "http://schema.org",
"@type": "ReportageNewsArticle",
"mainEntityOfPage": "https://www.nytimes.com/2017/07/31/us/politics/anthony-scaramucci-white-house.html",
"author": {
"@type"   : "Person",
"name"    : "Maggie Haberman",
"sameAs" : "https://www.nytimes.com/by/maggie-haberman"
}
}
</script>

View/Validate this snippet using Google's structured data tool

 

Relevant Schema.org specifications:

Person, CreativeWork

  

Citations and References indicator

This indicator primarily leveages the 'citation' property of 'CreativeWork' in schema.org. 

Markup 1: Basic snippet, where all citation links are marked up as 'CreativeWork' links. 

<script type="application/ld+json">
{
"@context": "http://schema.org",
"@type": "ReportageNewsArticle",
"url": "http://www.cnn.com/2017/07/26/politics/trump-military-transgender/index.html",
"publisher": {
"@type": "NewsMediaOrganization",
"name": "CNN",
"logo": "http://i.cdn.cnn.com/cnn/.e/img/3.0/global/misc/cnn-logo.png"
},
"headline": "Trump to reinstate US military ban on transgender people",
"mainEntityOfPage": "http://www.cnn.com/2017/07/26/politics/trump-military-transgender/index.html",

"citation": [
{
"@type": "CreativeWork",
"url": "http://www.rand.org/pubs/research_reports/RR1530.html"
},
{
"@type": "CreativeWork",
"url": "http://www.tandfonline.com/doi/abs/10.108/1059924X.2015.1000104?journalCode=wagr20"
},
{
"@type": "CreativeWork", // or just "@type": "CreativeWork"
"url": "http://www.orlandosentinel.com/news/politics/political-pulse/os-transgender-military-trump-reaction-20170726-story.html"
}
]
}
</script>

 

 

Relevant Schema.org specifications:

CreativeWorkcitation

 

Additional Resources


Crowd-sourced ideas on identifying and blocking fake news, started by Eli Pariser

 

Crowd-sourced Diffr Project, by Tim McCormick, San Francisco

 

Thoughts on design

Open Trust Protocol Validator

Open Trust Protocol

Aligns the Trust Indicators with schema.org standards in order to implement a simple, best practices-based system for including Trust Indicators on news platforms. Users can submit a URL and receive an analysis of their implementation of the Indicators and recommendations on what is missing. They fill out the form with the relevant organization data, click generate, and receive a metadata snippet that can be added to their site. The Economist

Open Trust Protocol

The Source

Scans news stories for verifiable data objects and outputs them as structured data.

https://docs.google.com/presentation/d/1ixlB0jwl5e2R3T9Ee9x-XN8sDjsvWCXCCihMvCtQH1E/edit?usp=sharing

The Washington Post, Mic, Vox, Buzzfeed

Trust Hound: Site-Level Open Trust Protocol (Author, Best Practices)

Implements and expands upon the Trust Protocol.

https://www.dropbox.com/s/gjm2h48pp5lr4wb/Trust%20Project%20Challenge%20-%20TrustHound.pdf?dl=0

Trinity Mirror

 

Author Expertise and ID

Subject Expertise Bios – Contextualized

Surfaces reporters’ bios in the context of a story and alongside it while it is being read, watched or heard. Enables reporters to preload topic-specific bios and links them to any of their stories on the same topics. This contextual expertise relationship also is coded in a story’s microdata.

https://cloudup.com/c50q4BpaVY4

INN and BBC

A Certified Signature: Author certification and expertise system

https://www.dropbox.com/s/aes9fx2zblplu8s/Trust.pptx?dl=0

La Stampa

 

Sources 

SeeSource: Newsroom CMS and audience literacy tool to highlight source quality

https://docs.google.com/a/cironline.org/presentation/d/1dxf1G96-CXy6nEuSdgthqo01LWP3e2-5s2giWS1S5JU/edit?usp=sharing

This service (plug in and drupal module) validates “sources” metatags. Journalists enter data about their sources in a predesigned format; from the audience perspective, the sources appear as a highlighted text that, when clicked, show a pop-up window with additional information.  Users are also asked to rank source quality in a simple "five stars" ranking style.

El Universal and Center for Investigative Reporting

 

Original Reporting

Gleaning Provenance from Article Similarity

Measures similarity of articles to assess whether they are recycled churnalism or original reporting. Shows clusters of articles to ID the original news source (by date); also connects user to diverse, validated perspectives on same topic.

http://www.slideshare.net/tristanf/gleaning-provenance-from-article-similarity

Team BBCeX

 

Filter Bubble 

Automatic Journalism Discovery Agent: Pop Filter Bubble and Expose Problem News

  • Explains commonly used phrases
  • Highlights problematic phrases
  • Provides information on experts by finding other citations by the same named entity
  • Gives you out-of-bubble perspective by finding stories about the same named entities "in the other camp"

DPA

http://slides.com/j_reporter/ajda/

Open Bubble: Crowd-Sourced News Alternatives

https://docs.google.com/presentation/d/e/2PACX-1vTVCQGUfIxj5Nz_KDx7_6_qZkDNcWMgsztArVYGJiyJnpL_yaCygOKlettoSehFK3T7ecZ36PCAStgt/pub?start=false&loop=false&delayms=3000#slide=id.p

The Guardian

 

Citations and references

Credibility Indicator: A tool for assessing the credibility of a news article by analyzing the relevance of linked articles. An article is "credible", if it links to 1 or 2 related articles that also cover the same topic. The rationale is that if there are related articles like that, it indicates a deeper knowledge of the topic being discussed and a more "in depth" coverage of it.

(Requested)

Gruner + Jahr

 

Original Reporting

PISTIS

(requested)

BBC News Lab and Friends

 

Event Photos

https://myshare.box.com/s/2wwoavuiibaraaw7eo4ilacjwlqeqpp3

 

Github site

https://github.com/TheTrustProjectChallenge

Tech Development and UX Working Groups

Americas 

Hearst Television
Independent Journal Review
Institute for Nonprofit News
Mic
New York Times
Washington Post
The Globe and Mail
USA Today Network

Europe 

BBC
dpa
The Economist
La Stampa
La Repubblica
Haymarket Media
Trinity Mirror