Apostrophe 4.15.0: In-Context Live Preview, Enhanced Tables, Media Batch Operations and Translation Tools

[BoDonkey]

Hello Apostrophe Community!

We're excited to announce the release of Apostrophe 4.15.0, focused on empowering your editorial and marketing teams with tools that make content creation more intuitive and efficient. This release brings significant improvements to the core editing experience while enhancing our support for global enterprise customers through improved translation capabilities and content management.

ApostropheCMS.4.15.0.In-context.preview.batch.media.operations.table.controls.translation.tools.mp4

In-Context Live Widget Preview: See Changes as You Make Them

The standout feature in this release is the new in-context live preview capability for widgets. Now, content editors can see changes reflected on the page in real-time as they make edits—no more waiting to publish or preview to see how adjustments will look.

Although this feature is well-tested, the feature is currently opt-in as we gather community feedback. To enable it, set preview: true in the options section of the index.js file of any widget module, or activate it globally by setting it on the @apostrophecms/widget-type module. We encourage you to test this feature and share your experience with us. The in-context preview is particularly powerful when combined with range fields for styles like container widths, allowing editors to fine-tune their content with immediate visual feedback.

Enhanced Table Editing in Rich Text

Tables are a crucial part of presenting structured information, and we've made them even better:

• A dedicated control bar specifically for table editing
• Drag-to-resize column functionality for perfect table layouts
• Building on our recently released CSV import feature, these improvements make managing tabular data more intuitive than ever

As a reminder, if your rich text widgets don’t offer tables on the insert menu yet, be sure to add table to the insert option when configuring the rich text widget in each area. Then editors can access the insert menu by pressing / at the start of any line.

Global Reach with Translation Support

For our enterprise customers operating internationally, we've enhanced the Import/Export extension with automatic translation capabilities. When importing content, you can now leverage our Automatic Translation extension to streamline multilingual content management. This feature makes managing content across different languages and regions more efficient, especially if some of your locales are hosted in a separate deployment of ApostropheCMS.

Batch Operations for Media Library

Content managers working with large media collections will appreciate the enhanced batch operations in the Media Library. You can now select multiple images at once to:

• Archive images in bulk
• Localize multiple images simultaneously for different regions
• Export selected images for use in other contexts

These batch operations significantly streamline workflows when managing extensive media collections, saving valuable time for your editorial and marketing teams.

UX Improvements Across the Board

We believe that small enhancements add up to a significantly better experience. This release includes numerous quality-of-life improvements, part of our broader commitment to focus on making the editor experience more intuitive in upcoming release cycles:

• Smoother Page Management: Page dragging and reordering now happens in the background without blocking the UI, and the UI scrolls automatically when dragging.
• Enhanced Media Manager: Uploading images is now smoother with no additional server requests and improved error handling.
• Form Refinements: The user email field is properly typed as email, and the reset password button is more clearly labeled.
• Performance Optimizations: We've reduced verbose logging and made background processes more efficient.

Community Contributions: sanitize-html Enhancements

We're proud to highlight community contributions in this release, particularly the enhancements to the sanitize-html module. Thanks to Rimvydas Naktinis, this long-standing module now includes onOpenTag and onCloseTag events, enabling more advanced filtering capabilities. This improvement demonstrates the power of our open-source community and their continued commitment to improving Apostrophe's ecosystem.

Discover Our New Public Roadmap

We're excited to announce our new public roadmap at https://roadmap.apostrophecms.com/. Visit to see what is in progress, coming next, and currently in the backlog — and share your ideas and feedback on current and future features. Insights from you help shape the direction of Apostrophe, and we encourage community contributions to make our CMS even better.

---

These improvements are ready for you to explore! Update your projects with npm update and let us know what you think. Your feedback helps us refine and enhance ApostropheCMS to meet your needs.

🚀 Happy coding!

Apostrophe 4.15.0

Adds

• To display a live preview on the page as changes are made to widgets, set the preview: true option on any widget module. To turn it on for all widgets, you can set it on the @apostrophecms/widget-type module, the base class of all widget modules. This works especially well when range fields are used to achieve visual effects.
• Adds separate control bar for editing tables in rich text
• Adds ability to drag-resize rich text table columns

Changes

• Improve the Page Manager experience when dragging and dropping pages - the updates happen in background and the UI is not blocked anymore.
• Allow scrolling while dragging a page in the Page Manager.
• Change user's email field type to email.
• Improve media manager experience after uploading images. No additional server requests are made, no broken UI on error.
• Change reset password form button label to Reset Password.
• Removed overly verbose logging of schema errors in the schema module itself. These are already logged appropriately if they become the actual result of an API call. With this change it becomes possible to catch and discard or mitigate these in some situations without excessive log output.
• Bumps eslint-config-apostrophe, fix errors and a bunch of warnings.

Fixes

• Update uploadfs to 1.24.3.
• Fixes an edge case where reordering a page in the Page Manager might affect another locale.
• Fixes chrome bug when pages manager checkboxes need a double click when coming from the rich text editor (because some text is selected).
• Fixes the rich text insert menu image menu not being properly closed.
• Fixes the rich text toolbar not closing sometimes when unfocusing the editor.
• Fixes missing wording on images batch operations.
• Fixes rich text toolbar width being limited to parent width.
• Fixes rich text insert menu focused item text color easily overridable.
• Fixes clipped text in the pager and in the relationship filters of piece manager.

Enterprise modules

@apostrophecms-pro/doc-template-library

This module solves the "blank page problem" for developers and product managers, and makes it faster for editors to create content. doc-template-library allows for the configuration of default widgets and pre-populated content on piece or page templates, and to re-use existing layouts. Explore our documentation to discover how this extension can enhance your project. Then, effortlessly integrate it through our new Apostrophe Workspaces. For further details or inquiries, feel free to contact us or visit our pricing page.

Changes

• Bumps eslint-config-apostrophe to 5, fix errors, removes unused dependencies.

@apostrophecms-pro/multisite

This module lets you have many ApostropheCMS websites running on a single codebase in a single Node.js process. Each has its own database, users, media uploads, etc. Sites can be created and managed via a dashboard site. Explore our documentation to discover how this extension can enhance your project. For further details or inquiries, feel free to contact us or visit our pricing page.

Changes

• Bumps eslint-config-apostrophe to 5, fixes errors, removes unused dependencies.

Fixed

• Update uploadfs to 1.24.3.

@apostrophecms-pro/palette 4.5.0

An in-context interface for changing CSS. @apostrophecms-pro/palette is a module that provides an in-context interface for changing the values of developer-set CSS properties. The values are stored in an Apostrophe piece singleton (like @apostrophecms/global) and applied to the site whenever the stylesheet link is included in a template. Adjusting values via the palette interface renders changes to the site instantly. Explore our documentation to discover how this extension can enhance your project. Then, effortlessly integrate it through our new Apostrophe Workspaces. For further details or inquiries, feel free to contact us or visit our pricing page.

Adds

• Add support for breakpoint preview

Changes

• Bumps eslint-config-apostrophe to 5, fixes errors, removes unused dependencies.

Apostrophe modules

@apostrophecms/blog

This module bundle helps developers quickly add blog articles to Apostrophe websites. It provides the blog post piece type (@apostrophecms/blog) as well as a special page type (@apostrophecms/blog-page) for editors to create a blog.

Changes

• Updates the documentation. No code changes.

Fixed

• Fix the result sorting and pagination issues due to unreliable sorting values.

@apostrophecms/import-export

This module enables import and export of pages and pieces, with or without related documents such as files, images and other related types.

Adds

• Adds support for translating content while importing via the Automatic Translation module (when available).
• Allow page position to be adapted when importing based on slug hierarchy.

Fixes

• Fix "include related documents" modal height.
• Fixes moduleLabel computed.
• Fixes missing call to recomputeAllDocReferences when duplicated have been overridden.

Changes

• Bumps eslint-config-apostrophe to 5, fixes errors, removes unused dependencies.
• Exports attachments by default, without treating them like related documents.

@apostrophecms/passport-bridge

apostrophe-passport works together with passport-google-oauth20, passport-gitlab2 and similar passport strategy modules to let users log in to Apostrophe CMS sites via Google, Gitlab and other identity providers. This feature is often called federation or single sign-on.

Adds

• Adds strategy option verify. verify is a function that accepts findOrCreateUser and returns a function. The default findOrCreateUser method returns a function that accepts 5 parameters req plus accessToken, refreshToken, profile and callback.
  This is the default for some strategies like passport-oauth2, passport-github2 and passport-gitlab2. If the passport strategy you're using have a different set of parameters outside of req (for example passport-auth0), you can use the verify option to re-map those parameters. More info at Customizing call to the strategy verify method
• Add self.specs with the computed strategies options.

Fixes

• Fix infinite loop issue with findOrCreateUser without req parameter.
• Fixed ESM support by removing self.apos.root.import usage.

Changes

• Bumps eslint-config-apostrophe to 5, fixes errors, removes unused dependencies.

Utilities

@apostrophecms/apostrophe-astro

This module integrates ApostropheCMS into your Astro application.

Adds

• Add support for decoding the response body needed for some hosting added to the aposResponse.js.

sanitize-html

This module provides a simple HTML sanitizer with a clear API.

Adds

• Add onOpenTag and onCloseTag events to enable advanced filtering to hook into the parser. Thanks to Rimvydas Naktinis.

uploadfs 2.24.3 (2025-03-25)

uploadfs copies files to a web-accessible location and provides a consistent way to get the URLs that correspond to those files. uploadfs can also resize, crop and autorotate uploaded images. uploadfs includes S3-based, Azure-based, GCS-based and local filesystem-based backends and you may supply others.

Fixes

• Fix missing variable which led to confusing error messages if the configured image backend is unavailable and prevented automatic fallback from sharp to imagemagick.

1.24.2 (2024-12-09)

Changes

• Corrected npm audit warning by eliminating a dependency on gm which is not actively maintained.