JSON-LD Examples

Structured data examples for SEO and discoverability

Scholarly Article — Root (latest) page
<script type="application/ld+json"> { "@context": "https://schema.org", "@type": "ScholarlyArticle", "@id": "https://nobleid.org/20092025/7X9K2Q", "identifier": [ "ark:/48914/20092025/7X9K2Q" ], "headline": "Climate impacts in 2025", "author": [ { "@type": "Person", "name": "A. Researcher", "identifier": "https://nobleid.org/p/ppid:abcd1234" }, { "@type": "Person", "name": "B. Collaborator" } ], "datePublished": "2025-09-20", "inLanguage": "en", "keywords": ["climate", "impact", "2025"], "license": "https://creativecommons.org/licenses/by/4.0/", "sameAs": [ "https://publisher.org/articles/123" ], "isBasedOn": "https://publisher.org/articles/123", "encoding": [ { "@type": "MediaObject", "contentUrl": "https://publisher.org/articles/123.pdf", "encodingFormat": "application/pdf" } ] } </script>
Scholarly Article — Pinned version (v2) page
<script type="application/ld+json"> { "@context": "https://schema.org", "@type": "ScholarlyArticle", "@id": "https://nobleid.org/20092025/7X9K2Q:v2", "identifier": [ "ark:/48914/20092025/7X9K2Q", "ark:/48914/20092025/7X9K2Q:v2" ], "version": "v2", "headline": "Climate impacts in 2025 (Revised)", "author": [ { "@type": "Person", "name": "A. Researcher", "identifier": "https://nobleid.org/p/ppid:abcd1234" }, { "@type": "Person", "name": "B. Collaborator" } ], "datePublished": "2025-09-20", "dateModified": "2025-10-01", "inLanguage": "en", "license": "https://creativecommons.org/licenses/by/4.0/", "sameAs": ["https://publisher.org/articles/123"], "isBasedOn": "https://publisher.org/articles/123", "encoding": [ { "@type": "MediaObject", "contentUrl": "https://publisher.org/articles/123-v2.pdf", "encodingFormat": "application/pdf" } ] } </script>
Dataset page
<script type="application/ld+json"> { "@context": "https://schema.org", "@type": "Dataset", "@id": "https://nobleid.org/20092025/7X9K2Q", "identifier": ["ark:/48914/20092025/7X9K2Q"], "name": "Global rainfall anomalies, 1990–2025", "creator": [ { "@type": "Person", "name": "A. Researcher", "identifier": "https://nobleid.org/p/ppid:abcd1234" } ], "datePublished": "2025-09-20", "inLanguage": "en", "keywords": ["rainfall","climate","anomaly"], "license": "https://creativecommons.org/licenses/by/4.0/", "sameAs": ["https://repo.example.edu/datasets/xyz"], "distribution": [ { "@type": "DataDownload", "contentUrl": "https://repo.example.edu/datasets/xyz.csv", "encodingFormat": "text/csv" } ] } </script>
NobleID-P Person page (public profile)
<script type="application/ld+json"> { "@context": "https://schema.org", "@type": "Person", "@id": "https://nobleid.org/p/ppid:abcd1234", "name": "A. Researcher", "identifier": [ "ppid:abcd1234", "https://orcid.org/0000-0002-1825-0097" ], "affiliation": { "@type": "Organization", "name": "Example University", "identifier": "https://ror.org/01bj3aw26" }, "sameAs": [ "https://scholar.google.com/citations?user=XXXX", "https://orcid.org/0000-0002-1825-0097" ] } </script>
Page-head helpers (SEO/citation)
Add these in the <head> of article/dataset pages
<link rel="canonical" href="https://publisher.org/articles/123" /> <link rel="alternate" type="application/vnd.citationstyles.csl+json" href="https://nobleid.org/20092025/7X9K2Q:v2?format=csl-json" /> <link rel="alternate" type="application/x-bibtex" href="https://nobleid.org/20092025/7X9K2Q:v2?format=bibtex" /> <link rel="alternate" type="application/x-research-info-systems" href="https://nobleid.org/20092025/7X9K2Q:v2?format=ris" /> <meta name="nobleid" content="ark:/48914/20092025/7X9K2Q" />
Update-Checker widget (drop-in)
Paste near the end of <body> on your article/dataset template
<script src="https://www.nobleid.org/widget/update-checker/v1.js" data-ark="ark:/48914/w1/20260513/1E98B139" <!-- set to the root ARK --> async></script>
CSP (example)
Content Security Policy configuration for the widget
Content-Security-Policy: default-src 'self'; script-src 'self' https://www.nobleid.org; img-src 'self' data:; style-src 'self' 'unsafe-inline';
What it does

Renders:

One link to the work's NobleID page, which always shows the current version.

No cookies, respects Do-Not-Track, accessible (ARIA role="status").

Quick validation tips
  • \u2022 Test JSON-LD with Google's Rich Results / SDTT; expect the object type to be recognized (ScholarlyArticle/Dataset/Person)
  • \u2022 Verify the badge by publishing v2; it should flip within your cache window (60–120s)
  • \u2022 Keep the root ARK in the widget (:vN is only for pinned links)
    ByNobleID