Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 5 additions & 1 deletion src/pages/guides/getting_started/changelog.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,11 @@ contributors:

## 2025-12-28

### Changed
### Added

- **SVG image support** in [`addImage()`](../../references/addonsdk/app-document.md#addimage) - You can now import SVG files (`image/svg+xml`) to the document using the `addImage()` method.

### Updated

- [`getSelectedPageIds()`](../../references/addonsdk/app-document.md#getselectedpageids) method **promoted from experimental to stable** - Retrieve the currently selected page IDs in the document. The [`experimentalApis`](../../references/manifest/index.md#requirements) flag is no longer required to use this API.

Expand Down
10 changes: 8 additions & 2 deletions src/pages/guides/learn/how_to/use_images.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ faq:
answer: "addImage() converts animations to static images; use addAnimatedImage() to preserve animation."

- question: "What image formats are supported?"
answer: "AI, GIF, JPEG, JPG, PNG, PSD, PSDT, and WEBP. 8000px or 80MB."
answer: "AI, GIF, HEIC, JPEG, JPG, PNG, PSB, PSD, PSDT, SVG, and WEBP. Max 8192px dimension, 80MB (desktop) or 40MB (mobile), and 65 million pixels."

- question: "Are there GIF size limitations?"
answer: "Yes, refer to the FAQ section for specific GIF size and weight limitations."
Expand Down Expand Up @@ -407,7 +407,13 @@ MediaContainerNode

#### Q: What image formats are supported?

**A:** AI, GIF, JPEG, JPG, PNG, PSD, PSDT, and WEBP. 8000px or 80MB.
**A:** AI, GIF, HEIC, JPEG, JPG, PNG, PSB, PSD, PSDT, SVG, and WEBP.

**Limits:**

- Maximum dimension: 8192px (width or height)
- Maximum file size: 80MB (desktop) or 40MB (mobile)
- Maximum pixel count: 65 million pixels (width × height)

#### Q: Are there GIF size limitations?

Expand Down
10 changes: 10 additions & 0 deletions src/pages/guides/support/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -260,12 +260,22 @@ Adobe Express add-ons support importing various file types through the document
- JPG: `image/jpeg`
- PNG: `image/png`
- WebP: `image/webp`
- HEIC: `image/heic`
- GIF: `image/gif` (see [animated GIF requirements](#are-animated-gifs-supported-when-importing-or-dragging-content-to-the-document))
- SVG: `image/svg+xml`

**Design Files:**

- Illustrator files (AI): `application/illustrator`
- Photoshop files (PSD): `image/vnd.adobe.photoshop`
- Photoshop Big files (PSB): `image/vnd.adobe.photoshop`
- Photoshop templates (PSDT): `image/vnd.adobe.photoshop`

**Image Limits:**

- Maximum dimension: 8192px (width or height)
- Maximum file size: 80MB (desktop) or 40MB (mobile)
- Maximum pixel count: 65 million pixels (width × height)

**Video Files:**

Expand Down
14 changes: 11 additions & 3 deletions src/pages/references/addonsdk/app-document.md
Original file line number Diff line number Diff line change
Expand Up @@ -378,7 +378,7 @@ The options to pass into the link method.

### addImage()

Adds an image/gif/Ps/Ai files to the current page.
Adds an image/gif/PSD/AI/SVG file to the current page.

#### Signature

Expand All @@ -389,7 +389,7 @@ Adds an image/gif/Ps/Ai files to the current page.
| Name | Type | Description |
| ------------------ | ------------------------------------------- | ---------------------------------------------------------------------------------------: |
| `imageBlob` | `Blob` | The image to add to the page. |
| `attributes?` | [`MediaAttributes`](#mediaattributes) | Attributes that can be passed when adding image/Ps/Ai files to the page (i.e., `title`). |
| `attributes?` | [`MediaAttributes`](#mediaattributes) | Attributes that can be passed when adding image/PSD/AI/SVG files to the page (i.e., `title`). |
| `importAddOnData?` | [`ImportAddOnData`](#importaddondata) | Add-on specific metadata to attach to the imported asset. |

#### Return Value
Expand Down Expand Up @@ -719,7 +719,15 @@ async function importPresentationFrom(url) {

### Image requirements

When importing images, the size of the images for all types **except `gif`** images should not exceed **8000px** or **80MB**—see the full [image requirements](https://helpx.adobe.com/express/web/create-and-edit-images/change-file-formats/image-requirements.html) for more details.
When importing images, the following limits apply for all types **except `gif`** images:

- **Maximum dimension:** 8192px (width or height)
- **Maximum file size:** 80MB (desktop) or 40MB (mobile)
- **Maximum pixel count:** 65 million pixels (width × height)

**Supported formats:** AI, GIF, HEIC, JPEG, JPG, PNG, PSB, PSD, PSDT, SVG, and WEBP.

See the full [image requirements](https://helpx.adobe.com/express/web/create-and-edit-images/change-file-formats/image-requirements.html) for more details.

For `gif` images, [the technical requirements are listed here](https://helpx.adobe.com/express/create-and-edit-videos/change-file-formats/import-gif-limits.html) and summarized below for quick reference:

Expand Down
6 changes: 5 additions & 1 deletion src/pages/references/changelog.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,11 @@ contributors:

## 2025-12-28

### Changed
### Added

- **SVG image support** in [`addImage()`](./addonsdk/app-document.md#addimage) - You can now import SVG files (`image/svg+xml`) to the document using the `addImage()` method.

### Updated

- [`getSelectedPageIds()`](./addonsdk/app-document.md#getselectedpageids) method **promoted from experimental to stable** - Retrieve the currently selected page IDs in the document. The [`experimentalApis`](./manifest/index.md#requirements) flag is no longer required to use this API.

Expand Down