Create a Bulleted List Through the Google Docs API

The Google Docs API creates list formatting through paragraph-bullet requests. Insert or identify real paragraph boundaries first; typing bullet characters into ordinary text does not establish the same list structure.

Prepare the paragraphs

1. Read the target tab and its current content.
2. Identify or insert the intended item paragraphs separated by newlines.
3. Calculate the resulting UTF-16 range.
4. Choose the documented bullet preset that fits the list’s hierarchy.

When text insertion and list creation share a batch, account for the updated indexes. The server processes subrequests in order, so later ranges must correspond to the state after earlier operations.

Create the actual list

Use createParagraphBullets with the target range, tab ID, and supported bulletPreset. Google’s guidance includes presets with different markers at successive nesting levels.

All paragraphs overlapping the range can receive bullets, including paragraphs inside table cells. A slightly overbroad selection can therefore affect more material than the visible first item suggests.

Check nesting and index changes

Leading tabs determine nesting levels, and those tabs are removed when bullets are created. That removal can shift indexes used by later operations. To change an existing item’s nesting, follow the documented remove-and-recreate approach rather than assuming a direct level adjustment.

Reread the resulting list and neighboring paragraphs. Check marker hierarchy, item order, and any paragraph that should remain ordinary prose. Test on controlled content before deployment and guard stale writes appropriately. A correctly formed list request does not independently verify the logic or completeness of the procedure expressed by its items.

References

• Work with lists  |  Google Docs  |  Google for Developers
• Structural edit rules and behavior  |  Google Docs  |  Google for Developers

Reviewed against the linked official product guidance on November 3, 2026. Features, limits, screen labels, and access can vary by account, platform, region, and organization policy.