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 document: A Guided Tour of dotCMS 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 ChangeLog.
  • 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 ChangeLog.
  • For documentation on any version other than the latest dotCMS release, please visit the Older Versions documentation section.

What's New in dotCMS 21.10

dotCMS version 21.10 is a release which includes new features, announcements, several improvements and a number of fixes for issues in the 21.09 release.

This release has no breaking changes

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


dotCMS 21.06.3

dotCMS version 21.06.3 is a LTS release which includes new features, announcements, several improvements and a number of fixes for issues in the 21.06 release.

Breaking Changes:
  • The rest call /api/v2/users no longer exists please use /api/v1/users instead. Any use of /api/v2/users needs to be replaced.

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


dotCMS 21.09

dotCMS version 21.09 is a release which includes new features, announcements, several improvements and a number of fixes for issues in the 21.08 release.

Breaking Changes:
  • The rest call /api/v2/users no longer exists please use /api/v1/users instead. Any use of /api/v2/users needs to be replaced.

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


dotCMS 21.08

dotCMS version 21.08 is a release which includes new features, announcements, several improvements and a number of fixes for issues in the 21.06 release.

Breaking Changes:
  • dotCMS is moving from away from using Hibernate. If your company uses Hibernate in your custom code it needs to be updates.
  • dotCMS is moving from Alpine a musl based docker image to Ubuntu LTS a glibc docker image. The minimized JAva 11 distribution being used may not contain all the modules you are relying on for plugins.
  • dotCMS will be completely deprecating support for Java 8 as of this version 21.08 and instead requiring Java 11 to run.

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


dotCMS 21.06

dotCMS version 21.06 is a release which includes new features, announcements, several improvements and a number of fixes for issues in the 21.05 release.

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


dotCMS 21.05.1

dotCMS version 21.05.1 is a release which includes new features, announcements, several improvements and a number of fixes for issues in the 21.04 release.

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


dotCMS 5.3.8.5

dotCMS version 5.3.8.5 is a LTS release which includes new features, announcements, several improvements and a number of fixes for issues in the 5.3.8.4 release.

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


dotCMS 21.04

dotCMS version 21.04 is a release which includes new features, announcements, several improvements and a number of fixes for issues in the 21.03 release.

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


dotCMS 21.03

dotCMS version 21.03 is a release which includes new features, announcements, several improvements and a number of fixes for issues in the 21.02 release.

  • The "Getting Started" tool has been added to dotCMS. This allows new admins to create faster and easier on dotCMS

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


dotCMS 21.02.2

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

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


dotCMS 5.3.8.4

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

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


dotCMS 5.2.8.4

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

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


dotCMS 21.01

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

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


dotCMS 20.11.1

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

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


dotCMS 20.11

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

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


dotCMS 5.3.8.2

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

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


dotCMS 20.10.1

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

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


dotCMS 5.3.9

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

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


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.2.8.3

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

For more information on changes in the dotCMS 5.2.8.3 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.


dotCMS 5.1.6

dotCMS version 5.1.6 is a maintenance release which includes one security improvement, and fixes for several reported issue in the 5.1.1 and 5.1.5 releases.

It is recommended that all customers running dotCMS 5.1.1 and 5.1.5 plan to upgrade to dotCMS 5.1.6 when they are able to do so.

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


dotCMS 5.1.5

dotCMS version 5.1.5 is a maintenance release which includes some significant performance improvements, minor feature additions, and fixes for a number of issues, including one significant security issue.

It is recommended that all customers running versions of dotCMS prior to !{version} upgrade to dotCMS 5.1.5 as soon as they are able to do so.

Customers who choose to delay their upgrade to dotCMS 5.1.5 for any reason are strongly encouraged to contact dotCMS support to ensure your older installation is configured properly to prevent security issues fixed by the 5.1.5 release.

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


dotCMS 5.1.1

dotCMS version 5.1.1 is a maintenance release which includes a fix for one reported issue in the 5.1.0 release.

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

For more information on changes in the dotCMS 5.1.1 release, please see the dotCMS Change Log.
To view the documentation for dotCMS 5.1.1, please see the Older Versions documentation.


dotCMS 5.1.0

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

  • New Relationships Field
    • Supports One-to-One Relationships.
    • Supports Relationships which are only visible from one side of the Relationship.
  • GraphQL API
    • Enables retrieving content using the dynamic GraphQL query language via the REST API.
    • GraphQL provides flexibility in choosing what content is returned and how it is returned, reducing response traffic, easing result parsing, and insulating application code from future content and Content Type changes.
  • Containers as Files
    • Allows you to create and manage Containers using files.
    • Supports CI/CD by allowing management of Containers and Container code via WebDAV and other file-based operations.
  • Custom REST Endpoints
    • You can now create your own custom REST endpoints using VTL files.
    • Supports all standard HTTP methods for RESTful services, including GET, PUT, POST, PATCH, and DELETE.
    • API code is all contained in VTL files, so it may be managed via WebDAV and other file-based operations to support CI/CD.

For more information on changes in the dotCMS 5.1.0 release, please see the dotCMS Change Log.
To view the documentation for dotCMS 5.1.0, please see the Older Versions documentation.


dotCMS 5.0.3

dotCMS version 5.0.3 is a maintenance release which includes several fixes for reported issues in the 5.0.1 release.

It is recommended that all customers running dotCMS 5.0.0, 5.0.1, or 5.0.2 plan to upgrade to dotCMS 5.0.3 when they are able to do so.

For more information on changes in the dotCMS 5.0.3 release, please see the dotCMS Change Log.
To view the documentation for dotCMS 5.0.3, please see the Older Versions documentation.


dotCMS 5.0.2

dotCMS version 5.0.2 is a maintenance release which includes several fixes for reported issues in the 5.0.1 release, and fixes for two newly discovered security vulnerabilities in dotCMS.

It is recommended that all customers running dotCMS 5.0.0 or 5.0.1 upgrade to dotCMS 5.0.2 as soon as possible.

For more information on changes in the dotCMS 5.0.2 release, please see the dotCMS Change Log.
To view the documentation for dotCMS 5.0.2, please see the Older Versions documentation.


dotCMS 5.0.1

dotCMS version 5.0.1 is a maintenance release which includes several fixes for reported issues in the 5.0.0 release.

For more information on changes in the dotCMS 5.0.1 release, please see the dotCMS Change Log.
To view the documentation for dotCMS 5.0.1, please see the Older Versions documentation.


dotCMS 5.0.0

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

  • New Page Editor
    • Customizable Per-page Layouts
    • Drag-and-drop Page Editing
  • New Workflow Features and Improvements
    • Drag-and-drop Workflow builder
    • Workflow Action filter to display actions available to specific users and Roles
    • Multiple Workflow Schemes may be assigned to a single Content Type
    • The same Workflow Action can be assigned to multiple Workflow Steps
    • Workflow Actions can be visible based on the state of the content
    • Workflow Action permissions can be assigned based content permissions
    • New "Save Draft" workflow sub-action
    • The "System Workflow" (the default Workflow for all content types) is now editable (but always resettable)
    • Workflow Bulk Actions enable you to easily perform appropriate bulk actions on any selected group of content, for any Workflow
    • New Workflow REST API endpoint
  • New Drag-and-drop Content Type Editor allows drag-and-drop creation and management of Content Type fields.
  • New Embedded Google Analytics Reporting
  • A number of deprecated legacy features were completely removed.

Please see the Upgrading to dotCMS 5.0 documentation for more information on how the new features and changes may affect your installation when upgrading to dotCMS 5.0 from an earlier version of dotCMS.

For more information on changes in the dotCMS 5.0.0 release, please see the dotCMS Change Log.
To view the documentation for dotCMS 5.0.0, please see the Older Versions documentation.


dotCMS 4.3.3

dotCMS version 4.3.3 is a maintenance release which includes several fixes for reported issues in the 4.3.x series of releases.

For more information on changes in the dotCMS 4.3.3 release, please see the dotCMS Change Log.
To view the documentation for dotCMS 4.3.3, please see the Older Versions documentation.