Sphinx error: Error parsing content block for the “list-table” directive: uniform …-level bullet list expected, but row … does not contain the same number of items as row … (… vs …)

Did you Sphinx documentation project has failed with the error Error parsing content block for the “list-table” directive: uniform …-level bullet list expected, but row … does not contain the same number of items as row … (… vs …)? This guide provides an explanation and solution to resolve the issue.

Symptom

Sphinx build failed with the error similar to:

WARNING: Error parsing content block for the "list-table" directive: uniform two-level bullet list expected, but row 3 does not contain the same number of items as row 1 (3 vs 2).

Worry-free Sphinx?

Documatt app is a Sphinx-based tool which hides its complexity with free hosting for your books and docs.

Try free 14 day trial Watch the demo

Reason

Table created with list-table:: directive, must have the same number of columns (bullet list items) in all rows. The warning above says that row XY has more or less columns (bullet list items) that the rest of the table.

Example

Row 1 and 2 has 2 columns. Row 3 contains 3 columns.

.. list-table::

   * - row 1, column 1
     - row 1, column 2
   * - row 2, column 1
     - row 2, column 2
   * - row 3, column 1
     - row 3, column 2
     - row 3, column 3

Solution

Delete extra column, or add extra column to all rows.

.. list-table::

   * - row 1, column 1
     - row 1, column 2
   * - row 2, column 1
     - row 2, column 2
   * - row 3, column 1
     - row 3, column 2