Guide

Metadata standards

The metadata ORI keeps for each record, when each field is required, how it is validated and in which formats it is shared. ORI metadata follows Dublin Core and JATS conventions.

Updated outubro 12, 2026

Required fields

Status	Required
Draft	Journal, publication type and original title.
Reserved	Also language and at least one author (correction, retraction and expression-of-concern notices may have no authors).
Published	Also publication date and the official article address, which must be online.
Notices	Correction, retraction and expression-of-concern notices must reference the record they concern.

Fields

Field	Content
Titles	Original title, subtitle and translated titles (with language). Italic, bold, subscript and superscript are kept; other markup is removed.
Abstract	Original and translated abstracts.
Keywords	Up to 50, each with its language.
Language	BCP 47 tag, for example `en`, `pt`, `pt-BR`.
Publication type	Research article, review, systematic review, case report, brief report, methods article, data paper, editorial, letter, commentary, book review, correction, retraction notice, expression of concern or other.
Contributors	Given names, family name, role (author, editor, translator, collaborator), ORCID iD, affiliations (with optional ROR ID), corresponding author and CRediT roles.
Source	Volume, issue, first and last page or electronic article number.
Dates	Received, accepted and published (YYYY-MM-DD).
License	Creative Commons code (for example `CC-BY-4.0`) or license URL.
Addresses	Official article URL and full-text URL (http or https).
Funding	Funder name, ROR or Crossref Funder ID and award numbers.
Conflicts of interest	When provided.
External identifiers	DOI, PMID, PMCID, Handle, arXiv and ISBN.
References	Up to 2,000, each with optional DOI or URL.
Relations	Corrects, retracts, expresses concern about, updates, is version of, is translation of, is supplement to, comments on, replies to.
Source reference	The journal’s own id for the article (`source_ref`), unique in the journal.

Validations

ORCID iDs, ISSNs and ROR IDs are checked with their check digits.
DOIs are normalized (prefixes and case) and must be unique across ORI.
Dates must be real dates in order: received, accepted, published.
The same ORCID iD cannot appear twice among the contributors.
Each journal article can be registered only once (journal source reference), and ORI looks for duplicates by DOI, article address, and title in the same journal and year.

Example record

{
  "source_ref": "ojs-1234",
  "publication_type": "research-article",
  "language": "en",
  "title": "Sleep architecture in adults",
  "contributors": [
    {"given_names": "Ana", "family_name": "Souza", "orcid": "0000-0002-1825-0097",
     "affiliations": [{"name": "Federal University of São Paulo", "ror": "02k5swt12"}], "corresponding": true}
  ],
  "keywords": ["sleep", "polysomnography"],
  "volume": "3", "issue": "1", "first_page": "45", "last_page": "62",
  "published_date": "2026-04-15",
  "license_code": "CC-BY-4.0",
  "article_url": "https://journal.example.org/article/1234",
  "external_ids": [{"scheme": "doi", "value": "10.1234/example.2026.1"}],
  "references": ["Rechtschaffen A, Kales A. A manual of standardized terminology. 1968."]
}

How metadata is shared

Format	Where
HTML with citation tags	The record page, with `citation_*` meta tags read by academic search engines and JSON-LD.
JSON	`?format=json` on the record page and the public API.
BibTeX and RIS	`?format=bibtex` and `?format=ris`, for reference managers.
Dublin Core	OAI-PMH (`/oai`, prefix `oai_dc`), with sets per journal and publication type.
Citation styles	ABNT, APA and Vancouver on the record page; more styles with ORI Citation Studio.