Strapi Release: 3.0.1

TL;DR

Strapi v3.0.1 is a maintenance release that addresses several bugs and enhances documentation following the major v3.0.0 release. Key improvements include fixes for the cron system, email sending with SES, language middleware, and browser opening behavior. Documentation has been significantly updated, including terminology changes from "Content" to "Collection" types, and community support has moved to GitHub Discussions.

Highlight of the Release

• Fixed cron system to properly check for server.cron.enabled option
• Fixed SES email sending by passing required message key
• Improved browser opening behavior to use localhost instead of 0.0.0.0
• Fixed language middleware issues
• Updated documentation to use 'Collection' type instead of 'Content' type
• Moved community support to GitHub Discussions
• Fixed Heroku SSL certificate issues with PostgreSQL 8.0.0+

Migration Guide

Migrating from v3.0.0 to v3.0.1

This is a patch release with no breaking changes, so upgrading should be straightforward:

1. Update your Strapi version in your package.json:

   "dependencies": {
     "strapi": "3.0.1",
     "strapi-admin": "3.0.1",
     "strapi-connector-bookshelf": "3.0.1",
     "strapi-plugin-content-manager": "3.0.1",
     "strapi-plugin-content-type-builder": "3.0.1",
     "strapi-plugin-email": "3.0.1",
     "strapi-plugin-graphql": "3.0.1",
     "strapi-plugin-upload": "3.0.1",
     "strapi-plugin-users-permissions": "3.0.1",
     "strapi-utils": "3.0.1"
   }
   

2. Run npm install or yarn install to update to the new version.

3. If you're using Heroku with PostgreSQL 8.0.0+, the SSL certificate issue is now fixed. No additional configuration is needed.

4. If you're using the cron feature, ensure your configuration properly uses the server.cron.enabled option.

5. If you're using SES for email sending, this release fixes issues with message keys and altText.

Upgrade Recommendations

Recommendation Level: Recommended for all users

This patch release (v3.0.1) fixes several important bugs and improves documentation following the major v3.0.0 release. While there are no security vulnerabilities addressed, the fixes for cron functionality, email sending with SES, and Heroku PostgreSQL deployments make this update valuable for most users.

Who should upgrade immediately:

• Users deploying on Heroku with PostgreSQL 8.0.0+
• Users experiencing issues with the cron system
• Users using Amazon SES for email sending
• Users experiencing issues with the language middleware

Upgrade Effort: Low - This is a patch release with no breaking changes, requiring only a simple dependency version update and reinstallation of packages.

Bug Fixes

Core Framework Fixes

• Fixed cron system to properly check for server.cron.enabled option to work (#6419)
• Fixed language middleware issues (#6387)
• Improved browser opening behavior to use localhost instead of 0.0.0.0 (#6391)
• Fixed serverUrl to be absolute for watch-admin (#6405)

Plugin Fixes

• Email: Fixed SES email sending by passing required message key and altText (#6378)
• GraphQL: Fixed typo in GraphQL User permissions payload (changed "Persmissions" to "Permissions") (#6390)

Admin Panel Fixes

• Fixed issue #1766 in the admin panel (#6373)
• Fixed snapshots in admin tests (#6404)

Documentation Fixes

• Fixed multiple documentation links to v3 (#6375)
• Fixed typos in configurations.md (#6362)
• Fixed documentation at plugins/upload (#6376)
• Fixed erroneous double quote in custom extensions/documentation/config/settings.json example (#6257)
• Fixed lifecycles documentation

Deployment Fixes

• Fixed Heroku SSL certificate issues with PostgreSQL 8.0.0+ by setting SSL options to "ssl": { "rejectUnauthorized": false } (#6050)

New Features

Community Support Changes

• Moved community support from Stack Overflow and Spectrum to GitHub Discussions
• Added RFCs information to the contribution documentation

Documentation Updates

• Updated tutorial files to use the Collection type instead of Content type
• Added note about CLI migration feature coming in stable release
• Updated GCP host information in beta docs

Security Updates

Security Documentation Updates

• Updated Security MD to reference the stable release instead of beta versions
• Improved security documentation to align with the v3.0.x stable release

No critical security vulnerabilities were fixed in this release.

Performance Improvements

Browser Performance

• Improved browser opening behavior by using localhost instead of 0.0.0.0, which provides a better developer experience and potentially faster local connections
• Made serverUrl absolute for watch-admin, improving the development workflow

Documentation Structure

• Removed old files and cleaned up documentation structure, which should improve documentation loading and navigation performance

Impact Summary

Strapi v3.0.1 is a maintenance release that addresses several bugs and enhances documentation following the major v3.0.0 release. The most significant fixes include resolving issues with the cron system, email sending with Amazon SES, language middleware, and Heroku PostgreSQL deployments.

For developers, this release improves the development experience by fixing browser opening behavior and making serverUrl absolute for watch-admin. Heroku users benefit from a fix for self-signed certificate SSL issues with PostgreSQL 8.0.0+.

Documentation has been significantly updated, including terminology changes from "Content" to "Collection" types throughout the tutorials and guides. Community support has also been reorganized, moving from Stack Overflow and Spectrum to GitHub Discussions.

This release contains no breaking changes and is recommended for all users of Strapi v3.0.0, especially those experiencing issues with the fixed components or deploying on Heroku.

Full Release Notes