Reordering Tasks

dhtmlxGantt provides 2 ways to reorder tasks in the grid:

  1. Drag-and-drop.
  2. Sorting (see details).

The ways are alternative. By default, both modes are disabled.

To enable drag-n-drop reordering, use the order_branch option:

gantt.config.order_branch = true;

Related sample:  Branch ordering

You can take a look at the video guide that shows how to sort and reorder tasks in the grid.

Drag-n-drop within the whole Gantt structure

The order_branch option allows dragging tasks within the same Tree level.

It's also possible to enable the mode in which tasks can be reordered within the whole Gantt. It means that a task can replace another task of any Tree level. To use this type of tasks reordering, use the order_branch_free option:

// reordering tasks within the whole gantt
gantt.config.order_branch = true;
gantt.config.order_branch_free = true;

Related sample:  Drag and drop rows in Grid

Denying dropping to specific positions

To deny dropping tasks to specific positions, use the onBeforeTaskMove or onBeforeRowDragEnd event:

//prevent moving to another sub-branch:
gantt.attachEvent("onBeforeTaskMove", function(id, parent, tindex){
    var task = gantt.getTask(id);
    if(task.parent != parent)
        return false;
    return true;
gantt.attachEvent("onBeforeRowDragEnd", function(id, parent, tindex){
    var task = gantt.getTask(id);
    if(task.parent != parent)
        return false;
    return true;

Improving performance for large datasets

If your Gantt contains lots of tasks, the default mode of branch reordering may slow down the performance. To speed it up, you can make use of the "marker" mode.

gantt.config.order_branch = "marker";

Related sample:  Branch ordering - highlighting mode

In this mode only the name of the task is reordered (on holding the left mouse key) and Gantt is re-rendered only when a task is dropped in the target position (on releasing the key). Unlike the default mode, changing of the task position doesn't involve firing of the onBeforeTaskMove/onAfterTaskMove events.

To prevent dropping of a task in a particular position, use the onBeforeRowDragMove event instead (works only in the "marker" mode).

Highlighting available drop places while drag-&-drop

To highlight available target places during dragging (for example, it's not possible to drag the root node under another root and you want visually inform the user about this), use the onRowDragStart and onRowDragEnd events:

gantt.config.order_branch = true;// order tasks only inside a branch
var drag_id = null;
gantt.attachEvent("onRowDragStart", function(id, target, e) {
    drag_id = id;
    return true;
gantt.attachEvent("onRowDragEnd", function(id, target) {
    drag_id = null;
gantt.templates.grid_row_class = function(start, end, task){
    if(drag_id && != drag_id){
        if(task.$level != gantt.getTask(drag_id).$level)
            return "cant-drop";
    return "";

Reordering tasks vertically in the timeline

Follow the examples given in the How to vertically reorder tasks in the timeline section.

Back to top