Update Paragraph Style
update_paragraph_styleApply heading styles, list formatting, and paragraph properties like alignment, spacing, and indentation to a selected range in Google Docs.
Instructions
Apply paragraph-level formatting, heading styles, and/or list formatting to a range in a Google Doc.
This tool can apply named heading styles (H1-H6) for semantic document structure, create bulleted or numbered lists with nested indentation, and customize paragraph properties like alignment, spacing, and indentation. All operations can be applied in a single call.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tab_id | No | Optional document tab ID to target | |
| alignment | No | Text alignment - 'START' (left), 'CENTER', 'END' (right), or 'JUSTIFIED' | |
| direction | No | Paragraph direction - 'LEFT_TO_RIGHT' or 'RIGHT_TO_LEFT' | |
| end_index | Yes | End position (exclusive) - should cover the entire paragraph | |
| list_type | No | Create a list from existing paragraphs ('UNORDERED' for bullets, 'ORDERED' for numbers, 'CHECKBOX' for checklists) | |
| indent_end | No | Right/end indent in points | |
| segment_id | No | Optional header/footer/footnote segment ID to target | |
| border_dash | No | Border dash style ('SOLID', 'DOT', or 'DASH'; defaults to 'SOLID') | |
| document_id | Yes | Document ID to modify | |
| space_above | No | Space above paragraph in points (e.g., 12 for one line) | |
| space_below | No | Space below paragraph in points | |
| start_index | Yes | Start position using Docs API indices from inspect_doc_structure. For the main body, 0 is also accepted as an alias for the first writable position. | |
| border_color | No | Border color (#RRGGBB; defaults to black) | |
| border_edges | No | Paragraph border edges to update ('top', 'bottom', 'left', 'right', or 'between'); omit to update all four outer edges | |
| border_width | No | Border width in points (defaults to 1) | |
| indent_start | No | Left/start indent in points | |
| line_spacing | No | Line spacing multiplier (1.0 = single, 1.5 = 1.5x, 2.0 = double) | |
| spacing_mode | No | 'NEVER_COLLAPSE' or 'COLLAPSE_LISTS' | |
| bullet_preset | No | Optional explicit Google Docs bullet preset | |
| heading_level | No | Heading level 0-6 (0 = NORMAL_TEXT, 1 = H1, 2 = H2, etc.) Use for semantic document structure | |
| shading_color | No | Paragraph shading/background color (#RRGGBB) | |
| border_padding | No | Border padding in points (defaults to 4) | |
| keep_with_next | No | Keep the paragraph with the next paragraph | |
| named_style_type | No | Direct named style type - 'NORMAL_TEXT', 'TITLE', 'SUBTITLE', 'HEADING_1' through 'HEADING_6'. Mutually exclusive with heading_level. | |
| indent_first_line | No | First line indent in points (e.g., 36 for 0.5 inch) | |
| page_break_before | No | Start the paragraph on a new page | |
| user_google_email | Yes | User's Google email address | |
| list_nesting_level | No | Nesting level for lists (0-8, where 0 is top level, default is 0) Use higher levels for nested/indented list items | |
| keep_lines_together | No | Keep all lines of the paragraph together | |
| avoid_widow_and_orphan | No | Avoid widows/orphans for the paragraph |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |