# Project plan widget

> [HTML Version](project-plan-widget.html)

The widget is used on the [project page](project-card.md) to create, display, and edit the [project plan](project-plan.md) as a diagram with a task list and color scheme along the calendar timeline.

On the project view page, the widget displays a Gantt chart that shows each item of the plan as a list and a color scheme.

By default, the widget is placed on the view forms of the **Projects** and **Project plan** built-in apps and can look as follows:



**(plan-widget-01.png)**

You can also place the widget on forms of other apps or process tasks. In this case, the project plan can be viewed, but editing mode is only available on the project page.

## Configure the Project plan widget

To access the widget settings, open the **Projects **app view form in the [interface designer](interface_designer.md), select the widget, and click the gear icon. The settings form consists of three tabs.

### Main tab

**(plan-widget-02.png)**

- **Current object\***. This field automatically defines an item of the **Projects** app.

- **Project plan**. Define the plan that will be displayed in the widget.

- **Project**. Define the project whose plan will be displayed in the widget.  
  
To fill in the **Project Plan** and **Project** fields, click the **<Not defined>** link and select the item. On the app forms **Projects** and **Project Plan**, these fields do not need to be filled in, because the value is determined automatically from the current object.

- **Basic project plan for comparison**. Specify the version of the plan against which all subsequent drafts will be compared when the [Compare with the current one](create-or-change-plan.md#compare-with-current) option is enabled.

- **Task indexing**. This option is disabled by default. Check the box to index the tasks in the plan. Nesting is taken into account. Please note that the numbers will not be displayed after exporting or importing the plan.

- **Show buttons for editing Project plan**. The option is enabled by default. If you do not want to display the [toolbar](create-or-change-plan.md) above the plan, uncheck it.

- **Show time chart**. The option is enabled by default. If you do not want to display a color scheme in the widget, uncheck the box.

- **Column configuration (JSON)**. In this field, you can set the display of the plan columns as a JSON structure with properties that correspond to the task data. By default, it is configured to show the visibility of the task start and end date, its completion percentage and duration, and the person in charge. You can also disable editing in columns to prevent accidental changes when clicking on a cell.

Examples of column configuration

1. If you want to display a column with task participants, add the following value: \[OBJECT\]. Multiple participants will appear in the table cell as avatars. To view the employee’s full name, simply hover over the avatar.

2. To prevent editing the task start date, add the  \[OBJECT\] parameter: \[OBJECT\]. Users will then only be able to change the data by opening the task page.

- **Editing in modal window**. When the option is disabled, the plan can be edited only on the project page on the **Project Schedule** tab. Enable the option so that the user could open the plan full screen in a separate window for editing.

Also, if this option is enabled, the (clip0218.png) icon will appear above the project plan on the project page. It allows to open the plan for viewing in full-screen mode.

- **Disable inline task creation**. This option is disabled by default. It means that the user can [add a task](create-plan-items.md#inline-create-task) when editing a plan by entering its name in an empty line of the task list. In this case, the creation form does not open, and if you have added fields to the form, the task will be saved without filling them in, including required fields. To disable this task creation option, enable the option. Then the user will only be able to add tasks using the button in the upper left corner of the plan.

### Events and System tabs

You can change the [System settings](common_widget_settings.md) of the widget. They are the same for all widgets and allow you to control widget visibility and access, customize their behavior on hover, and so on.

To finish customizing the widget, click **Save** and then **Publish** on the top panel of the interface designer.

The changes made to the widget can be viewed on the [project page](project-card.md) as well as on the **Project Plan** app pages.