From 918b47bf6e3fead8873d7b29f340f4b879e11de6 Mon Sep 17 00:00:00 2001 From: Holly Schinsky Date: Sun, 28 Dec 2025 18:40:59 -0500 Subject: [PATCH] Updates addImage to include support for SVG and missing HEIC(faqs too) --- src/pages/guides/getting_started/changelog.md | 6 +++++- src/pages/guides/learn/how_to/use_images.md | 10 ++++++++-- src/pages/guides/support/faq.md | 10 ++++++++++ src/pages/references/addonsdk/app-document.md | 14 +++++++++++--- src/pages/references/changelog.md | 6 +++++- 5 files changed, 39 insertions(+), 7 deletions(-) diff --git a/src/pages/guides/getting_started/changelog.md b/src/pages/guides/getting_started/changelog.md index 6567cedca..d5adaf643 100644 --- a/src/pages/guides/getting_started/changelog.md +++ b/src/pages/guides/getting_started/changelog.md @@ -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. diff --git a/src/pages/guides/learn/how_to/use_images.md b/src/pages/guides/learn/how_to/use_images.md index 6b8659309..7961ada01 100644 --- a/src/pages/guides/learn/how_to/use_images.md +++ b/src/pages/guides/learn/how_to/use_images.md @@ -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." @@ -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? diff --git a/src/pages/guides/support/faq.md b/src/pages/guides/support/faq.md index 96b1f5498..35d9a16ee 100644 --- a/src/pages/guides/support/faq.md +++ b/src/pages/guides/support/faq.md @@ -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:** diff --git a/src/pages/references/addonsdk/app-document.md b/src/pages/references/addonsdk/app-document.md index 633d4b392..ef60b28d3 100644 --- a/src/pages/references/addonsdk/app-document.md +++ b/src/pages/references/addonsdk/app-document.md @@ -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 @@ -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 @@ -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: diff --git a/src/pages/references/changelog.md b/src/pages/references/changelog.md index 6324b0748..69129b84b 100644 --- a/src/pages/references/changelog.md +++ b/src/pages/references/changelog.md @@ -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.