List repair guide

Fix PDF list tags: bullets, numbering, and nested lists

Diagnose lists exported as paragraphs, repair list structure and nesting, and check how bullets and numbered steps are announced.

Updated November 1, 2026. Reviewed by the DocAccessible team under our editorial policy.

Repair a PDF list by identifying its items and nesting, inspecting the corresponding structure, and correcting the relationship between labels and content. A bullet character at the start of a line can look like a list while the PDF exposes unrelated paragraphs. Conversely, ordinary prose containing a number does not automatically belong in a list. Begin with the author's intended organization.

Recognize the boundaries of the list

Use an illustrative application procedure with three main steps. The second step has two acceptable evidence options and a paragraph explaining an exception. A useful representation should preserve three main steps, place the options inside step two, and keep the exception with the step it qualifies. Turning every line into a separate item would change the procedure even if the page looked identical.

Before editing, mark the start and end of each item in a review copy. Decide whether order matters, whether labels restart intentionally, and whether any continuation across pages belongs to the same item. If the source file is available, use its list features and re-export before undertaking a fragile repair in the PDF. Confirm the new export rather than assuming the source change was sufficient.

Understand the four common list roles

W3C technique PDF21 explains the relationship between L, LI, Lbl, and LBody. The list groups items; the item groups its label and content. A label can be a bullet or number, while the body carries the item's meaning and may include additional structure. This is different from treating each visible line as a standalone paragraph.

Illustrative logical outline, not a complete PDF object representation
L
  LI
    Lbl: 1.
    LBody: Complete the application.
  LI
    Lbl: 2.
    LBody
      P: Provide one form of evidence.
      L
        LI: Option A
        LI: Option B
      P: Ask the coordinator if neither option is available.
  LI
    Lbl: 3.
    LBody: Submit the application.

The outline illustrates the main relationship; a real PDF also needs correctly associated content and the attributes required by its target profile. Renaming a tag without fixing its children or content association does not complete a repair. Inspect what the structure element actually contains.

Repair the specific mismatch

Illustrative list problems and review targets.
Observed problemWhat to investigate
All bullets appear inside one paragraphWhether each intended item has its own list-item structure
A continued sentence becomes a new itemWhether line wrapping was mistaken for a semantic boundary
A substep is announced as a main stepWhether the nested list is associated with the correct parent item
A paragraph after step two is detachedWhether the qualification belongs inside that item's body
Numbering restarts unexpectedlyWhether the source numbering and the PDF's list information express the intended sequence

The PDF Association's list-technique examples include passing and failing treatments of labels, nested content, numbering, and lists spanning pages. Use those examples to compare the pattern you are repairing. They are useful evidence about structure; they do not decide whether an editorial sequence is correct for your document.

Handle glossaries and other non-bullet lists deliberately

A glossary can express term-and-definition relationships without visible bullets. The PDF Association's accessibility glossary describes definition lists using labels for terms and bodies for their definitions. Decide whether that pattern matches the material. A visually aligned pair of columns can otherwise leave the relationship implicit.

For a fictional application glossary, 'Sponsor' and its definition belong together; 'Coordinator' and its definition form another entry. Ask a reviewer to navigate to a term and explain its definition without relying on left-right visual alignment. That task checks the intended relationship more directly than a screenshot of two neat columns.

Test the finished reading sequence

  1. Compare every intended main item with the logical structure and check that no item was omitted or duplicated.
  2. Navigate the list in a suitable viewer and screen reader, recording how main and nested items are exposed.
  3. Read the entire second step, including its nested options and explanatory paragraph, before moving to step three.
  4. Check any page break without assuming that a new page creates a new list or a new item.
  5. Run the selected structural validation and resolve findings against the actual PDF version and profile.

Keep the repaired PDF, source revision if available, and review notes together. Explain the meaningful correction in the record, such as 'exception paragraph now remains within step two', rather than only saying 'tags fixed'. If the list changes later, use that record to repeat the relevant checks.

The PDF tag viewer can help inspect the hierarchy, while the screen-reader guide supports the navigation test. For a source workflow that repeatedly loses lists, revisit the authoring export route so the repair does not have to be recreated for every revision.

Frequently asked questions

Does a bullet character make a PDF paragraph a list item?

A visible bullet can be ordinary text without a list relationship in the PDF structure. Inspect the logical representation and test navigation, rather than deciding from the appearance of the line alone.

Should a wrapped line become another list item?

A line wrap is a layout event, not necessarily a new item. Keep all content belonging to the same instruction together, including continuation paragraphs and nested options, and verify the resulting reading sequence.

Can a glossary be represented as a list?

A term-and-definition glossary can use a definition-list structure when that matches the content. Preserve the association between each term and its explanation, and check that a reader can reach the correct definition without relying on visual columns.

Sources

The statements above rest on the primary sources below. Where a source is a law or standard, the version and date named in the text are the ones checked on the review date. This guide is general information, not legal advice.

  1. W3C PDF21: Using list tags
  2. PDF Association: Accessibility techniques for lists
  3. PDF Association: Accessibility terminology glossary . Definition lists and structure relationships.

Keep reading