Home

>

Tools

>

Payload CMS

>

Releases

>

Release 0.13.1

Payload CMS Release: Release 0.13.1

Tag Name: v0.13.1

Release Date: 11/29/2021

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 v0.13.1 is a minor release that fixes a critical sorting issue and improves search functionality. The update ensures proper sorting by MongoDB's _id field instead of an incorrect id property, and optimizes URL query parameters by only including search parameters when they have values.

Highlight of the Release

    • Fixed critical sorting issue to ensure proper sorting by MongoDB's _id field
    • Improved URL cleanliness by only adding search query parameters when values are present

Migration Guide

No migration is required for this update. This is a backwards-compatible release that can be installed without any changes to your existing code or content.

Upgrade Recommendations

This update is recommended for all Payload CMS users, especially those who rely on proper sorting functionality in their collections. The fix for sorting by _id addresses a fundamental issue that could affect data consistency and user experience.

To upgrade:

npm install [email protected]
# or
yarn add [email protected]

Bug Fixes

Sorting Fix

Fixed a critical issue where collections were being sorted by an improper id field instead of MongoDB's native _id field. This ensures that sorting operations work correctly and consistently across all collections, providing more reliable results when paginating through data.

New Features

Search Parameter Optimization

The list view search functionality has been improved to only add search query parameters to the URL when a value is actually present. This results in cleaner URLs and improved user experience when navigating through the admin panel or when using the API for list operations.

Security Updates

No security fixes were mentioned in this release.

Performance Improvements

No specific performance improvements were mentioned in this release.

Impact Summary

This release addresses a fundamental sorting issue in Payload CMS by ensuring collections are properly sorted by MongoDB's _id field rather than an incorrect id property. This fix is important for maintaining data consistency and proper pagination behavior.

Additionally, the improvement to search query parameters results in cleaner URLs by only including search parameters when they have actual values. This creates a better developer experience and more elegant URLs in both the admin panel and API responses.

While this is a minor release with just two changes, the sorting fix in particular is important for ensuring reliable data operations.

Full Release Notes

0.13.1 (2021-11-29)

Bug Fixes

  • ensures sorting by _id instead of improper id (ded891e)

Features

  • only adds list search query param if value is present (d6d76d4)

Statistics:

File Changed4
Line Additions35
Line Deletions56
Line Changes91
Total Commits5

User Affected:

  • Benefit from more reliable sorting functionality when using MongoDB's `_id` field
  • Experience cleaner URLs in list views when no search value is present

Contributors:

jmikrut