lesson1Title

lesson2Title

lesson3Title

lesson4Title

lesson5Title

lesson6Title

lesson7Title

lesson8Title

lesson9Title

lesson10Title

lesson11Title

lesson12Title

lesson13Title

lesson14Title

lesson15Title

lesson16Title

lesson17Title

automationIntroBasicsChapter2Title

lesson18Title

automationIntroBasicsChapter1Title

automationIntroBasicsChapter3Title

automationIntroBasicsChapter4Title

from docx import Document
from docx.shared import Inches

# Create a new document
doc = Document()

# Create a table with 3 rows and 2 columns
table = doc.add_table(rows=3, cols=2)

# Apply a grid style to the table to include borders
table.style = 'Table Grid'

# Fill each cell in the table with numbers from 1 to 6
for i in range(3):  # Iterate over rows
    for j in range(2):  # Iterate over columns
        table.cell(i, j).text = str(i * 2 + j + 1)  # Insert numbers 1 to 6 into cells

# Add a new row to the table
row = table.add_row()

# Insert text into the first cell of the newly added row
row.cells[0].text = "New Cell"

# Add a new column to the table with a width of 1 inch
table.add_column(Inches(1))

# Select the first cell of the first row
a = table.cell(0, 0)

# Select the second cell of the first row
b = table.cell(0, 1)

# Merge the first and second cells of the first row
a.merge(b)

# Save the document as 'output_file.docx'
doc.save('output_file.docx')

# How to Create Tables with Python Code

When creating a simple table, using the `Table` feature of a word processing program is convenient.

However, when you need to insert **large amounts of data** into a table or **automate repetitive table creation**, it is best to use the *python-docx* library.

In this lesson, we will learn how to add tables to a Word file using *python-docx*.

> *Note*: The data visualized in the tables is defined as Python lists for ease of understanding. However, it is common to use the `pandas` library to read `CSV` files from *file paths* or *URLs* in practice.

 

## add_table()

This method is used to add a table to a document.

You use it like `document.add_table(rows, cols)` where

- `rows`: number of rows

- `cols`: number of columns

are specified.

```python title="Add a Table"
from docx import Document

doc = Document()

# Create a table with 3 rows and 2 columns
table = doc.add_table(rows=3, cols=2)
```

 

## table.cell(row, col)

Access a specific cell to set or retrieve its value.

Use it like `table.cell(row, col)`, where `row` is the row number (starting from 0) and `col` is the column number (starting from 0).

```python title="Add Text to a Cell"
# Cell at the first row, first column
cell = table.cell(0, 0)
```

 

## cell.text

Set or retrieve the text in a cell.

 ```python title="Add Text to a Cell"
# Cell at the first row, first column
cell = table.cell(0, 0)

# Add text to the specified cell
cell.text = "Hello"
```

 

## table.style

Set the style of the table.

To create a table with borders, use `table.style = 'Table Grid'`.

```python title="Set Table Style"
doc = Document()

table = doc.add_table(rows=3, cols=2)

# Create a table with solid borders
table.style = 'Table Grid'
```

 

## table.add_row()

This method adds a new row to the table.

Add a new row with `table.add_row()`.

```python title="Add a New Row"
row = table.add_row()

row.cells[0].text = "New Cell"
```

 

## table.add_column()

This method adds a new column to the table.

Add a new column with `table.add_column(width)` where you specify the width.

You must specify the width when adding a column.

```python title="Add a New Column"
from docx.shared import Inches

table.add_column(Inches(1))
```

 

## cell.merge(other_cell)

This method merges cells.

The code below is an example of merging the first two cells in the first row.

```python title="Merge Cells"
a = table.cell(0, 0)
b = table.cell(0, 1)
a.merge(b) # Merge the first two cells in the first row
```

The method to add a row to a table is table.add_row().

How to Create Tables with Python Code

add_table()

table.cell(row, col)

cell.text

table.style

table.add_row()

table.add_column()

cell.merge(other_cell)

What method is used to add a row to a table in python-docx?