Home

>

Tools

>

Payload CMS

>

Releases

>

Release 1.1.8

Payload CMS Release: Release 1.1.8

Tag Name: v1.1.8

Release Date: 10/11/2022

Payload CMS LogoPayload CMS

Payload CMS is a modern, self-hosted headless content management system built with TypeScript, Node.js, and MongoDB. It's designed specifically for developers who want full control over their content management system while maintaining a powerful admin interface for content editors.

TL;DR

Payload CMS v1.1.8 introduces two significant features: the ability to create related documents inline while editing another document, and performance improvements through the implementation of use-context-selector for form field access. This release enhances content management workflow efficiency and improves the overall performance of the admin panel, particularly for forms with many fields.

Highlight of the Release

    • Create related documents inline without leaving the current editing context
    • Performance improvements for forms with many fields through context selector implementation
    • Backward compatibility maintained with legacy form watching methods

Migration Guide

No migration is required for this release. The implementation of use-context-selector maintains backward compatibility by preserving the old useWatchForm functionality to avoid breaking changes.

Upgrade Recommendations

This release is recommended for all users, especially those working with complex content models that involve relationships between collections or those experiencing performance issues with large forms. The upgrade should be straightforward with no breaking changes reported.

Bug Fixes

No specific bug fixes were mentioned in this release.

New Features

Create Related Documents Inline

Content editors can now create related documents directly while editing another document. This feature eliminates the need to navigate away from the current editing context, creating a more seamless content creation workflow. When working with relationship fields, users can now add new related content on the fly without losing their place in the current document.

Context Selector Implementation

The admin panel now uses use-context-selector for form field access, which provides significant performance improvements, especially for forms with many fields. This targeted approach to context consumption means that components only re-render when their specific data changes, rather than when any part of the form context updates.

Security Updates

No security fixes were mentioned in this release.

Performance Improvements

Form Field Performance Optimization

The implementation of use-context-selector for form field access significantly improves the performance of forms, especially those with many fields. Previously, changes to any part of a form could trigger re-renders across the entire form. With this update, components only re-render when their specific data changes.

This optimization is particularly noticeable in complex forms with numerous fields, where the admin interface will now feel more responsive and efficient during content editing.

Impact Summary

Payload CMS v1.1.8 focuses on enhancing the content editing experience and improving performance. The ability to create related documents inline streamlines content workflows by eliminating context switching, while the implementation of context selectors significantly improves form performance.

These improvements are particularly valuable for content-heavy sites with complex relationships between collections. Content editors will appreciate the more fluid workflow, and developers will benefit from the performance optimizations without needing to make any changes to their existing code.

The release maintains backward compatibility, making it a safe upgrade for existing projects.

Full Release Notes

1.1.8 (2022-10-11)

Features

  • adds ability to create related docs while editing another (1e048fe)
  • implements use-context-selector for form field access (5c1a3fa)

Statistics:

File Changed55
Line Additions1,344
Line Deletions477
Line Changes1,821
Total Commits15

User Affected:

  • Can now create related documents without leaving the current editing context
  • Will experience a more responsive admin interface when working with complex forms
  • Can maintain workflow continuity when needing to create related content

Contributors:

jmikrut