Error guide

Element not allowed in JATS XML

The element not allowed message appears when an XML child sits outside the content model defined by the JATS XSD. The document may be well-formed —meaning it parses correctly as XML— and still fail schema validation because the semantic structure does not match what JATS Archiving expects.

This error is among the most frequent in journals migrating from Word or PDF, where content is organized visually but not according to standard rules. Understanding the message lets you fix the root cause instead of applying random patches.

What the error means

Each JATS element declares which children it may contain, in what order, and how many times. The validator compares your XML against that model. If you insert, for example, a <p> where only <title> is expected, or place <table-wrap> directly inside <abstract>, it reports the child element as not allowed and points to the approximate line.

The error almost always refers to the child, not the parent. Read the message to identify which tag is misplaced and consult the immediate container element in the JATS 1.3 Archiving specification.

Example 1: loose paragraph in body

Incorrect:

<body>
  <p>Paragraph without a containing section.</p>
</body>

In JATS Archiving, the <body> of a research article expects <sec> sections, not direct paragraphs.

Correct:

<body>
  <sec sec-type="intro">
    <title>Introduction</title>
    <p>Paragraph inside a valid section.</p>
  </sec>
</body>

Example 2: section without title

Incorrect:

<sec>
  <p>Text without a section title.</p>
</sec>

In many contexts, <sec> expects a <title> before narrative content.

Correct:

<sec>
  <title>Methods</title>
  <p>Section text.</p>
</sec>

Example 3: table inside abstract

Incorrect:

<abstract>
  <p>Study abstract.</p>
  <table-wrap id="tbl1">
    <table>...</table>
  </table-wrap>
</abstract>

<abstract> does not admit tables or figures in the standard Archiving profile.

Correct: Move the table to <body> within the appropriate results section.

Frequent causes in editorial production

SourceTypical pattern
Word conversionMis-mapped floating blocks
Copy/paste from another articleElements from wrong context
Embedded HTMLNon-JATS tags (div, span)
Supplementary materialFiles in wrong location

If the validator mentions HTML elements, replace them with JATS equivalents (<bold>, <italic>, <xref>) or remove unsupported markup.

Step-by-step diagnosis

  1. Open the file in the JATS validator.
  2. Jump to the line indicated in the report.
  3. Identify the parent element of the reported child.
  4. Consult which children that parent admits in JATS Archiving.
  5. Move, rename, or remove the child to match the model.
  6. Revalidate until the error is cleared.

For cascading errors, fix the first one: subsequent errors often disappear when the parent structure is restored.

Relation to other errors

Element not allowed often appears alongside invalid document structure when mandatory blocks such as <front>, <body>, or <back> are missing. Review the complete hierarchy if you receive multiple structural errors.

See also common JATS errors for an overview of the 15 most frequent patterns.

Prevention in your editorial workflow

  • Use XML templates with predefined <sec> structure.
  • Validate each article as it enters the issue, not at the end.
  • Train the conversion team on the three article regions: front, body, back.
  • Document approved exceptions for special article types (editorial, letter).

If structural errors recur, consider editorial validation or JATS XML production to normalize the workflow.

Conclusion

The element not allowed error does not indicate corrupt XML: it indicates a mismatch between the structure you wrote and what JATS requires. With the validator, the parent element specification, and a coherent template, correction is systematic and repeatable issue after issue.

Validate your file in the JATS validator and explore other error guides for related diagnostics.