# Canvas Editor
### When to Use Canvas Editor
**Use Canvas when you need precision that a text prompt alone can't provide:**
* You want to change a **specific region** of an image (not the whole thing)
* You need to **erase an object** in a precise area
* You want to **add or replace an element** in a specific spot using a brush mask
* You're **compositing** — placing one image into another
**Stick to plain image-to-image (no Canvas) when:**
* You want a global change across the whole image ("make it warmer", "change the style")
* You're doing iterative prompt refinement and don't need region control
* Speed matters more than precision
### How It Works
1. **Generate or upload an image** - Create an image or upload existing one
2. **Click "Edit" button** - Opens the Canvas Editor modal
3. **Use editing tools** - Draw, select, annotate, add elements
4. **Describe your edits** - Type what you want to change
5. **Apply changes** - AI processes your annotations and edits
6. **Iterate** - Make additional changes as needed
### Opening the Canvas Editor
#### From Generated Images
1. **Generate an image** using any image model
2. **Click "Edit" button** on the image thumbnail
3. **Canvas Editor opens** with your image loaded
#### From Uploaded Images
1. **Upload an image** to the composer
2. **Click "Edit" button** on the image thumbnail
3. **Canvas Editor opens** ready for editing
### Available Tools
Brush tool
* Draw freehand selections
* Paint areas to modify
* Adjustable brush size
* Perfect for organic shapes
Rectangle Tool
* Draw rectangular selections
* Precise box selection
* Good for defined areas
* Multiple selections supported
Ellipse Tool
* Draw circular/oval selections
* Perfect for round objects
* Precise circular areas
Arrow Tool
* Draw arrows to indicate direction
* Show movement or rotation
* Point to specific areas
* Useful for repositioning
Text Tool
* Add text overlays
* Type annotations
* Label elements
* Create text graphics
Add Image
* Upload additional images
* Compose multiple elements
* Layer images together
* Create complex scenes
### Editing Workflows
#### Removing Objects
1. **Open Canvas Editor**
2. **Select the Brush or Rectangle tool**
3. **Draw over the object to remove**
4. **Type:** "Remove this" or "Delete this object"
5. **AI removes the selected area**
#### Adding Elements
1. **Open Canvas Editor**
2. **Draw a selection where the element should go**
3. **Type:** "Add \[element] here" or "Place \[object] in this area"
4. **AI adds an element to selection**
#### Modifying Objects
1. **Open Canvas Editor**
2. **Select the object to modify**
3. **Type:** "Change color to \[color]" or "Make this \[style]"
4. **AI modifies the selected area**
#### Replacing Subjects
1. **Open Canvas Editor**
2. **Upload replacement image**
3. **Select an area to replace**
4. **Type:** "Replace with uploaded image" or "Swap this"
5. **AI replaces the subject**
#### Text Overlays
1. **Open Canvas Editor**
2. **Use the Text tool**
3. **Type your text**
4. **Position and style text**
5. **Text rendered as overlay**
### Supported Models
Canvas Editor works best with:
| Model | Canvas Support | Best For |
| ------------------- | -------------- | ------------------------------------- |
| **GPT Image 2** | ✅ Full support | Composition, layers, advanced editing |
| **Nano Banana Pro** | ✅ Full support | Multi-image composition |
| **Flux 2 Max** | ✅ Full support | High-quality editing |
| **Seedream v5** | ✅ Full support | Creative editing, 2K resolution |
| **Grok** | ✅ Full support | Fast editing, mobile formats |
| **Z-Image Turbo** | ✅ Full support | Quick edits |
### Tips for Best Results
1. **Be specific in selections** - Clear selections = better results
2. **Use appropriate tools** - Brush for organic, rectangle for precise
3. **Describe changes clearly** - "Remove this" vs. "change something."
4. **Iterate** - Make changes in steps rather than all at once
5. **Use composition mode** - Upload images for complex composites
6. **Text overlays** - Use annotation mode for graphics
### Troubleshooting
#### "Changes not applying correctly."
**Solutions:**
* Ensure selections are clear and visible
* Be more specific in your description
* Try different selection tools
* Check that pipeline mode is correct
#### "Wrong area being modified."
**Solutions:**
* Make selections more precise
* Use the rectangle tool for exact areas
* Be specific about the location in the prompt
* Try smaller, more focused selections
#### "Canvas Editor not opening"
**Solutions:**
* Ensure you have an image attached
* Click the "Edit" button on the image thumbnail
* Check that the model supports Canvas Editor
* Try refreshing or reopening
***
**Next:** Learn about [Background Removal ](/features/image-generation/background-removal.md)for automatic background removal.
---
# 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://docs.chatvideopro.com/features/image-generation/canvas-editor.md?ask=
```
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.