Error guide

Missing required attribute in JATS XML

The missing required attribute message indicates a JATS element is present but lacks an attribute the schema declares mandatory. Unlike a misplaced element, the tag itself is correct; what is missing is metadata in attribute form that the validator needs to classify and process content.

This error is especially common in automatic conversions from Word or in incomplete templates. The good news is it usually fixes in seconds once the missing attribute is identified.

Most frequent mandatory attributes

Root element `<article>`

<!-- Incorrect -->
<article dtd-version="1.3">

<!-- Correct -->
<article article-type="research-article"
         dtd-version="1.3"
         xmlns:xlink="http://www.w3.org/1999/xlink">

Attribute	Function
`article-type`	Classifies the article (research-article, review-article, etc.)
`dtd-version`	JATS schema version (1.3 current)

References, figures, and tables

Elements receiving cross-references require a unique id:

<!-- Incorrect -->
<ref>
  <element-citation publication-type="journal">...</element-citation>
</ref>

<!-- Correct -->
<ref id="ref1">
  <element-citation publication-type="journal">...</element-citation>
</ref>

The same applies to <fig id="fig1">, <table-wrap id="tbl1">, and <sec id="sec1">.

`<element-citation>`

<element-citation publication-type="journal">

The publication-type attribute is mandatory and must reflect the actual type: journal, book, web, thesis, etc.

Affiliations and countries

<aff id="aff1">
  <institution content-type="orgname">National University</institution>
  <country country="US">United States</country>
</aff>

SciELO and PMC require id on <aff> and ISO code in the country attribute.

Why these attributes matter

Attributes are not decorative: they enable functionality:

article-type determines which sections are expected in the body.
id connects <xref ref-type="bibr" rid="ref1"> to the actual reference.
publication-type indicates which subelements are mandatory in the citation.
xml:lang on <abstract> enables multilingual indexing.

Without them, XML may look complete visually but fail in harvesters and repositories.

Pre-validation checklist

Before submitting a batch, verify:

<article> has article-type and dtd-version
xmlns:xlink namespace declared if graphics or links exist
Each referenced <ref>, <fig>, <table-wrap>, and <sec> has unique id
Each <element-citation> has publication-type
Each <aff> has id and <country country="XX">
<abstract> has xml:lang when multilingual metadata exists

Use the JATS validator to automatically detect missing attributes.

Template-level correction

If the same attribute is missing across multiple articles, the problem is in the template or converter, not individual authors. Update the journal's XML template and regenerate affected articles.

Minimum template example:

<?xml version="1.0" encoding="UTF-8"?>
<article xmlns:xlink="http://www.w3.org/1999/xlink"
         article-type="research-article"
         dtd-version="1.3"
         xml:lang="en">
  <front>...</front>
  <body>...</body>
  <back>...</back>
</article>

Missing attributes sometimes mask element not allowed when the converter omitted mandatory markup. Fix attributes first; revalidate before addressing more complex structural errors.

See common JATS errors for full context.

Support services

If your team cannot audit attributes systematically, editorial validation includes metadata review beyond the XSD schema. For complete production, JATS XML production delivers files with normalized attributes.

Conclusion

Missing required attribute is one of the fastest errors to fix and prevent. A well-configured template and per-article validation eliminate most occurrences before they reach the indexer.

Validate now in the JATS validator and explore error guides for other diagnostics.