---
title: "Uploading and managing images"
slug: "uploading-and-managing-images"
updated: 2026-01-15T17:34:07Z
published: 2026-01-15T17:34:07Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.deltatre.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Uploading and managing images

This article explains how to upload and manage images for assets, links, lists, and channels.

---

## Uploading new images

Images are at the heart of users' interaction with your apps and are also key to content discovery. In AXIS, add images in a variety of formats for your [assets](/v1/docs/assets), [channels](/v1/docs/channel-assets), [links](/v1/docs/link-assets), and [lists](/v1/docs/lists).

The upload process is similar for each of the content types. To get started, navigate to the relevant location in Presentation Manager:

1. To add images to an **asset**, **channel**, or **link**, go to the *Assets* menu and then select either *Items*, *Channels*, or *Links*, as required. ![Navigation_-_Assets__channels__links.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/7550091028380.png)
2. To add images to a **list**, go to the *Display* menu, find the list, and then select *Images* in the left-hand navigation menu.

![Navigation_-_Lists.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/7549916846876.png)

Search for and select the content that you want to add an image to, then select *Images* in the left-hand navigation menu.

![Images_tab_navigation_-_Assets.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/7550220086556.png)

To add an image:

1. Either select the ![](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/360009573319.png) link in the top right-hand side, or select a pre-defined size template from the options provided on the page — the options will vary depending on the content type. Hover over a template to see the image dimensions.

![Image_templates_-_lists.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/7539087468316.png)

2. Drag and drop the image file into the *Add Images* pane, or select ![](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/360009574499.png) to open your computer's file explorer and navigate to the image you want to upload.

> [!NOTE]
> **Notes:**
> 
> 1. The maximum data size for an image(s) upload is *10MB*and the maximum dimensions are *3840 x 2160 pixels (4K)*. For details on pixel resolutions, see the [Imagery and pixel resolutions](/v1/docs/uploading-and-managing-images#imagery-and-pixel-resolutions) section.
> 2. Supported image formats are *.jpeg, .png, .bmp, and .tiff.*
> 3. If an image is cropped, the data size is the total size of the cropped image, not the original image file size. The size of a cropped image depends on the image format and the dimensions of the image.
> 4. To avoid bandwidth issues, for general imagery, we recommend *.jpeg* files (unless your Reference Apps display *.png* images), and for baked text or logos, we recommend *.png* files.
> 5. For any assets without a specified thumbnail image, a placeholder image displays default.

![Upload_image.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/8936609759004.png)

Once uploaded, the selected image is displayed in the preview area - multiple image uploads are supported. AXIS detects the image size and automatically selects the appropriate image type (or makes a best guess based on the ratio of the uploaded image). A green dashed outline is visible around the outer edge of the image. This represents the bounding box of the pre-selected image type.

To add more images, drag and drop or select the *To add more, drag & drop or choose images* link.

![Upload 2 images.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/11494208240924.png)

#### Changing asset thumbnails

> [!WARNING]
> **Compatibility note:** Changing asset thumbnails for Channels, Links, and Assets is supported from [AXIS 9.9](/v1/docs/axis-99-q4-23) onwards.

The default thumbnail placeholder image is as follows:

![thumbnail default.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/11761197933724.png)

To change the asset's thumbnail:

1. Hover over the thumbnail to display the *edit* icon.
2. Select the edit icon to choose a new thumbnail image. ![thumbnail hover.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/11761151342364.png)

#### Cropping and adjusting images

Changing the selected image type usually results in your image being cropped.

If you need to change the pre-selected option, use the dropdown to select a different size template, then reposition your image as needed.

The lighter portion of the image represents the area within the selected image dimensions, while the darker area will be cropped when you upload.

> [!NOTE]
> **Note:**As of [AXIS 9.9](/v1/docs/axis-99-q4-23), when uploading and cropping multiple images, Presentation Manager retains the image cropped state when switching to another image.

![Crop_image.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/8950320679452.png)

#### Dimensions and file size

The **dimensions indicator** and **file and cropped image data** **indicator** both display beneath the image preview.

Image metadata is included in the cropped image data, which can cause cropped images to have a larger file size than the original image.

![Data.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/8950482374684.png)

#### Imagery and pixel resolutions

This section details the image type and the pixel resolution.

Images scale automatically, but we recommend using the documented pixel resolution below for optimized image quality.

| Image type | Pixel resolution |
| --- | --- |
| 2:3 Poster | 720 x 1080 px |
| 16:9 Tile | 1024 x 576 px |
| 4:3 Block | 1200 x 900 px |
| 16:9 Wallpaper | 1920 x 1080 px |
| 2:3 Poster Wallpaper | 720 x 1080 px |
| 1:1 Square | 1024 x 1024 px |
| 3:1 Hero | 1920 x 640 px |
| 4:3 Hero Block | 1200 x 900 px |
| 7:1 Banner | 1920 x 274 px |
| 1:2 Tall | 600 x 1200 px |
| 2:1 Wide | 1800 x 900 px |
| Branded Title | Any x Any (sales to fill given area) |
| Badge | Any x Any (scales to fill given area) |
| Logo | Any x Any (scales to fill given area) |
| Custom | Any x Any (scales to fill given area) For full-width TVs in full HD, we recommend images with 1920 x 1080 px. |

#### Resolution warnings

If choosing an image size template in AXIS Presentation Manager results in a warning icon, the uploaded image doesn't conform to the original image template. Ignoring the resolution warning and uploading the image reduces the image quality. The uploaded image won’t be at the optimum resolution for the chosen image size, likely resulting in poor quality app imagery.

![Resolution_warning.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/8937135710748.png)

#### Confirm upload

When you're happy with your uploaded images, save your changes by selecting the *Confirm Upload* button.

If you select *Cancel* instead, the image is not uploaded and is deleted from the system.

### Changing the active image

#### What is an *active* image?

The left-most image of any type is flagged as the active image. Indicated by the ![Active_Images_icon.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/7546217109404.png)icon. If you only have one image of a type (say, *2:3 Poster*) uploaded, it will be the active image by default. If you have more than one, then the left-most image — usually the first one uploaded — is active and is the one retrieved and displayed in users' apps.

![Active_images.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/7546321889052.png)

#### Can I change the active image?

Yes, you can select a different active image if you have more than one of the same type uploaded. To do this:

1. Hover over the image you want to activate and check the ![Activate_checkbox.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/7546364328988.png) icon
2. The selected image is now the active image of that type
3. The image order changes and the previous active image is now on the right

![Activate_new_image.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/7546354671004.png)

### Viewing and managing images

The image gallery displays all the images you've saved for the item. From here you can activate, view, crop, and delete your images.

To **zoom in** for a full-screen view of your image, hover over the image and select the ![Zoom_in.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/7547114695324.png) icon. This opens the image in a new browser tab.

To **delete** an image, hover over the image and select the ![Delete_image.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/7547149225628.png) icon, then *Confirm*in the confirmation window.

![Remove_image_confirmation.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/7547227825692.png)

When you've finished uploading or managing images, remember to save and update to apply your changes.

### Adding image language options

> [!WARNING]
> **Compatibility note:**Multi-language image settings are available from [AXIS 9.7](/v1/docs/axis-97-q1-23) onwards.

Newly uploaded images are automatically set as the default image. From [AXIS 9.7](/v1/docs/axis-97-q1-23) onwards, show users different images depending on their language settings or location. This is particularly useful where you have images that incorporate text in different languages, or where there are specific regional requirements for the images displayed in user's apps.

Create image language options by setting up a separate image tab for each language you wish to add.

1. Select the ![Select_new_image_language_tab.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/7545724277148.png) next to the *Default* tab.
2. Select a language from the list.

![Image_language_options.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/7539748654236.png)

A new image tab page is created, labeled with the selected language. Upload images for this language option following the steps described earlier in this article. When the content is published, users are shown the image that corresponds to the language setting in their app.

### Deleting image language options

If you decide you no longer need the additional language options for your images, they are easily removed. This works in the same way as for other types of [variants](/v1/docs/variants-and-segmentation). Simply select the arrow on the tab, followed by *Delete*. This deletes the language option and all the images it contains.

It's important to note that the *Default* tab can't be deleted.

![Delete_image_language_option.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/7545424412956.png)

> [!NOTE]
> **Note**: Creating a new language tab without uploading any images results in the tab being removed when saved.