Changelog

Breaking Changes

• Editor/iOS: Renamed DefaultAssetLibrary.uploadsLabel to DefaultAssetLibrary.photoRollLabel for the new PhotoRollAssetSource.
• Editor/iOS: Removed DefaultAssetLibrary.Tab.uploads and replaced it with DefaultAssetLibrary.Tab.photoRoll that uses the new PhotoRollAssetSource. Create a custom AssetLibrary to revert to the previous behavior based on Engine.DemoAssetSource.imageUpload/videoUpload.
• Editor/iOS: Deprecated Dock.Buttons.photoRoll in favor of Dock.Buttons.imglyPhotoRoll that uses the new PhotoRollAssetSource. Use Dock.Buttons.systemPhotoRoll to use the previous behavior.
• Editor/iOS: Deprecated EditorEvent.addFromPhotoRoll in favor of EditorEvent.addFromIMGLYPhotoRoll that uses the new PhotoRollAssetSource. Use EditorEvent.addFromSystemPhotoRoll to use the previous behavior.
• Editor/iOS: Added PhotoRollAssetSource integration with Photo Library, and added it to the default onCreate callback. If you use the DefaultAssetLibrary with the new DefaultAssetLibrary.Tab.photoRoll, the new Dock.Buttons.imglyPhotoRoll, or the new EditorEvent.addFromIMGLYPhotoRoll, you also need to add it to your onCreate callback implementation.
• Editor/iOS: Add NSPhotoLibraryUsageDescription to your Info.plist if you are using the new PhotoRollAssetSource, the DefaultAssetLibrary with the new DefaultAssetLibrary.Tab.photoRoll, the new Dock.Buttons.imglyPhotoRoll, or the new EditorEvent.addFromIMGLYPhotoRoll.
• Editor/iOS: Added a generic constraint to AssetPreview for the empty view.
• Editor/RN: Fixed Android compatibility issues with Expo 54.
• Camera/RN: Fixed Android compatibility issues with Expo 54.

Non Breaking Changes

• Editor/Web: Add support for P3 color space and OKLCH color format to theming API.
• Editor/Web: Added disableTooltips configuration option to asset library entries, allowing tooltips to be disabled for asset cards when set to true
• Engine: Add support for Lottie animations on video fills.
• Engine/Web: Added MKV (Matroska) video format support with extended codec compatibility including H.264, H.265/HEVC, AAC, MP3 audio codecs in addition to the existing VP8, VP9, AV1, and Opus support.
• Editor/Web: Extended the page placeholder settings to support resizing. Similar to changing page size, the placeholder setting will reflect on all pages in the scene.
• Editor/Web: Added ‘system’ theme option that automatically adapts to the user’s OS theme preference
• Editor/Web: Enhanced theme API to support function-based themes for dynamic theme selection. cesdk.ui.setTheme() now accepts ‘light’, ‘dark’, ‘system’, or a function that returns a theme
• Editor/Web: Updated cesdk.ui.getTheme() to always return the resolved theme value (‘light’ or ‘dark’), evaluating functions and system preferences as needed
• Editor/Web: Deprecated theme configuration property. Use cesdk.ui.setTheme() and cesdk.ui.getTheme() methods instead for runtime theme management
• Editor/Web: Fixed icon functions to always receive resolved theme values (‘light’ or ‘dark’), never ‘system’
• Editor/Web: Enhanced scale API to match theme API pattern. cesdk.ui.setScale() now accepts ‘normal’, ‘large’, or a function that returns a scale based on viewport properties
• Editor/Web: Updated cesdk.ui.getScale() to always return the resolved scale value (‘normal’ or ‘large’), evaluating functions as needed
• Editor/Web: Deprecated ui.scale configuration property. Use cesdk.ui.setScale() and cesdk.ui.getScale() methods instead for runtime scale management
• Engine/Web: Refactored Settings interface architecture by moving settings interface to separate Settings.ts file for better code organization and maintainability.
• Engine/Web: Consolidated internal setting types into main Settings interface using @internal JSDoc tags for improved API clarity.
• Engine/Web: Improved type safety by deriving all setting types directly from the Settings interface, ensuring consistency across the API.
• Engine/Web: Added unified setSetting and getSetting methods that automatically infer types based on the setting key, providing better TypeScript support and a simpler API.
• Engine/Web: Added new TypeScript types SettingsMap, SettingKey, and SettingValue for type-safe settings access.
• Engine/Web: Simplified deprecated type-specific settings methods (setSettingBool, getSettingBool, setSettingInt, getSettingInt, setSettingFloat, getSettingFloat, setSettingString, getSettingString, setSettingColor, getSettingColor, setSettingEnum, getSettingEnum) to use single function signatures while maintaining backward compatibility.
• Engine/Web: Deprecated SettingsColor type export. Use the Color type directly instead.
• Engine/Web: Updated all internal code to use the new unified settings API.
• Engine/Web: Video captions are now enabled by default without requiring explicit feature flag configuration.
• Documentation: Replaced C++ internal function references (createRGBColor, createClear, createWhite) with JavaScript object literals.
• Documentation: Updated all code examples to use the new unified setSetting and getSetting API.
• Documentation: Fixed license placeholder to use ‘YOUR_CESDK_LICENSE_KEY’ consistently.
• Documentation: Cleaned up complex types in Settings tables to show just type names with parameters in dedicated sections.
• Documentation: Added missing sections for ColorMaskingSettings and GlobalScopes complex types.
• Editor/Web: Fix an issue where the navigation bar actions dropdown appeared empty after or broken updating the CE.SDK.
• Editor/Web: Add comprehensive tooltips to all placeholder settings options to clarify what each permission allows users to do
• Engine/Android: Fixed that the audio stream on a video export could have no proper end-of-stream signal.
• Editor/Android: Fixed ClassCastException when opening FillStroke sheet for a block referencing CMYK color(s).
• Engine: The createAudioFromVideo or createAudiosFromVideo APIs now use the correct sample rate and channel configuration from the track being extracted.
• Engine/Web: Fixed crash when loading audio with empty chunks.
• Engine: Added support of MP4 videos that do not report the duration for audio tracks.
• Engine/Android: Fixed an issue where certain videos or audio files that could not be decoded were not always assigned an error state.
• Engine: Added a new split block API that allows splitting a block into two based on a specified time and additional options: attachToParent (to choose if the new block will be attached to the same parent as the original), createParentTrackIfNeeded (to choose if the parent should be a track block) and selectNewBlock (to choose if the new block will be selected).
• Editor/Web: Add new cesdk.actions API for centralized actions management with register(), get(), and run() methods to handle export, save, load, and other user interaction actions
• Editor/Web: Add new cesdk.utils API providing default implementations for common operations including loading dialogs, export operations, file handling, and scene management
• Editor/Web: Extend navigation bar order manipulation APIs to accept index-based matching for more flexible component positioning
• Editor/Web: Deprecate navigation bar action configuration options (ui.elements.navigation.action.save, ui.elements.navigation.action.export, ui.elements.navigation.action.share, ui.elements.navigation.action.download, ui.elements.navigation.action.load, ui.elements.navigation.action.back, ui.elements.navigation.action.close) in favor of the Order API with automatic migration support
• Editor/Web: Deprecate individual callback configurations in favor of the new centralized cesdk.callbacks API with automatic migration support. The deprecated callbacks and their new API equivalents are:
  • callbacks.onBack → Use Order API with ly.img.back.navigationBar component
  • callbacks.onClose → Use Order API with ly.img.close.navigationBar component
  • callbacks.onSave → cesdk.callbacks.register('saveScene', callback)
  • callbacks.onShare → cesdk.callbacks.register('shareScene', callback)
  • callbacks.onExport → cesdk.callbacks.register('exportDesign', callback)
  • callbacks.onDownload → cesdk.callbacks.register('exportScene', callback)
  • callbacks.onLoad → cesdk.callbacks.register('importScene', callback)
  • callbacks.onLoadArchive → cesdk.callbacks.register('importScene', callback) with format: 'archive'
  • callbacks.onUpload → cesdk.callbacks.register('uploadFile', callback)
  • callbacks.onUnsupportedBrowser → cesdk.callbacks.register('onUnsupportedBrowser', callback)
• Engine/Web: Add upload.supportedMimeTypes setting to configure supported file types for upload operations
• Editor/Web: Add Angular integration wrapper for Creative Editor SDK, available as @cesdk/cesdk-js/angular
• Editor/Web: Add addClip action to enable customization of clip addition behavior in video timeline. Developers can now override the default behavior by registering their own addClip action.
• Editor/Web: Deprecate setBackgroundTrackAssetLibraryEntries(), getBackgroundTrackAssetLibraryEntries() methods and backgroundTrackLibraryEntries configuration option in favor of the new addClip action approach.
• Editor/iOS: Prepared the NavigationBar to correctly present items for Apple’s new design system on iOS 26.
• Editor/iOS: Hide the navigation bar while searching to avoid seeing it underneath through the search’s glass background on iOS 26.
• Editor/iOS: Fixed truncated “Cancel” button on Voiceover sheet for iOS 26.
• Editor/Web: Fix custom locale translations not being applied when using setTranslations() with non-default locales.
• Engine: During drag operations, blocks are no longer reparented to hidden pages.
• Editor/Web: Fixed text asset labels not being translated properly.
• Engine: Archive file size reduced by removing unnecessary font files from it.
• Editor/iOS: Fixed audio playback after using system camera to record videos.
• Engine/Web: Fix HDR HEVC video support.

Breaking Changes

Non Breaking Changes

• Editor/Web: Fix custom locale translations not being applied when using setTranslations() with non-default locales.

Breaking Changes

Non Breaking Changes

• Editor/Web: Fix an issue where the navigation bar actions dropdown appeared empty after or broken updating the CE.SDK.

Breaking Changes

• Editor/Web: Deprecated locale configuration option in favor of cesdk.i18n.setLocale() API. Set locale after instance creation instead of in config.
• Editor/Web: Deprecated i18n configuration option in favor of cesdk.i18n.setTranslations() API. Set translations after instance creation instead of in config.
• Editor/Web: Deprecated cesdk.setTranslations() in favor of cesdk.i18n.setTranslations(). The old method will be removed in a future version.
• Editor/Android: Fixed touch/pinchAction value was not being restored correctly after exiting crop mode when it had been custom set.

Non Breaking Changes

• Engine/Web: Added support for async plugin initialization. The addPlugin method is now async and the EnginePlugin.initialize function can return a Promise.
• Editor/Web: Added support for async plugin initialization. The addPlugin method is now async and the EditorPlugin.initialize function can return a Promise.
• Editor/Web: Updated all plugin examples and documentation to use await with addPlugin calls.
• Editor/Web: Enhanced cesdk.i18n.setTranslations() with type-safe translation keys
• Editor/Web: Added cesdk.i18n.getTranslations() method to retrieve current translations for specified locales
• Editor/Web: Pass CE.SDK instance through builder context. The cesdk parameter in BuilderRenderFunctionContext is now required (previously optional). Custom components and panels can now directly access the full CE.SDK API via the cesdk parameter.
• Engine: In the default implementation for applying an asset to the scene, if the block fill is a raster image, we now ensure that it does not exceed it’s maximum size. This prevents images from being scaled beyond their native resolution.
• Engine/Web: Added WebM video format support for VP8, VP9, and AV1 video codecs and Opus audio codec (Vorbis is currently not supported).
• Editor/Web: Add offical React and Vue wrappers for CE.SDK Web
• Editor/Flutter: Fixed error in the photo editor on Android where the image could not be found.
• Editor/Web: Added cesdk.i18n.translate() method for retrieving translations by key or array of keys
• Engine: Fixed loadFromArchiveURL loading of scene archives with empty font files.
• Engine: Added new APIs to extract audio from videos. getAudioTrackCountFromVideo retrieves the number of available audio tracks from a video, getAudioInfoFromVideo retrieves information from all the audio tracks in a video (such as language, track name, codec), createAudioFromVideo extracts a specific audio track from a video and creates an audio block with it and createAudiosFromVideo does the same as createAudioFromVideo but for all existing audio tracks in the video.
• Editor/iOS: Fixed iOS crash during camera/mic permission prompt due to Swift 6 update.

Breaking Changes

• Engine: The createFromImage API now adds a fill directly to the page instead of creating a graphic block with the image fill. To replicate the previous behavior:
  • Get the page’s fill after calling createFromImage
  • Create a graphic block with a rectangular shape
  • Set the fill of the graphic block to that of the page
  • Set the graphic block dimensions to match those of the page
  • Add the graphic block as a child of the page
  • Replace the page’s fill with a solid color fill (white)

Non Breaking Changes

• Engine: Added addLocalAssetSourceFromJSONURI method to load asset sources from JSON URIs. Returns the asset source ID of the newly created source.
• Engine: The setEditMode API now has an additional optional parameter that allows using another edit mode as a base.
• Engine/Web: Added a parameter to Scene.saveToString and Block.saveToString to allow the opportunity to persist transient or temporary resources.
• Engine: Introduced “page/selectWhenNoBlocksSelected” setting that automatically selects the current page when nothing else is currently selected.
• Engine: Added support for self-contained scenes and archives by serializing additional scene state components including settings, variables, and spot colors. This ensures that exported scenes maintain their complete configuration when shared or loaded in different environments.
• Engine: Added a overrideEditorConfig boolean flag to loadSceneFromString, loadSceneFromURL and loadSceneFromArchiveURL which controls whether to override the editor settings from the loaded scene.
• Engine: Reject Infinity values in all setters.
• Engine: Reject NaN values in block.scale and block.setRotation.
• Engine/Web: Fixed issue when export produced a corrupted file.
• Editor/Web: Fix filter library only loading if ly.img.filter.duotone and ly.img.filter.lut asset sources are being available.
• Engine/iOS: Fix crash when typing characters with a diacritic mark.
• Engine/Android: Fixed an issue where content with the text/html MIME type could not be pasted.
• Editor/Web: Fix tooltip and keyboard issues on iOS Safari/WebKit
• Editor/iOS: Fix crash when starting VoiceOver after Swift 6 update
• Engine: Fix crash when generating thumbnails larger than the platform’s maximum texture size by clamping to the supported limit.
• Engine: Added clampThumbnailTextureSizes setting to control this clamping behavior (default: true).
• Editor/Web: Fix an issue where the editor is zoomed in on iOS devices when the input field is focused.
• Editor/Web: Fix an issue where the AI plugin quick action button is disabled.

Breaking Changes

Non Breaking Changes

• Editor/Web: Fix an issue where the AI plugin quick action button is disabled.
• Engine: Fix crash when generating thumbnails larger than the platform’s maximum texture size by clamping to the supported limit.
• Engine: Added clampThumbnailTextureSizes setting to control this clamping behavior (default: true).

Breaking Changes

• Engine/Swift: Updated the default value of Engine.assetBaseURL for Engine.addDefaultAssetSources to https://cdn.img.ly/assets/v4.
• Editor/iOS: Updated DefaultAssetLibrary.shapes and DefaultAssetLibrary.stickers with new sections from v4 assets.
• Engine/Android: Updated the default value of baseUri in Engine.addDefaultAssetSources to https://cdn.img.ly/assets/v4.
• Editor/Android: Updated LibraryContent.Shapes and LibraryContent.Stickers with new sections from v4 assets.

Non Breaking Changes

• Editor/iOS: Allow Kingfisher 7 and 8 dependency.
• Engine: From now on addAssetToSource does not allow adding multiple assets with the same ID in case of local asset sources.
• Engine/Android: Improved memory usage when saving scene to archive.
• Engine/Swift: Improved memory usage when saving scene to archive.
• Editor/Web: Fix caption dock button visible after disabling caption feature via feature API
• Engine/Swift: Fixed invalid blend mode values and added new blend modes (linearBurn, darkenColor, linearDodge, lightenColor, vividLight, linearLight, pinLight, hardMix, subtract, divide).
• Camera/iOS: Close the camera if there is an issue loading the reaction video.
• Engine: Fixed that min and max automatic font size were not scaled the same way as the font size. Could lead to auto-sized text being too small or too large after a change in design unit or DPI, e.g., during applyTemplateFromString if the current scene has a different design unit or DPI setting.
• Engine: Add asset.addFromJSONString endpoint to streamline asset source creation.
• Editor/Web: Introduced a new builder.Component component that allows rendering custom components that were registered using the cesdk.ui.registerComponent.
• Editor/Web: Order UI APIs now support nested orders, allowing for the customization of nested components within the order. This pattern is currently only supported by ly.img.actions.navigationBar component with other components to follow soon.
• Editor/Web: Added new order manipulation APIs for all UI areas:
  • Dock: updateDockOrderComponent, removeDockOrderComponent, insertDockOrderComponent
  • Inspector Bar: updateInspectorBarOrderComponent, removeInspectorBarOrderComponent, insertInspectorBarOrderComponent
  • Canvas Menu: updateCanvasMenuOrderComponent, removeCanvasMenuOrderComponent, insertCanvasMenuOrderComponent
  • Navigation Bar: updateNavigationBarOrderComponent, removeNavigationBarOrderComponent, insertNavigationBarOrderComponent
  • Canvas Bar: updateCanvasBarOrderComponent, removeCanvasBarOrderComponent, insertCanvasBarOrderComponent

Breaking Changes

• Editor/Web: Updated the ly.img.vectorpath asset library with new shapes. Those can be accessed by calling cesdk.addDefaultAssetSources().
• Engine: Added fetchAsset method to the AssetSource interface, allowing fetching of specific assets by ID. This is a breaking change for custom asset source implementations, which must now implement or handle the new fetchAsset method.
• Engine: Added findAssetSourceAssets to the UBQ interface, allowing fetching of specific assets by ID.
• Engine/Android: added fetchAsset method to the AssetAPI interface. AssetSource now includes an optional fetchAsset method.
• Engine/Swift: added fetchAsset method to the AssetAPI interface. AssetSource protocol now includes an optional fetchAsset method. The getAsset method is removed.
• Engine/Web: added fetchAsset method to the AssetAPI interface. AssetSource protocol now includes an optional fetchAsset method.
• Editor/Android: Changed localization keys to a common structure prefixed with ly_img_editor_ for easy customizations and added German translations.
• Camera/Android: Changed localization keys to a common structure prefixed with ly_img_camera_ for easy customizations and added German translations.
• Editor/iOS: Changed AssetLibrarySource, AssetLibraryGroup, AssetLibraryTab, AssetLibraryTabView, NavigationLabel, SheetType.libraryAdd, and .libraryReplace initializers to accept a LocalizedStringResource as title instead of a String.
• Editor/iOS: Changed localization keys to a common structure prefixed with ly_img_editor_ for easy customizations and added German translations.
• Camera/iOS: Changed localization keys to a common structure prefixed with ly_img_camera_ for easy customizations and added German translations.
• Editor/Web: Introduce a new set of sticker assets that can be added by calling addDefaultAssetSources
• Editor/Web: Moved the default assets path from https://cdn.img.ly/assets/v3 to https://cdn.img.ly/assets/v4
• Editor/Swift: Packages for Apple platforms are now built with Xcode 16.4, which is the new minimum requirement for using them.
• Engine/Swift: Packages for Apple platforms are now built with Xcode 16.4, which is the new minimum requirement for using them.

Non Breaking Changes

• Editor/Web: Introduced a new scale slider for captions, allowing users to adjust the size of the captions directly from the preset panel.
• Editor/Web: Add feature API ids for crop related inputs
• Editor/Android: Added new onLoaded callback to EngineConfiguration that is invoked when the editor is loaded and ready to be used. It is best to register callbacks, collect flows returned by the engine and apply editor settings in this callback.
• Editor/Web: Adding force crop feature via applyForceCrop API
• Editor/iOS: Added configurable onClose and onError callbacks.
• Editor/iOS: Added a default confirmation alert when closing the editor.
• Editor/React Native: Fixed unexpected behavior when opening camera inside the editor that caused the editor to close.
• Editor/Flutter: Fixed unexpected behavior when opening camera inside the editor that caused the editor to close.
• Editor/Web: Adjustments, effects, filters and blurs are now only enabled for images and videos by default. This can be easily changed by using the cesdk.feature.enable API.
• Editor: When selecting a child with all arrangement scopes disabled, the group’s rotation and resize gizmos now appear instead — allowing to move, resize, and rotate the group directly (provided the group itself has the necessary arrangement scopes).
• Editor/Web: The canvas menu will now be hidden by default during playback. If you wish to show it, you can use the feature predicate ly.img.canvasMenu to control its visibility.
• Engine: Fixed potential crash during export if the device runs out of memory.
• Editor/Web: Fixed an issue where the AnimationSubInspector was not positioned correctly.
• Engine: Removed crop component from blocks when switching to a non-croppable fill.
• Editor/Web: Fixed an issue where certain panels did not respond correctly to API calls.
• Editor/RN: Fixed compatibility issues with RN 0.77.0+/Expo 53+ during compilation due to signature mismatch.
• Engine/Android: Fixed not released GPU memory on repeated export, which could result in the device running out of memory.
• Editor/iOS: Fixed incorrect scope check when determining if a block can be moved. Previously, the “editor/add” scope was checked instead of the correct “layer/move” scope when evaluating whether a block can be moved forward or backward.
• Editor/Android: Fixed incorrect scope check when determining if a block can be moved. Previously, the “editor/add” scope was checked instead of the correct “layer/move” scope when evaluating whether a block can be moved forward or backward.
• Engine: Enable all scopes for the current user role when loading blocks from serialized resources in defaultApplyAsset.
• Engine/iOS: Fixed crashes during text editing.
• Engine: fixed an issue where toggling mute while in “Playback” mode would set the edit mode to “Transform”.

Breaking Changes

Non Breaking Changes

• Engine/iOS: Fixed crashes during text editing.

Breaking Changes

Non Breaking Changes

• Engine/Android: Fix native crash due to incorrect Proguard configuration.