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

This documentation is a static copy for this version. For current documentation, see: http://dotcms.com/docs/latest

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


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 JSON based ContentTypes
    • New REST Endpoints for defining and managing ContentTypes, Fields and Field Variables
    • New API and builders to programmatically create content types.
    • Backwards compatible
    • Old structure code, factories and caches are all deprecated.
  • 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.
    • Gravatar.com Avatar Support
      • Provides users with a “global avatar”
    • Upgraded to Angular 2.4.10
    • IE 11 support
    • Numerous fixes and improvements
  • OSGi (manageability): Felix directories can now be externalized via configurable properties
    • jamm.jar is no longer required to use OSGI plugins and can be removed.
    • Felix default directory and subdirectory paths can be configured/customized
  • Hazelcast Caching and Network Discovery (scalability)
    • Hazelcast Embedded and Client Cache Implementations
    • Hazelcast replaces JGroups for network discovery and topology
    • Performance optimizations on distributed caches invalidations (for Hazelcast and Redis) so cache-messages and invalidation-operations are not unnecessarily spread over cluster members
  • Additional Features and Improvements:
    • System Performance (performance / Scalability): Caffeine Cache is now the default cache provider
    • Velocity Performance  (performance / Scalability): Velocity objects in-memory size reduced 50-75%
    • OSGi (manageability): Felix properties have been added for customization/externalization of OSGI plugins.
    • Image tooling: Image tooling now supports generating progressive jpegs for more responsive designs

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.


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


    dotCMS 3.0

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


    Topics: