Ghost Release: 3.16.1

TL;DR

Ghost 3.16.1 is a maintenance release that fixes three important bugs affecting navigation, administrator permissions, and structured data for publisher logos. This release ensures proper navigation functionality, restores administrator ability to edit post visibility, and fixes structured data issues that could impact SEO performance with Google.

Highlight of the Release

• Fixed a logic error in navigation for the isSecondary property
• Restored permission for Administrators to edit post visibility
• Fixed structured data issue for publisher logo to comply with Google requirements
• Updated multiple dependencies including members-api with subscription management improvements

Migration Guide

No migration steps are required for this release. This is a maintenance update that can be applied without any special considerations.

Upgrade Recommendations

This release fixes several important bugs that affect navigation functionality, administrator permissions, and SEO performance. All Ghost users should upgrade to version 3.16.1, especially those who:

1. Use navigation with secondary items
2. Have administrators who need to edit post visibility
3. Care about proper structured data for SEO with Google

The upgrade process should be straightforward with no breaking changes reported.

Bug Fixes

Navigation Logic Fix

Fixed a logic error in the navigation system that affected the isSecondary property. The fix ensures that isSecondary is always a boolean value (true or false) rather than potentially undefined or another value type. This improves the reliability of navigation rendering and behavior.

Administrator Permission Fix

Resolved an issue where Administrators were unable to edit post visibility settings due to a typo in a role name. This bug prevented users with the "Administrator" role from modifying the visibility attribute of posts. The fix restores this important functionality and adds unit tests to verify administrator-specific role permissions.

Structured Data Fix for Publisher Logo

Fixed an issue with structured data for publisher logos that could impact SEO performance. Google requires an ImageObject to be always returned for publisher.logo in structured data. The previous implementation had issues with nested URL properties. This fix ensures that an ImageObject with at least url and @type properties is always returned, with dimensions included when available.

New Features

No new features were introduced in this maintenance release. The focus was on bug fixes and dependency updates.

Security Updates

No security fixes were mentioned in this release.

Performance Improvements

No specific performance improvements were highlighted in this release. The focus was primarily on bug fixes and dependency updates.

Impact Summary

Ghost 3.16.1 is a targeted bug fix release that addresses three specific issues:

1. Navigation Logic: Fixes how the isSecondary property is handled, ensuring it's always a proper boolean value, which improves navigation reliability.

2. Administrator Permissions: Restores the ability for users with the "Administrator" role to edit post visibility settings, which was broken due to a typo in role name configuration.

3. SEO Structured Data: Ensures proper implementation of the publisher logo in structured data to comply with Google's requirements, which helps maintain optimal search engine performance.

Additionally, the release includes several dependency updates, most notably to the members-api component, which brings improvements to subscription management including the ability to update plans by nickname and better handling of member metadata in Stripe checkout sessions.

These fixes, while not introducing new features, ensure that existing functionality works as expected and maintains compatibility with external services like Google Search.

Full Release Notes