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 Word document
doc = Document()

# Create a new document
doc = Document()

# Add a heading with level=1 to the document
doc.add_heading('Hello!', level=1)

# Add a paragraph to the document
doc.add_paragraph("Adding an image below")

doc.add_picture('input_image.png', width=Inches(2), height=Inches(2))

doc.add_paragraph("Added CodeFriends logo.")

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

# Inserting and Styling Images in Your Document

When working on a document, there are times when you need to insert `images` to help convey the content more intuitively.

Using *python-docx*, you can programmatically insert images into a document and adjust their size and position.

In this lesson, we will learn how to **insert and resize images** in your document.

<br />

## Inserting an Image

To insert an image into your document, use the `add_picture()` method.

This method takes the file path as an argument and adds the image to the document.

```python title="Inserting an Image"
doc.add_picture('image.png')
```

The code above inserts the 'image.png' file into the document.

The image file path can be specified using a relative path or an absolute path.

<br />

## Resizing an Image

After inserting an image, you can use the `Inches` or `Cm` classes to resize it.

This is useful for adjusting the width or height of an image to the desired size.

```python title="Resizing an Image"
from docx.shared import Inches

doc.add_picture('image.png', width=Inches(2))
```

The code above sets the width of the image to 2 inches when inserting it into the document.

If the height is not specified, it will be automatically adjusted to maintain the aspect ratio.

```python title="Adjusting Both Width and Height of an Image"
doc.add_picture('image.png', width=Inches(2), height=Inches(3))
```

This example sets the width to 2 inches and the height to 3 inches when inserting the image.

<br />

## Can We Precisely Adjust the Image Position?

With *python-docx*, you cannot precisely position an image in terms of how far from the top or left it should appear.

Therefore, if precise image positioning is needed, it is best to insert the image programmatically first and then manually adjust its position by opening the Word file.

By using the python-docx library, you can easily insert images into a document with the `add_picture()` method. This is helpful for enhancing the visual appeal of the document.

### Using python-docx, you can insert images into a document.

Inserting and Styling Images in Your Document