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

# Work with images

> Upload your own images, edit images in your project, or generate custom ones with AI.

By default, Bolt uses stock images in your project. If you want to use more personalized images that better fit with your project, you can:

* Upload your own images
* Make edits to uploaded images or stock photos that already exist in your project
* Generate custom AI images from a text prompt

Anyone can upload image files, but using AI image editing or image generation is available only on paid plans.

## Upload images

You can upload image files directly to Bolt to use as assets in your project, like a logo or a background image. Bolt supports these image formats: `.jpg` `.jpeg` `.png` `.gif` `.webp` `.svg`.

For the steps to attach a file and the file size limits, see [Attach files to your project](/building/upload-files).

## Edit images with AI

AI image editing lets you make targeted changes to images that already exist on your site. This is useful when an image is close to what you want but needs a small adjustment to better fit your project. Select an image, describe the change you want, and Bolt updates it while keeping the rest intact.

For generating brand-new images or completely replacing an existing image, use image prompts or upload a new file. Image editing is intended for modifying an existing image rather than rebuilding it from scratch.

<Frame>
  <video className="block mx-auto" src="https://res.cloudinary.com/dlq2nawz5/video/upload/f_auto,q_auto/v1765796894/edit-image_xrnphe.mp4" alt="The Bolt chatbox open with an image selected and the Edit with AI option visible." controls={true} autoPlay={true} muted={true} loop={true} />
</Frame>

1. Log in to your Bolt project.
2. In the chatbox, click **Select**.
   <Tip>
     For granular control, like if you need to select a background image, turn on **Pick from layers**. To learn more, see [Target a specific layer](/building/chat-tools#target-a-specific-layer).
   </Tip>
3. Click the image you want to edit.
4. In the chatbox, click **Edit with AI**.
5. Describe the changes you want to make, then click the **blue arrow icon** to generate.
6. Use the slider to preview the old and new images.
7. Click **Use this image**.

## Generate AI images

Because generating custom images uses more tokens than using stock images, you need to turn on this feature in your personal settings before you can prompt Bolt to create images.

After you have image generation turned on, you can describe what you want in the chat and Bolt generates a ready-to-use image for your project. This is useful when stock images don't match the look you're going for and you want something built around your specific vision.

Generated images can include transparent backgrounds for easy placement in designs, and all output is automatically converted to WebP format for fast loading and efficient web performance.

To turn on image generation:

1. Log in to a Bolt project.
2. Click **your avatar** in the top-right corner of the screen.
3. Click **Settings**.
4. In the left navigation menu, under **Account**, click **Add-on features**.
5. Turn on **Image Generation**.

After you turn on this setting, Bolt can generate images in any project.

<Tip>
  To get the best result, make your prompt as specific as possible about the subject, style, and where the image should appear.
</Tip>

To generate an image, describe what you want in the chat.

<Frame>
  <video className="block mx-auto" src="https://res.cloudinary.com/dlq2nawz5/video/upload/f_auto,q_auto/v1771273302/generate-image_ls5ydn.mp4" alt="AI image generation in the Bolt chatbox." controls={true} autoPlay={true} muted={true} loop={true} />
</Frame>

<Info>
  Make sure any published or deployed content complies with applicable rights and laws.
</Info>
