Ghost Release: 1.17.3

TL;DR

Ghost 1.17.3: URL Service Introduction & System Improvements

This minor release introduces a new URL Service for tracking all URLs in the system, adds soft limits for blog title and description, improves build processes to prevent duplicate files, and fixes issues with imports and Slack integrations. The URL Service lays groundwork for future URL customization capabilities while the other changes improve system stability and user experience.

Highlight of the Release

• Introduction of URL Service to track all URLs in the system
• Added soft limits for blog title (150 chars) and description (200 chars)
• Fixed missing errors on failed imports
• Expanded Slack integration to support any Slack-compatible webhook URLs
• Improved build process to prevent duplicate files accumulation

Migration Guide

No migration steps are required for this release. The new URL Service is introduced with a configuration guard to ensure backward compatibility.

Upgrade Recommendations

This is a minor release with new features and bug fixes. We recommend all users upgrade to benefit from the improved import error handling, Slack integration enhancements, and other improvements. Developers working on themes or custom integrations should upgrade to prepare for future URL customization capabilities.

Bug Fixes

Import Error Feedback

Fixed an issue where import failures would occur without displaying appropriate error messages, making it difficult for users to understand what went wrong with their import process.

Build Process Improvements

Addressed issue #8162 by improving the build process:

• Removed core/client/dist from the clean task as Ghost-Admin handles this automatically
• Added clean:built task to run automatically with grunt dev, grunt dev --client, and grunt release commands
• Prevents accumulation of duplicate files in the core/built directory
• Ensures releases don't accidentally include unused built files

New Features

URL Service

A new URL Service has been introduced that tracks all URLs in the system. This lays the groundwork for future URL customization capabilities and improves URL management throughout Ghost. The service:

• Initializes and maintains a registry of all system URLs
• Introduces a resource configuration system via resource config.json
• Allows individual resources to create their own URLs
• Binds to events to update URL data when resources change
• Includes a configuration guard for easy enabling/disabling

Soft Limits for Blog Settings

Added maximum length validations for key blog settings:

• Blog title: 150 characters
• Blog description: 200 characters

These soft limits help guide users toward optimal content lengths for SEO and display purposes.

Security Updates

No security fixes were included in this release.

Performance Improvements

Build Process Optimization

The improved cleaning process for the core/built directory prevents the accumulation of numerous duplicate files, which:

• Reduces disk space usage during development
• Improves build performance by eliminating unnecessary file processing
• Creates cleaner release packages without unused built files

Impact Summary

Ghost 1.17.3 introduces important foundational changes with the new URL Service, which will enable future URL customization features. While this doesn't change functionality for end users immediately, it represents significant architectural groundwork.

The bug fixes for import errors and Slack webhook compatibility directly improve user experience by providing better feedback and more flexibility. The soft limits for blog title and description help guide content creators toward optimal lengths without enforcing hard restrictions.

For developers, the build process improvements solve a long-standing issue with duplicate files accumulating in the build directory, resulting in cleaner development environments and release packages.

Overall, this release combines important architectural improvements with practical bug fixes and enhancements that improve the Ghost experience for all user types.

Full Release Notes