Table of Contents - Documentation topics on: documentation,table of contents,toc,.

Table of Contents

Welcome to the dotCMS documentation site. This site contains the documentation for the latest dotCMS release.

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.
  • Documentation on prior release versions can be found under the Older Versions documentation section.
  • 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 4.2.2 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 4.2.2

dotCMS version 4.2.2 is a maintenance release which includes several fixes for reported issues in the 4.2.0 and 4.2.1 releases.

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


dotCMS 4.2.1

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

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


dotCMS 4.2.0

dotCMS 4.2.0 is a significant release which includes performance improvements, several important new features and significant enhancements.

  • REST APIs for Layout as a Service (LaaS):
    • The Page REST API enables retrieval of all the elements of a page as either JSON or fully rendered content, easing implementation of headless CMS/CaaS, single plage applications (SPAs) and other iOT applications.
    • The Content Relationships REST API simplifies pulling of related content, enabling a normal dotCMS content pull to retrieve both the matching content and all content which is related to the content pulled.
  • Push Publishing and Content Editing Performance and Improvements:
    • Performance of content saving and push publishing has been improved, in some cases by more than an order of magnitude.
  • Vanity URLs and Language Variables are Now Content:
    • Both Vanity URLs and Language Variables are now accessible as content by all existing dotCMS features and tools, including Push Publishing, importing, exporting, permissions, and REST API management.
    • A new Key/Value base content type has been added, allowing you to create your own content types for associating strings and content fields with unique keys.
    • A new Vanity URL base content type has been created, and you may both extend and create your own Vanity URL content types.

Only dotCMS instances that are already running dotCMS 4.X can upgrade directly to dotCMS 4.2.0. If you have not already upgrades to dotCMS 4.X, Please see the Upgrading to dotCMS 4.0 documentation for more information on new features included in the dotCMS 4.X versions, and how they may affect your installation when upgrading to dotCMS 4.X from an earlier version of dotCMS.

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


dotCMS 4.1.1

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

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


dotCMS 4.1.0

dotCMS 4.1.0 is a major release which includes performance improvements, several significant new features and significant enhancements.

  • REST APIs to Define and Manage Content Types: Content Type management has been added to the dotCMS REST API
    • New REST Endpoints for defining and managing ContentTypes, Fields and Field Variables
    • New API and builders to programmatically create content types.
  • UI Performance and Improvements: The backend UI performance has been improved
    • Backend Javascript combined and minified for faster UI experience.
    • Notifications cleaner and websockets can be kept alive through proxies or load balancers.
    • IE 11 support
  • OSGi (manageability): Felix directories can now be externalized via configurable properties
    • Felix default directory and subdirectory paths can be configured/customized
  • Hazelcast Caching and Network Discovery (scalability)
    • Hazelcast Embedded and Client Cache Implementations

Only dotCMS instances that are already running dotCMS 4.X can upgrade directly to dotCMS 4.1.0. If you have not already upgrades to dotCMS 4.X, Please see the Upgrading to dotCMS 4.0 documentation for more information on new features included in the dotCMS 4.X versions, and how they may affect your installation when upgrading to dotCMS 4.X from an earlier version of dotCMS.

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


dotCMS 4.0.1

dotCMS version 4.0.1 is a maintenance release which includes a fix for a reported issue in the 4.0 release which prevented some users from being able to start dotCMS without a live Internet connection.

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


dotCMS 4.0.0

dotCMS 4.0.0 is a major release which includes a complete upgrade of the dotCMS back-end UI, as well as several significant new features and enhancements.

  • New Back-end UI: The back-end now uses a state-of-the-art Angular 2 user interface, with major updates to:
    • Look and feel.
    • Navigation and organization.
    • Notifications.
    • URL pathing.
  • Removed Deprecated Features: A number of deprecated legacy features were completely removed.
  • Additional Features and Improvements:
    • JWT Authentication: Authentication on the dotCMS backend has been upgraded to use websockets.
    • Preview as Mobile Devices: You may now create Device profiles which allow you to preview your site as different mobile devices.
    • Dynamic Plugins (OSGI) Version Upgraded: The Apache Felix library has been upgraded to version 5.6.2 and "un-repackaged".
      • If you have any plugins built for earlier versions of dotCMS, please see the Upgrading to dotCMS 4.0 documentation for details on how to make sure your plugins work with dotCMS 4.0.0.
    • Elasticsearch Index Backup/Restore: dotCMS Index backup and restore has been rebuilt to use the Elasticsearch native index snapshot, replacing custom developed code used in previous dotCMS releases.
    • Improved Notifications: The notification engine has been upgraded, and notifications for status of many system tasks (such as rebuilding indexes) has been added.

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

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


dotCMS 3.7.2

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

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


dotCMS 3.7.1

dotCMS version 3.7.1 is a maintenance release which includes some functionality/features improvements and fixes some reported issues in the 3.7 release.

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


dotCMS 3.7.0

dotCMS 3.7.0 is a major release that adds several new features and improvements, including the following:

  • Static Publishing
  • Shorty UUIds in URLs
    • URLs of images can now be included as shortened ("shorty") URLs, both when referenced from within dotCMS pages and when referenced from external sources.
    • For more information, please see the Displaying Content with Binary & Image Fields documentation.
  • Additional Plug-ins and Extensions for Java's ImageIO
    • This improvement adds dotCMS resize/thumbnail support for the following new image types:
      • bmp
      • jpeg
      • tiff
      • pnm
      • psd
      • iff
      • pcx
      • pict
      • tiff
      • sgi
      • tga
      • icns
      • pcx
      • thumbsdb
      • clippath
    • For more information, please see the Image Resizing and Processing documentation.

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


dotCMS 3.6.2

dotCMS version 3.6.2 is a maintenance release which fixes a critical security issue, improves performance, and fixes some reported issues in the 3.6.1 release.

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


dotCMS 3.6.1

dotCMS version 3.6.1 is a maintenance release which adds some performance improvements and fixes a number of reported issues in the 3.6.0 release.

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


dotCMS 3.6.0

dotCMS 3.6.0 is a major release that adds a number of new features and improvements, including the following:

  • Multilingual Features
  • Performance Features
    • New H2 Cache: A new version of the H2 cache has been added with significant performance, scalability, and error handling improvements.
      • Note: The original version of the H2 cache is still supported for backward compatibility.
    • Improved Cache Performance: The way the default cache region is used has been changed to reduce the size of the default cache region and improve performance of cache regions which do not have their own cache chain specified.
    • Streamlined Source Code: A number of deprecated SQL tables, Javascript libraries, auto-clustering settings and default behaviors have been removed, reducing footprint and improving performance.
  • Additional Features and Improvements

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


dotCMS 3.5.1

dotCMS version 3.5.1 is a maintenance release which adds some performance improvements and fixes a number of reported issues in the 3.5 release. Note that all fixes in the 3.5.1 release are already included in the dotCMS 3.6 release.

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


dotCMS 3.5

There are two major new features in dotCMS 3.5 which enable you to customize the display of your site for different users:

  • The new Rules capability is a power feature that enables you to set dotCMS properties and change how your pages are displayed based on visitor information such as visitor location and platform.
  • Rules may easily be built from the many built-in Conditions and Actions, or you may create your own custom Conditions and custom Actions using OSGI plugins.
  • Rules may be accessed and updated both via the Marketing tab in the dotCMS backend, and via the REST API
  • New Personalization features allow you to provide *personalized content* to different users that visit your site based on user preferences and browsing behavior.
    • The Visitors feature provides you with information about each user who visits to your site, including current information (such as user location, language and platform), and historical information (such as the tags of content the user has visited in the past).
    • The Personas feature allows you to define different types of users, and then serve content to each user based on which type of user you've identified them as.
    • The new pullPersonalized method automatically combines the built-in personalization features of both Visitors and Personas, enabling you to easily pull and sort personalized content for different users, displaying the content most relevant to those users at the top of the pull results.

    In addition to these major new features, dotCMS 3.5 also now allows you to sort ElasticSearch queries by score, including giving different weights to different search terms, so the content most relevant to the search terms is automatically displayed at the top of the search results.

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


    dotCMS 3.3.2

    dotCMS version 3.3.2 is a maintenance release which fixes some reported security issues in the 3.3.1 release. Note that all fixes in the 3.3.2 release are already included in the dotCMS 3.5 release.

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


    dotCMS 3.3.1

    dotCMS version 3.3.1 is a maintenance release which adds some performance improvements and fixes a number of reported issues in the 3.3 release. Note that all fixes in the 3.3.1 release are already included in the dotCMS 3.5 release.

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


    dotCMS 3.3

    • dotCMS 3.3 includes several new cache features and improvements for Enterprise license customers:
    • dotCMS 3.3 has been upgraded to log4j version 2.
    • Many improvements have been made to Push Publishing and the Integrity Checker, including automatic detection and resolution of many complex inconsistencies without user intervention.
    • Several improvements were made to the Reindexing feature, including improvements to the handling of errors and additional reindexing actions and options.

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


    dotCMS 3.2

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


    dotCMS 3.1

    Pages are a new Content Type in dotCMS 3.1.

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


    Topics: