Table of Contents documentation for the dotCMS Content Management System

Welcome to the dotCMS documentation site. This site contains the documentation for the latest dotCMS release; if you would like documentation on a previous dotCMS release, please see the links in the What's New section below, or see the Older Versions documentation.

Getting Started

  • If you're new to dotCMS, we recommend that you review the Requirements page, install dotCMS using the Quick Start Guide, and read the Tutorial: Day One document to begin building your dotCMS site.
  • To access dotCMS documentation on specific topics, please select the appropriate section on the navigation bar to the left, or select from the detailed table of contents at the bottom of this page.
  • To view what's new in the latest dotCMS releases, please see the What's New section, below.
    • For more detailed information on changes in dotCMS and previous dotCMS versions, please see the dotCMS Change Log.
  • Please also browse our growing Video library for instructions and walkthroughs of many dotCMS key features.

dotCMS Versions and Changes

Each of the following sections outlines some of the major changes in the most recent dotCMS releases.

  • For more information on any of these releases, please see the dotCMS Change Log.
  • For documentation on any version other than the latest dotCMS release, please visit the Older Versions documentation section.

What's New in dotCMS 5.3.8

dotCMS version 5.3.8 is a maintenance release which includes several minor improvements and a number of fixes for issues in the 5.3.7 release.

In addition, with the release of dotCMS 5.3.8, support for using MySQL with dotCMS is officially deprecated. For more information, please see the Deprecated Features section of the 5.3.8 changelogs.

For more information on changes in the dotCMS 5.3.8 release, please see the dotCMS Change Log.


dotCMS 5.3.7

dotCMS version 5.3.7 is a maintenance release which includes one significant new feature, several minor improvements and a number of fixes for issues in the 5.3.6 release.

  • The new Apps Integrations feature enables you to create custom configurations to integrate with third-party services and external servers.

For more information on changes in the dotCMS 5.3.7 release, please see the dotCMS Change Log.


dotCMS 5.3.6.1

dotCMS version 5.3.6.1 is a maintenance release which includes a fix for one minor issue in dotCMS 5.3.6 which may affect a number of larger sites.

For more information on changes in the dotCMS 5.3.6.1 release, please see the dotCMS Change Log.


dotCMS 5.3.6

dotCMS version 5.3.6 is a maintenance release which adds one new feature and several minor improvements, removes one deprecated feature, and includesfixes for several issues in the 5.3.5 release.

For more information on changes in the dotCMS 5.3.6 release, please see the dotCMS Change Log.


dotCMS 5.3.5

dotCMS version 5.3.5 is a maintenance release which includes several minor improvements, fixes for two minor security vulnerabilities, and fixes for several issues in the 5.3.4.1 release.

For more information on changes in the dotCMS 5.3.5 release, please see the dotCMS Change Log.


dotCMS 5.3.4.1

dotCMS version 5.3.4.1 is a maintenance release which includes a fix for one significant issue in dotCMS 5.3.4 which may affect all sites, and fixes for several issues which may affect sites which use MSSQL or Oracle databases.

For more information on changes in the dotCMS 5.3.4.1 release, please see the dotCMS Change Log.


dotCMS 5.3.4

dotCMS version 5.3.4 is a maintenance release which includes several minor improvements, and fixes for several issues in the 5.3.2 release.

For more information on changes in the dotCMS 5.3.4 release, please see the dotCMS Change Log.


dotCMS 5.3.3

dotCMS version 5.3.3 is a maintenance release which includes one significant new feature, several minor improvements, and fixes for several issues in the 5.3.2 release.

  • The new Push Publishing Filters allow you to limit what content is pushed by dependency when using Push Publishing.
  • The performance and reliability of Vanity URLs have been significantly improved.

For more information on changes in the dotCMS 5.3.3 release, please see the dotCMS Change Log.


dotCMS 5.3.2

dotCMS version 5.3.2 is a maintenance release which includes some minor new features and improvements, and fixes for several issues in the 5.3.1 release.

For more information on changes in the dotCMS 5.3.2 release, please see the dotCMS Change Log.


dotCMS 5.3.1

dotCMS version 5.3.1 is a maintenance release which includes a fix for one important issue in the 5.3.0 release.

For more information on changes in the dotCMS 5.3.1 release, please see the dotCMS Change Log.


dotCMS 5.3.0

dotCMS 5.3 is a major release which includes upgrades of several dotCMS features, as well as several significant improvements to core dotCMS functionality.

  • An External Elasticsearch server is now both supported by default and required
    • The internal Elasticsearch server is no longer included or supported.
    • All dotCMS Docker reference images include an External Elasticsearch server in the stack.
  • The Content Search screen now supports both Tile View and Drag and Drop file uploading.
  • The new dotAsset Base Content Type enables uploading and managing of files by file type, without requiring each file to have a specific location in the Site Browser tree.
    • You can define multiple dotAsset Content Types, and configure dotCMS to automatically assign uploaded files to the appropriate Content Type based on MIME type.

For more information on changes in the dotCMS 5.3.0 release, please see the dotCMS Change Log.


dotCMS 5.2.8

dotCMS version 5.2.8 is a maintenance release which includes one new feature and fixes for several reported issues in the 5.2.7 release.

New in this release:

  • Front-end user authentication when using the REST API.

For more information on changes in the dotCMS 5.2.8 release, please see the dotCMS Change Log.


dotCMS 5.2.7

dotCMS version 5.2.7 is a maintenance release which includes one new feature, some minor improvements, and fixes for several reported issues in the 5.2.6 release.

New in this release:

  • A new Asset Base Content Type has been added, allowing you to upload files and images into the dotCMS content store without giving them a specific URL path.

For more information on changes in the dotCMS 5.2.7 release, please see the dotCMS Change Log.


dotCMS 5.2.6

dotCMS version 5.2.6 is a maintenance release which includes some minor improvements, and fixes for several reported issues in the 5.2.5 release.

New in this release:

  • Reset Approvers Workflow Sub-action enables full reset of content approvals when using Workflows which depend on Multiple Approvals.
  • You can now set Default Workflow Actions for each Workflow Scheme.
  • This release ships with a new, completely recreated starter site, which provides working examples of many newer features.

For more information on changes in the dotCMS 5.2.6 release, please see the dotCMS Change Log.


dotCMS 5.2.5

dotCMS version 5.2.5 is a maintenance release which includes some minor improvements, and fixes for several reported issues in the 5.2.4 release.

New in this release:

For more information on changes in the dotCMS 5.2.5 release, please see the dotCMS Change Log.


dotCMS 5.2.4

dotCMS version 5.2.4 is an important maintenance release which includes a fix for a critical security vulnerability, as well as a number of minor improvements, and fixes for several reported issues in the 5.2.3 release.

Important:

It is strongly recommended that all customers running dotCMS 5.2.0 through 5.2.3 plan to upgrade to dotCMS 5.2.4 as soon as possible, and all dotCMS customers running earlier releases contact dotCMS support for assistance mitigating issues with your release.

For more information on changes in the dotCMS 5.2.4 release, please see the dotCMS Change Log.


dotCMS 5.2.3

dotCMS version 5.2.3 is a maintenance release which includes a number of minor improvements, and fixes for several reported issues in the 5.2.2 release.

It is recommended that all customers running dotCMS 5.2.0, 5.2.1, or 5.2.2 plan to upgrade to dotCMS 5.2.3 when they are able to do so.

New Features in dotCMS 5.2.3:

  • Custom Elasticsearch field mappings may now be created for individual Content Type fields.
  • The Language REST API now supports Save, Update, and Delete operations.
  • The Page REST API includes several new enhancements to support Single Page Applications (SPAs).

For more information on changes in the dotCMS 5.2.3 release, please see the dotCMS Change Log.


dotCMS 5.2.2

dotCMS version 5.2.2 is a maintenance release which includes a number of minor features and improvements, and fixes for several reported issues in the 5.2.1 release.

It is recommended that all customers running dotCMS 5.2.0 or 5.2.1 plan to upgrade to dotCMS 5.2.2 when they are able to do so.

New Features in dotCMS 5.2.2:

For more information on changes in the dotCMS 5.2.2 release, please see the dotCMS Change Log.


dotCMS 5.2.1

dotCMS version 5.2.1 is a maintenance release which includes a number of minor performance and reliability improvements, and fixes for several reported issues in the 5.2.0 release.

It is recommended that all customers running dotCMS 5.2.0 plan to upgrade to dotCMS 5.2.1 when they are able to do so.

For more information on changes in the dotCMS 5.2.1 release, please see the dotCMS Change Log.


dotCMS 5.2.0

dotCMS 5.2 is a major release which includes major upgrades of several dotCMS features, as well as several significant improvements to core dotCMS functionality.

  • Improved and Simplified Control of Front-end, Back-end, and Unauthenticated Users
    • Each User is now explicitly designated as a Front-end User, Back-end User, both, or neither.
    • Multiple configuration properties controlling Anonymous access to APIs have been consolidated into a single configuration property.
  • Elasticsearch Improvements
    • Elasticsearch indexing has been improved to increase performance and reduce the need for wildcards in query strings.

For more information on changes in the dotCMS 5.2.0 release, please see the dotCMS Change Log.