What's new

• 4 minutes to read

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.

Features

• Added support for CMYK colors in the color picker. Previously, the color picker operated in the original color space of the design (RGB or CMYK). CMYK is now the default mode. You can change it to RGB 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.

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.

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