Ghost Release: 2.12.0

TL;DR

Ghost 2.12.0 introduces several UI improvements and bug fixes that enhance the editing experience and fix critical issues with the Content API. Key improvements include customizable Slack integration usernames, better tab identification with post titles in document titles, and fixes for search results, image handling, and user management. This release focuses on refining the user experience and addressing specific pain points reported by the community.

Highlight of the Release

• Customizable Slack integration usernames for better team communication
• Post titles now appear in browser tab titles for easier navigation between multiple editor tabs
• Fixed Content API issues with page filters and prev/next post helpers
• Improved night shift mode with better border visibility
• Fixed admin search results sometimes incorrectly showing 'No results'

Migration Guide

This release doesn't require any specific migration steps. The update from 2.11.1 to 2.12.0 should be straightforward:

1. Back up your Ghost installation and database before upgrading
2. Follow the standard update procedure for your installation method (CLI, Docker, or manual installation)
3. If you're using custom themes, test that they work correctly with the fixed helpers ({{img_url}} and {{prev/next_post}})
4. If you're using the Slack integration, you can now customize the username in the integration settings

No database schema changes or breaking changes are included in this release.

Upgrade Recommendations

This release is recommended for all Ghost users, especially those who:

• Use the Slack integration and want more customization options
• Work with multiple posts open in different browser tabs
• Use the night shift mode regularly
• Have experienced issues with admin search results
• Use the Content API with page filters or the {{prev/next_post}} helper
• Use Gravatar images or other protocol-relative URLs with the {{img_url}} helper

The upgrade is low-risk with no breaking changes, so all users should update at their earliest convenience to benefit from the bug fixes and improvements.

Bug Fixes

Admin Interface

• Fixed admin search results sometimes incorrectly showing "No results" for valid queries
• Fixed sticky "Unsaved changes" modal that would sometimes persist when leaving the editor

Content API and Helpers

• Fixed {{img_url}} helper to properly work with protocol relative URLs such as Gravatar images
• Fixed Content API not respecting forced page filters
• Fixed {{prev_post}} and {{next_post}} helpers when using Content API

Database Management

• Fixed issue where associated roles_users rows weren't being deleted when a user was destroyed, preventing proper cleanup

New Features

Customizable Slack Integration Usernames

You can now configure the username that appears when Ghost posts to Slack through the integration. This provides more flexibility in how your Ghost content appears in your team's Slack channels.

Improved Tab Navigation

Post titles now appear in the document title when editing, making it much easier to identify which post you're working on when you have multiple editor tabs open in your browser.

Enhanced Night Shift Mode

The night shift mode has been improved with better border visibility when hovering over elements, creating a more consistent and polished dark mode experience.

Security Updates

While there are no specific security vulnerabilities addressed in this release, the dependency updates and code refactoring around authentication and permissions handling contribute to a more secure platform overall. The work on API key authentication lays groundwork for more secure API access in future releases.

Performance Improvements

This release includes several dependency updates that improve overall system performance and security:

• Updated multiple dependencies including moment, knex, bookshelf, and several testing dependencies
• Removed outdated grunt-docker from dev dependencies to eliminate security warnings
• Optimized authentication and permissions handling for API requests

Impact Summary

Ghost 2.12.0 delivers quality-of-life improvements for content creators and administrators while fixing several important bugs in the Content API and theme helpers. The addition of customizable Slack usernames and improved browser tab identification make daily workflows more efficient, while fixes to search results and the "Unsaved changes" modal eliminate frustrating UI issues.

Behind the scenes, significant refactoring of the authentication and permissions systems lays groundwork for future improvements to the API. Theme developers will appreciate the fixes to critical helpers like {{img_url}} and {{prev/next_post}}, which now work more reliably with protocol-relative URLs and the Content API.

Overall, this is a solid maintenance release that improves the Ghost experience across multiple user types without introducing breaking changes.

Full Release Notes