Contact us

Applies to: Customer's Canvas Hub cloud; Workflow Elements cloud; Handy Editor cloud

Skip to main content

What's new

October 2026​

Breaking changes​

  • Clipart Item Type: The Cliparts gallery now inserts ClipartItem objects instead of ImageItem objects. If your integration or workflow expects image items, update it to handle clipart items.

New features​

  • Bleed Visibility: Added the designViewer.bleed.enabled setting to show or hide bleed and trim areas. The setting affects only the viewer and doesn't affect the output files.
  • Placeholder Insertion: You can now insert an image from the asset library or an upload as a new placeholder filled with that image. To enable this, set assetLibrary.images.insertAs or imageUploader.insertByDefaultAs to "Placeholder".
  • Mobile Panels: The Cliparts, Options, and Templates panels and external image storage are now available in the mobile editor.
  • No Fill for Shapes: In non-Colorless containers, shapes can now have no fill. In the color picker, select No fill to display only the shape outline. The stroke color and width remain editable.
  • Limited Color Placeholders: In the desktop editor, images inserted as placeholders into Limited Color containers now expose their recognized colors for editing.
  • Item Property Permissions: You can now hide individual property controls. Use itemBuilder.<type>.itemPermissions to hide Opacity for text, images, placeholders, and barcodes. For shapes, use itemBuilder.shape.shapePermissions to hide fill and border controls.

General improvements​

  • Mobile pagination: The page switcher is now hidden in the mobile editor when the design has only one page.
  • Localization: The editor now falls back to English (en) when the requested interface language is not supported.
  • Gallery Performance: Adding objects from the Shapes, Cliparts, and Images galleries is now faster. The editor pre-creates these objects, so it makes fewer API requests.

Bug fixes​

  • Fixed an issue where the approval screen sometimes required a second click to close.
  • Fixed an issue where the addtocart event always returned quantity: 1, even when the integration configuration specified a different value.
  • Fixed an issue where page previews were displayed incorrectly in the page switcher on iOS devices.
  • Fixed an issue where the design reloaded when the Options panel opened after a setChoices() call.
  • Fixed an issue where in-place text editing could remain available in the mobile Handy Editor, causing unexpected behavior.
  • Fixed some issues with background editing.
  • Fixed an issue where a QR code created in a Colorless container had a visible background. The background is now transparent so the QR code renders correctly.
  • Fixed an issue where the text editor did not receive focus after you tapped the edit button in the properties panel on iOS devices.
  • Fixed an issue where the approval screen did not open for products with a 3D mockup.

September 2026​

General improvements​

  • The Product Options button in the action panel is now hidden if a product has only one option with a single value.
  • Font size for text insertion is now automatically calculated based on the print area dimensions.
  • Extended PIM input: Added the variantDesignId property to select a specific design variant within a product variant productVariantId. If omitted, the first design variant is used as before. Invalid IDs are rejected and raise an error event, while the Design Variant Filter and Templates asset panel behavior remain unchanged.

Bug fixes​

  • Fixed an issue where the detected color count was not displayed in the viewer in the Limited Color mode.
  • Fixed an issue with the missing warnings for exceeding max artwork size and exceeding design area.
  • Fixed an issue where changing the image color after background removal would restore the background.
  • Fixed some issues with text input on the text panel.
  • Fixed an issue where the editor did not close toolbar panels in some cases.
  • Fixed an issue where logo resizing was not applied after AI background removal.

August 2026​

New features​

  • Batch Order Input: Added support for loading multiple product variants with quantities in a single session. To learn more, refer to the Batch order topic.
  • Design Variants Panel: Added the designVariants panel to assetLibrary for variant previews and switching. To enable it, set assetLibrary.designVariants.enabled to true. This panel works only with the batch order input.

General improvements​

  • Text Editing: Added panel for desktop, window for mobile.

Bug fixes​

  • Fixed an issue where the editor would not open if a product had no variants.
  • Fixed an issue where the original color was preserved when using finishing in a Colorless container.
  • Fixed the appearance of thumbnails for custom shapes.
  • Fixed image insertion to reject files exceeding color limits and display an error message.
  • Fixed an issue with loading design variant preview with a fallback mechanism.
  • Fixed editor exit for batch order input.
  • Fixed an issue where a product failed to add to cart after editing its design from the cart.
  • Fixed bottom sheet (+) and Opacity controls in the mobile Handy Editor.
  • Fixed an issue where image upload and clipart addition were blocked after changing options (e.g., color).

July 2026​

General improvements​

  • Design Options: Changing ink color options in the workspace now preserves your current design modifications instead of showing a reset warning and resetting your work.
  • Multi-Color Swatch: Introduced a multi-color swatch that allows you to change colors for design element groups. Configured via a color array, it displays up to the first 4 colors in the Property Viewer.
  • Automated Container Recoloring: Colorless design elements now automatically match the color selected on the product details page when the editor loads, removing the need for manual selection.
  • Default Library Panel: Added a defaultPanel property to settings.assetLibrary, allowing you to specify which tab opens on editor load (e.g., "templates" to open the Templates panel).

Web-component API​

Bug fixes​

  • Fixed an issue where the page switcher in the mobile editor loaded with a delay.
  • Fixed an issue where "No color" could not be applied to strokes in Limited Color containers.
  • Fixed a console error when inserting full-color images into Limited Color containers; QR code recoloring now works correctly.
  • Fixed an issue where design elements lost recoloring options after being grouped.
  • Fixed an issue where duplicating a logo also duplicated its color in the palette list.
  • Fixed an issue where the editor froze on the processing spinner, preventing users from approving designs.

June 2026​

Auto-fix for max artwork size​

  • Introduced a command that triggers when artwork exceeds predefined size limits. The algorithm calculates the collective bounding box of the elements and proportionally fits the entire composition within the container boundaries, supporting both rectangular and circular constraints. This ensures layout compliance while maintaining the overall design composition.

Mobile editor updates​

  • Fixed positioning and alignment issues for the menu action (+) button.
  • Updated the preloader with a simplified throbber animation.
  • Resolved an issue where newly uploaded images failed to insert into the canvas upon interaction.
  • Resolved a console error that occurred when attempting to insert full-color images into the canvas.
  • Resolved a background color mismatch between the font list and the bottom sheet drawer.
  • Fixed an issue where updating an existing QR code failed to apply changes on iOS 18.
  • Resolved a bug that prevented users from dragging the color picker slider with their finger.

Bug fixes​

  • Fixed an issue where the Images panel didn't contain all the uploaded images.
  • Fixed an issue where the Images panel remained open after selecting a new placeholder in the viewer.
  • Fixed an issue with rendering previews of finishing containers.

May 2026​

UI improvements​

  • Print Area visualization: You can now configure such settings as the color, thickness, and dashing of print areas, providing more control over its appearance on the canvas.
  • Max Artwork Size visualization: You can now configure such settings as the color, dashing, and label of the max artwork size frame.
  • Localization: Added support for error and warning tooltips displayed on validation icons. They now respect the current language via new keys in JSON translation files.
  • Pagination: Improved page switcher visibility in the editor with larger buttons, making page navigation easier to notice and use.
  • Added the ability to disable background color editing. For products where background color is irrelevant (e.g., apparel), set settings.background.enabled to false to hide the background color picker on both desktop and mobile.

Bug fixes​

  • Fixed an issue where the Handy Editor failed to load a second product.
  • Fixed the getExternalStorageImagesIds() method — it now returns identifiers from all object types, not just ImageItem objects.
  • Fixed an issue where images were not inserted into placeholders via Replace/Upload in the mobile Handy Editor.
  • Fixed some issues with placeholder functionality in the mobile Handy Editor.
  • Fixed an issue where the editor state was not fully reset between sessions. Previously loaded files are now cleared on initialization with a new user ID.
  • Fixed incorrect editor initialization when an empty options object was passed to designVariantFilter.
  • Fixed the page selector displaying design previews without mockups. Mockup previews are now prioritized for products where the mockup is more relevant than the design content (e.g., apparel).
  • Fixed incorrectly sized alert dialogs in the mobile Handy Editor.
  • Fixed unstable behavior of the Uploads modal: dragging the modal up no longer snaps it back down or causes the editor background to jitter.
  • Fixed incorrect zoom behavior.

April 2026​

New finishing containers​

  • Added the finishingContainers resource section that lets you define texture and color finishing variations for a container. In the UI, an Apply finish drop-down list allows users to browse available options and apply one. Supports visualization settings, output format, dithering, printing technique constraints, and more. Currently works with Colorless Containers. For details, see the Resources article.

Enhanced design validation​

  • Added new validation rules to the itemValidation object to improve print quality:
    • outOfPrintArea: Detects elements outside the printable zone. By default, this validation is disabled. To check this rule, set outOfPrintArea.enabled to true.
    • maxArtworkSize: Ensures designs stay within allowed dimensions. By default, this validation is enabled. To skip this rule, set maxArtworkSize.enabled to false.

Mobile UX improvements​

  • Improved the bottom sheet behavior by adding smooth transitions.
  • Improved the swipe gesture responsiveness for the bottom sheet. The sheet now closes more reliably without triggering a page reload, providing a more intuitive user experience.

Bug fixes​

  • Fixed an issue where Pinch Zoom caused the image to shift when resizing.
  • Fixed a layout issue in the Curved Text property panel.
  • Fixed an issue where SVG elements from external storage could not be recolored.
  • Fixed visual issues in the new recoloring interface to ensure consistent UI rendering.

March 2026​

New features​

  • Added support for storing image IDs of imageItem objects created from external storage. The new API method getExternalStorageImagesIds() allows you to retrieve the IDs for reference or reprocessing.
  • Introduced a new mandatory review workflow to ensure users explicitly review all pages before finalizing their customization. If any page remains unreviewed, a warning message will prompt confirmation. This feature is enabled by default (requireAllPageReview.enabled: true) for improved quality control.

Bug fixes​

  • Fixed color recognition and recoloring for images from external storage—now supports all raster formats (JPEG, PNG, etc.) and complex SVGs.
  • Fixed multi-step recoloring: Reapplying recolor now targets only the original colors, preserving user intent instead of replacing intermediate colors.

February 2026​

Slot improvements​

  • Added a custom-panel slot to display custom content (e.g., tutorials or user guidance). Enable the custom button in the assetLibrary settings to access it.
  • Added an approval-slot-3 as a container for elements positioned below the Continue button.

Reset functionality update​

  • The Reset button for non-image elements now restores default properties: shapes reset to black, while text reverts to the default font and color defined in settings.

Bug fixes​

  • Fixed an issue where the editor failed to send requests to the external image storage when using the search function.

January 2026​

Limited colors mode improvements​

  • Enhanced color replacement interface for improved usability and clarity.
  • Added multicolor swatches, allowing users to manage multiple color options within a single palette.
  • Added support for Original Color, enabling easy reference and reset to the default color state.

Bug fixes​

  • Fixed an issue where the Zoom button width was incorrectly calculated, ensuring smooth zoom adjustments.
  • Fixed an issue when Show Grid toggle state behaved opposite to user expectations.
  • Fixed incorrect display of the original color for images, ensuring accurate color reference.
  • Fixed missing dynamic data insertion in warning placeholders within Limited Colors mode.
  • Fixed some UX inconsistencies in the recoloring interface, improving usability and interaction flow.

December 2025​

New features​

  • Added support for transform operations on design elements via the top toolbar. You can now apply translate, scale, and rotate to the elements selected in the viewer by setting their:

    • Position (x, y coordinates),
    • Size (bounding rectangle width/height),
    • Rotation (angle).

    To configure the toolbar settings, refer to the itemTools topic.

  • Added the possibility to apply AI-powered operations to the selected images in the viewer. You can now select an AI vendor and customize service-specific settings for operations like:

    • Image upscaling
    • Background removal
    • Vectorization
    • Text-to-image generation

  • Extended the Handy Editor frontend API with a new actions interface, allowing external calls to key methods, like undo(), redo(), openApprovalScreen(), etc.

General improvements​

  • Added support for custom loading animations via the overlay-spinner slot, allowing replacement of the default spinner.

November 2025​

New features​

General improvements​

  • Enhanced history functionality to support long-running operations, with fixes for stability and performance.

Bug fixes​

  • Fixed an issue where undoing background removal required two separate actions—now it works in a single step.
  • Fixed an issue where the Handy Editor was overriding global Angular CSS classes.
  • Removed an unintended atoms/v1/designs/render-preview API call.
  • Fixed an issue where content for approvalSlot1 and approvalSlot2 was not displaying in the correct position.
  • Fixed misaligned text rendering on 3D mockups.

October 2025​

Breaking changes​

Previous Behavior: The color picker operated without color space conversion. If a design element's color was defined in RGB, the color picker used RGB mode; if the color was CMYK, it used CMYK mode.

New Behavior: The color space is now determined by either the FullColor container settings or the editor settings, with CMYK as the default mode. You may notice the color picker unexpectedly opening in CMYK mode for templates originally created with RGB colors.

Action Required: If you need to continue working in RGB mode, adjust the picker.colorSpace property in the settings accordingly.

New features​

  • The color picker now supports CMYK colors by default, replacing the previous behavior where it used the design’s original color space (RGB or CMYK). You can switch back to RGB mode through the picker.colorSpace property in the settings.

General improvements​

  • Added a warning when upscaling is not possible for images that are already sufficiently large.
  • Objects are now inserted at the correct angle when the canvas is rotated.
  • Added UI and console warnings when a product has no design variants, helping to identify and debug such cases.
  • Added a toast notification to inform users when large image files are being uploaded, providing a better user experience during the loading process.
  • Added a confirmation message when changing mockups or templates to prevent losing unsaved edits.

Bug fixes​

  • Fixed a layout issue with warnings on the Approval page.
  • Fixed a warning message for files with an excessive number of colors in the limited colors mode.
  • Fixed an issue where some design elements were missing from the canvas or preview.
  • Fixed an issue where z-index was incorrectly applied to grips and selection frames on the canvas.

September 2025​

Breaking changes​

Changed CSS class names. If your integration depends on specific CSS classes, they may need to be updated. We recommend using the new CSS variables system for future customizations.

UI & styling improvements​

Improved the editor's styling system to enhance user experience and visual consistency:

  • Introduced a CSS variables system for easier and safer customization.
  • Removed outdated me- prefixes for cleaner code.
  • Consolidated duplicate CSS classes to simplify styling.
  • Unified values for colors, sizes, and other design properties.

General improvements​

  • Enhanced placeholder functionality with new options to add images from a private gallery, replace the current image, and remove an image (reverting to the stub image).
  • Two-page PDF files now automatically split into individual pages on upload. Multi-page files in the upload panel are displayed as separate tiles, allowing users to add each page individually.
  • Added support for preserving the original image size during upload. To enable this, set the height or width property of imageUploader.itemBuilder.image to the "origin" keyword.
  • Added viewer3dLoadedAction() to the Plugin API, which notifies about the successful initialization of the 3D Viewer.

Bug fixes​

  • Fixed an issue with the logo slot in the 3D editor version.
  • Fixed a type error that occurred when moving from the design editing step to the approval step by clicking Next.
  • Fixed an issue with Copy/Paste hotkeys (Ctrl+C/Ctrl+V).
  • Fixed an issue where the bounding box and grips were missing for selected objects on the canvas in some cases.

August 2025​

Bug fixes​

  • Fixed an issue with dual scrollbars appearing in the color list.

July 2025​

General improvements​

  • Added the possibility to configure thumbnail appearance in the shopping cart. To display designs on mockups, you can now set the settings.results.previews.type property to "design-on-mockup". By default, the "design-only" value is applied, displaying only the designs.
  • The _hidden.images array now includes previews for each page.
  • Implemented mobile layouts for the approval page, the top toolbar, and the upload panel.

Bug fixes​

  • Fixed a problem when panels did not close when the screen was narrowed.

Others​

  • The input.previewMockupIds array is deprecated. To initialize the editor with mockups, use the previewMockups array that allow you to specify which page the mockup will be applied to.

    input: {
        previewMockups: [
            { surfaceIndex: 0, mockupId: "6527afc63507abfadd355226" },
            { surfaceIndex: 1, mockupId: "642e293dc46d098d64514607" }
        ],
        ...
    }

June 2025​

General improvements​

  • Improved validation for design elements:
    • minFontSize: Allows you to impose a limit on the minimum font size to prevent using extremely small text that cannot be printed.
    • allowRasterElements: Restricts the type of images being added to the design to either vector-only or both vector and raster elements.
    • targetResolution: Validates the resolution for raster objects that will be used for rendering print files. It takes the DPI limit from the design container's printing restrictions, not from the editor's configuration as qualityMeter does.
  • Added new parameters to imageUploader:
    • maxFileSizeMb: The maximum file size.
    • multipleUploadEnabled: Allows for uploading multiple files simultaneously.
    • allowedFileFormats: A list of allowed file formats.
    • allowedFileFormatsVectorOnly: A list of allowed file formats for vector graphics.

March 2025​

New features​

  • Introduced the possibility to integrate with external image storage services, allowing users to manage and access images directly within the Handy Editor.

General improvements​

  • You can now change the localization language dynamically while the Handy Editor is running. To do so, use the update() method to apply partial configurations for localization, allowing seamless language updates without restarting the editor.
  • You can now recover an editor session using SKU or variant ID.

February 2025​

New features​

  • Introduced localization of the user interface. You can switch between the provided languages, change the text, and create completely new translations for the user interface. To learn how to do this, refer to the localization topic.

General improvements​

  • Added the possibility to disable the confirmation dialog when leaving the page with the editor. To do so, set leaveConfirmation.enabled to false in the settings.

May 2024​

Initial Release

Last updated on
Was this page helpful?