> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.laposta.org/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.laposta.org/_mcp/server.

# Placing and editing an image in a Joe template

> How to place, crop, scale or move fixed and scalable images in your Joe template.

If you are working with a custom template of [the Joe type](/begrippenlijst#joe), you create your newsletter in a dedicated editor. In a template like this, you can have several types of image blocks programmed. The block type determines what you can do with the image: a fixed image is in a fixed position and is required, while a scalable image can be moved, resized or omitted.

If you are working with a regular drag & drop newsletter, please refer to [Adding an image to your newsletter](/hoe-voeg-ik-een-afbeelding-aan-mijn-nieuwsbrief-toe).

## Adding an image

Click on the placeholder image in your newsletter. In the window that opens on the left, click on ‘Select’ and choose an image from your computer. In the same window, you can add a link behind the image and enter alt text.

![The window on the left in the Joe editor showing the Select button, the link field and the alt text field](file:assets/images/schermen-en/b3-02.png)

> **Note**
>
> If you are creating a digitally accessible newsletter, always enter alt text. Screen readers read this text aloud, so it should describe the image. See: [Alt text for an image](/kan-ik-een-alt-tekst-plaatsen-bij-de-afbeelding-in-mijn-nieuwsbrief).

## Cropping a fixed image

A required placeholder image often shows a suggested size, for example 300 x 200. Sticking to this size ensures a balanced design and structure for your newsletter.

You can crop your image to this size in the [image editor](/afbeeldingen-bewerken): first scale the image by width, then select the crop area. You can also choose a different size, as long as you follow the same order.

#### Open the image editor

Click on ‘Edit’ in the image.

#### Go to Transform

On the left side of the editor, click on the second icon from the top.

#### Scale the image by width

Tick ‘Lock resolution’ and enter the suggested width under ‘Crop size’, for example 300. Press Tab so the height scales automatically, and click on ‘Save’.

#### Open Transform again

Click on ‘Edit’ in the image again and go back to ‘Transform’.

#### Enter the desired size

Do not tick ‘Lock resolution’ this time, and enter the desired width and height under ‘Crop size’, for example 300 (W) x 200 (H).

#### Select your crop area and save

A selection box in the correct aspect ratio will appear over your image. Drag it over the part of the image you want to use and click on ‘Save’.

## Adjusting or omitting a scalable image

You can adjust a scalable image directly within the text block:

* Resize: drag the bottom-right corner of the image with your mouse.
* Change position: hover your mouse over the text in the block and click on the arrow on the left or right of the block. Click the arrow again to alternate placing the image on the left, on the right, or across the full width.
* Omit image: click on the cross in the top-right corner of the image. The block will then become a regular text block. To bring the image back, click on ‘Make image visible’ on the left of your screen, below the text section of the editor.

![The text block with the scalable image on the right and an arrow on both sides to move the image](file:assets/images/schermen-en/b17-08-schaalbaar.png)

If not all images in your template are loading, this is not caused by editing, but by how the template loaded: [here is how to reload the template](/waarom-worden-sommige-afbeeldingen-in-mijn-sjabloon-type-joe-niet-getoond).

## Related articles

#### [Adding an image to your newsletter](/hoe-voeg-ik-een-afbeelding-aan-mijn-nieuwsbrief-toe)

How to place and edit an image in your newsletter, make an image clickable or set a…

#### [Working with the legacy Joe editor](/hoe-werkt-de-editor-bij-een-joe-verouderd)

Place, fill and move blocks in your custom Joe template and read what you can edit…

#### [Straightening a rotated image](/mijn-afbeelding-is-gedraaid-hoe-pas-ik-dit-aan)

In the image editor, you can rotate or straighten an image that is on its side or…

#### [Using the Joe editor](/hoe-werkt-onze-joe-editor)

Place blocks, edit text and images, load an RSS feed and view the preview of your…