# Images

To help you create higher-quality apps right from the start, we’ve added support for images in AI-generated projects. This means your apps include visuals automatically when they’re created, and you can easily update or replace those images at any time.

### Creating a Project with Images

#### New Projects

When you [create a new project](/getting-started/quickstart.md#id-1-project-generation-prompt), the AI automatically adds images to your app.

* If you want images included, simply mention this in your prompt.
* Be as specific as possible about the type of images you want (for example, illustrations, photos, backgrounds, or icons).

#### Existing Projects

To add images to an existing project:

* Write a clear prompt explaining exactly what images you want the AI to add.
* The AI will generate and place the images based on your instructions.

### Updating images

To update an existing image:

1. Click on the image in your project.
2. A pop-up will appear.
3. Choose a new image from Unsplash or upload your own image.

As always, you can also [ask the AI to update images](/getting-started/quickstart.md#id-2-builder-screen-components) for you or [make changes directly in the code](/getting-started/quickstart.md#editing-code).

### Image Size Limits

* **Maximum size per image:** 5 MB
* **Total app assets size:** 50 MB

If you exceed the total asset size limit:

1. Open the **Project Assets** tab in the pop-up.
2. Hover over an image.
3. Click the delete icon to remove it.

### Other types of images

Some images, such as icons used in navigators, buttons, or other UI elements, are handled differently.

* To update these images, ask the AI to make the change for you **or** [edit the code directly](/getting-started/quickstart.md#editing-code).

**App Icon**

You can set your app’s icon when you [publish your app to Android or iOS](/publishing/publishing-overview.md) by clicking on the Upload icon button:

<div align="left"><figure><img src="/files/oqlZcFfkeycLdVyXYfGa" alt="" width="563"><figcaption></figcaption></figure></div>

<figure><img src="https://docs.thunkable.com/~gitbook/image?url=https%3A%2F%2F1223006790-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-LAn5scXl2uqUJUOqkJo-84897653%252Fuploads%252FgYoZav1W78dzrp8ns410%252FPublish%2520ios.png%3Falt%3Dmedia%26token%3D9a9341a9-f367-4f89-91f5-90c70d3f4667&#x26;width=768&#x26;dpr=3&#x26;quality=100&#x26;sign=5e497f77&#x26;sv=2" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://aidocs.thunkable.com/app-design/images.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.