Supported HTML markup tags in Document of Record
What this reference covers?
AEM Forms now supports HTML markup tags in rich text fields when generating Document of Record (DoR) PDFs. This guide explains which HTML markup tags you can safely use in Adaptive Forms and how they render in the generated documents.
If you add rich text content (such as bold formatting, lists, or links) to your forms, it’s important to understand which tags are supported and any limitations they may have. This reference helps you choose the appropriate tags to ensure your content displays correctly and remains accessible in the Document of Record.
Before you start
Prerequisites
You should be familiar with:
- Basic HTML markup syntax
- Document of Record fundamentals
- Accessibility principles and WCAG guidelines
- PDF accessibility requirements
- Adaptive Form components that accept HTML markup
Considerations
The Document of Record (DoR) can be a tagged PDF, which helps ensure accessibility and proper structure for assistive technologies. To enable tagged PDF output, set the XCI property config/present/pdf/tagged
to true
. After generating your PDF, it’s important to verify that accessibility tags are correctly applied. You can use Adobe Acrobat to check accessibility tags and ensure your document meets accessibility standards.
What’s new
Rich text support in Document of Record is a recent enhancement. Previously, rich text content appeared as plain text in generated documents. This new capability allows formatted content to render properly in PDF outputs.
HTML tag support reference
Fully supported tags
These tags are fully supported with proper accessibility node creation:
<p>
<P>
node<p>This is a paragraph.</p>
<br/>
<P>
node<p>Line 1<br/>Line 2</p>
<b>
<P>
node<b>bold text</b>
<i>
<P>
node<i>italic text</i>
<span>
<span>styled text</span>
<sub>
H<sub>2</sub>O
<sup>
E=mc<sup>2</sup>
<a>
<a href="url">link text</a>
List accessibility issue
Current list rendering creates <P>
nodes instead of proper list structure:
Current: <P>1. First item
Current: <P>2. Second item
Expected: <L>
Expected: <LI>
Expected: <LBL>1.
Expected: <LBody>First item
Unsupported tags
These tags are not supported and will not render properly:
<h1>
- <h6>
<p>
tags or design-level headers<img>
<code>
<span>
styling<blockquote>
<p>
tags with indentation<table>
Code examples
Basic text formatting
<!-- Supported - renders correctly -->
<p>This paragraph contains <b>bold text</b> and <i>italic text</i>.</p>
<!-- Supported - combined formatting -->
<p>This text is <i><b>bold and italic</b></i>.</p>
<!-- Unsupported - headings don't work -->
<h1>This won't render as a heading</h1>
Lists
<!-- ⚠️ Partially supported - renders but not accessible -->
<ol>
<li>First numbered item</li>
<li>Second numbered item</li>
</ol>
<ul>
<li>First bullet point</li>
<li>Second bullet point</li>
</ul>
Links
<!-- Supported - but must be within block elements -->
<p>Visit our <a href="https://example.com">website</a> for more information.</p>
<!-- Incorrect - link not properly nested -->
<a href="https://example.com">Standalone link</a>
Scientific notation
<!-- Supported - but limited accessibility -->
<p>Water formula: H<sub>2</sub>O</p>
<p>Einstein's equation: E=mc<sup>2</sup></p>