You are browsing the documentation for version 4.2 of OroCommerce, OroCRM and OroPlatform, which is no longer maintained. Read version 5.1 (the latest LTS version) of the Oro documentation to get up-to-date information.

See our Release Process documentation for more information on the currently supported and upcoming releases.

Available in OroCRM Available in OroCommerce

Create a Task

In the Oro application, you can create tasks in a number of ways. In the following sections, you will learn how to:

Add a New Task Manually

To add a task manually:

  1. Navigate to Activities > Tasks in the main menu.

  2. Click Create Task on the top right.

  3. On the Create Task page, fill in the required information:

    • Subject — The name which summarizes what the task is about.

    • Description — Detailed statement of what work is to be done in relation to the task. Use the embedded editor to format text, add images, links, etc.


      • Whether the embedded editor is available is specified in the configuration. If you have access to the system configuration, see the WYSIWYG settings section of the Display Settings description.

      • If you do not have access to the page, contact your administrator who can enable the editor at the organization level.

      • If you are an administrator, see the WYSIWYG settings section of the System Display Settings description.

    • Due Date — The day and time when the task must be completed. Click on the day field to select a day in the calendar dialog, and on the time field to select a time from the list. Alternatively, type in the date and time values.

    • Status — The phase of work on the task (open, in progress or closed).


      If the Task Flow is enabled, you cannot set the task status.

    • Priority — Set the order in which the task should be managed. Can be High, Normal, or Low. Higher-priority tasks should be managed first.

    • Assigned To — The user who is responsible for doing the work related to the task. The task appears in the calendar of the assignee.


      By default, a person who creates a task is selected as its assignee. Change the assignee if required. Select another user from the list. You may use the search field to quickly find the required user: start typing the name of the user and when suggestions appear, click the required name. Alternatively, you may click the hamburger menu next to the field and select the owner in the Select Assigned To dialog.

    • Reminders — A notification about the upcoming task’s due date. Click +Add to configure when and how Oro application reminds the participants about the task:

      • Specify the type of the notification: whether to show a flash message in Oro application or send the notification email.

      • Select the time units in which the time lag between a reminder and the task’s due date is measured: minutes, hours, days, or weeks.

      • Enter what number of selected time intervals the time lag between a reminder and the task’s due date comprises.

      To remove a reminder, click the x icon next to it.


      In Oro applications, the due date and time of the task are displayed according to the recipient’s timezone settings both in the notification emails and flash messages. For instance, if the due time of a task is displayed as 7 a.m. to a user in New York, the due time displayed in the reminder to a user in Tokio is 8 p.m.

    • Context — Select a record that has a meaningful relation to the task. Start entering a record name, and when the list of suggestions appears, click the required name to select it. The task becomes immediately linked to the selected item and is displayed in its Activity section.

  4. Click Save and Close when you are finished.

Add a Task From the User Profile

From a user profile, you can create a task and automatically assign it the user.

To create a task from a user profile:

  1. Open the profile of the user to whom you want to assign a task.

  2. Click More Actions on the top right of the page and then click Assign Task.

    Creating a task from a user profile
  3. In the Assign Task To dialog, specify the required data. Fill in the required information as described in the Add a New Task Manually section.

  4. Click Create Task. The task appears in the Tasks subsection Additional Information on the user profile page.


An administrator may define that users can be specified as a context for a task. In this case, the More Actions list on the user’s profile page will have two similar options: Assign Task and Add Task. The difference between them is the following:

  • When you select Assign Task, the task that you create will be assigned to the user from which profile you perform this action.

  • When you select Add Task, the task that you create can be assigned to any user. However, the user from which profile you perform the action will appear as a context of the task.