Apostrophe 4.18.0: Improved Conditional Fields, Image Links in Rich Text and Image Widgets, and a new Default Rich Text Toolbar

[BoDonkey]

Apostrophe 4.18.0: Improved Conditional Fields, Image Links in Rich Text and Image Widgets, and a new Default Rich Text Toolbar

Hello Apostrophe Community!

Apostrophe 4.18.0 continues our commitment to improving the editorial experience with more options for conditional fields, easy image linking, and expanded rich text editing tools and styles.

pres-4.18.0.mp4

Advanced Conditional Fields with Enhanced Query Capabilities

This release introduces enhancements to conditional field logic, giving developers more precise control over when fields appear in editing interfaces. Conditional fields now support following, enabling fields to be conditionally displayed based on values within deeply nested objects or arrays.

Additionally, conditional fields now support dot notation for conditionals like array length and MongoDB-like query operators including $gt, $gte, $lt, and $lte. This enhancement applies to all conditional fields, allowing developers to create more focused editing interfaces throughout the platform.

Unified Image Linking Experience

We've enhanced how editors work with images by introducing linking capabilities that work consistently whether images are added through the rich text editor or the image widget.

Images are now added as figure elements with caption support, providing better semantic structure and styling opportunities. This structure also enables captions and linking functionality. By default, the widgets allow you to add links to URLs or internal pages. The linkWithType option allows you to add links to any piece-type show page.

Important Styling Note: Developers should review and update their CSS to ensure proper styling of figure-based images. An inline margin: 0 style is added by default, but can be disabled by setting inlineStyles: false in widget configuration.

Streamlined Rich Text Editing

We've expanded the default toolbar and styling options available in the rich text widget, reducing setup work for new projects. Common formatting options that previously required explicit configuration are now available by default, allowing content teams to start creating formatted content immediately.

These enhancements reduce friction in the content creation process while maintaining the flexibility developers need to create customized editorial experiences. To take advantage of these new default settings in an existing project, just remove any project-level rich text widget toolbar options.

Enterprise Contributions: Zero-Downtime Site Management

We're proud to highlight a significant contribution from Michelin to our multisite capabilities. As briefly noted on May 20th, the multisite extension now supports zero-downtime site reloads and proactive site prewarming, enabling enterprise customers to manage large-scale deployments more efficiently. When site configurations change, the system serves requests with existing instances while new instances start in the background, ensuring seamless transitions and improved performance.

Quality of Life Improvements

This release includes several refinements that improve the overall editorial experience:

• Media library download links now work as expected, immediately downloading files rather than navigating away from the current page
• Error pages now include proper cache headers to prevent serving stale error content
• API key permissions have been corrected to provide appropriate access levels for different user roles

---

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

🚀 Happy coding!

Apostrophe 4.18.0

Adds

• Adds MongoDB-style support (comparison operators) for conditional fields and all systems that use conditions. Conditional fields now have access to the following values from the parent schema fields.
• Add followingIgnore option to the string field schema. By default, followingIgnore will be an empty array. This means that any fields being used through following for setting a conditional will also be used to set the string value for the field. A boolean true results in all following values being ignored (not attempted to be used as a value for the field). When an array of strings is used as value, the UI will ignore every item that matches a following field name, but all fields will still be available for conditional operations. See the documentation for more information.
• Adds link configuration to the @apostrophecms/image-widget UI and a new option linkWithType to control what document types can be linked to. Opt-out of the widget inline styles (reset) by setting inlineStyles: false in the widget configuration or contextual options (area).
• Use the link configuration of the Rich Text widget for image links too. It respects the existing linkWithType Rich Text option and uses the same schema (linkFields) used for text links. The extension option can be used to add schema fields to the linkFields that apply only to a single widget (either Rich-Text or Image)
• Adds body style support for breakpoint preview mode. Created new [data-apos-refreshable-body] div inside the container during breapoint preview. Switch body attributes to this new div to keep supporting body styles in breakpoint preview mode.

Changes

• Set the Cache-Control header to no-store for error pages in order to prevent the risk of serving stale error pages to users.

Fixes

• The Download links in the media library now immediately download the file as expected, rather than navigating to the image in the current tab. AposButton now supports the :download="true" prop as expected.
• Using an API key with the editor, contributor or guest role now have a req object with the corresponding rights. The old behavior gave non-admin API keys less access than expected.

Enterprise modules

@apostrophecms-pro/multisite 4.4.0

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.

Adds

• Add prewarmSites option to proactively initialize specified or all site instances during multisite startup, before the server begins listening for traffic, reducing initial request latency for those sites. Thanks to Michelin for contributing this feature.
• Implement zero-downtime site reloads: when a site's configuration changes, serve requests with the existing instance while a new instance starts in the background. Switch seamlessly to the new instance upon successful startup and gracefully shut down the old one after a configurable grace period (oldInstanceGracePeriod). Thanks to Michelin for contributing this feature.

@apostrophecms-pro/palette 4.8.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.

Changes

• Bumps postcss-viewport-to-container-toggle to 2.

Apostrophe modules

@apostrophecms/vite 1.1.0

This extension provides Vite integration for ApostropheCMS projects, enabling module bundling and hot module replacement (HMR) during development.

Changes

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

1.0.0 (2024-12-18)

Fixes

• Uses postcss-viewport-to-container-toggle plugin only on public builds to avoid breaking apos UI out of apos-refreshable.

Utilities

@apostrophecms/apostrophe-astro 1.4.0

This module integrates ApostropheCMS into your Astro application.

Adds

• Add util (currently containing only slugify) and attachment helpers to mimic Apostrophe's Nunjucks helpers.

Fixes

• Fix duplicate function that breaks project builds.

1.3.1 (2025-05-23)

Fixes

• Fix a bug when the Astro app can crash due to live widget preview in some cases.

postcss-viewport-to-container-toggle 1.2.0

A plugin for PostCSS that allows to toggle between viewport and container units based on the presence of a container data attribute.

Adds

• Supports body style in and out of media queries. Also supports body style applied to indentifiers like ids and classes if they exist on the body tag. Uses the new [data-apos-refreshable-body] that exists and replace the body in breakpoint preview in core.

@apostrophecms/stylelint-config-apostrophe 4.3.0

This module provides a stylelint configuration for the Apostrophe team and contributors.

Changed

• Extract custom/require-nested-after-include rule to a standalone @apostrophecms/stylelint-no-mixed-decls plugin and use it.

@apostrophecms/stylelint-config-apostrophe 1.1.0 (2025-06-02)

A Stylelint plugin that enforces Sass's mixed-decls rule — requiring declarations and nested rules to be ordered according to Sass's updated behavior.

1.1.0

Adds

• Added keywords to package.json for better discoverability.

1.0.0 (2025-05-23)

Adds

• Initial commit.