1. TaskRay
  2. TaskRay Support Guide
  3. Customizations

Modify Status Lists and Colors

This feature is available to the following product editions: 
  • Starter
  • Standard
  • Premium

By default, TaskRay organizes tasks into four Status Lists: Holding, Prioritized, Started, and Finished. These lists can be customized to suit the needs of your organization. You can add, remove, and reorder the status lists, as well as change the default list for quick-adding tasks. The colors of the status lists can also be changed, and you can configure which status list values will complete tasks.

 

Modify Status Lists [Admin]

  1. From Setup, navigate to
    • Lightning: Objects and Fields | Object Manager.
    • Classic: Create | Objects.
  2. Select TaskRay Task.
  3. In the Custom Fields & Relationships section, click on List.

From here, you can add, remove, and reorganize status lists. You can also change the default status list for the Quick Add Tasks feature.

 

Add Status Lists

  1. In the Values section, click New.
  2. On the List page, enter the name(s) of the status list(s) that you want to add. Enter each name on a separate line.
  3. Click Save.

ghshOLHmgdAzDvVX3cWTq8D5F-16KWed1g.png

 

Remove Status Lists

  1. In the Values section, click Del next to the status list that you want to delete.
  2. Click OK in the confirmation dialog.
  3. You will be asked what you want to do with records that are associated with that status field (i.e. tasks that have that status/are in that status column in TaskRay). Using the Replace value on records with dropdown, select a new status that you want to migrate the tasks to.

    Note:  It is not recommended to select the Replace value on records with blank value option because that will make the tasks from the deleted status list disappear from TaskRay. If you do select this option, you would have to find the tasks in the standard Salesforce interface and manually assign a new list value to them to make them reappear in TaskRay.

 

Reorganize Status Lists

  1. In the Values section, click on the Reorder button.
  2. On the next screen, change the order of the Values using the Up and Down arrows.
  3. Click Save.

    Note: Reordering status lists will also reorganize the columns in Kanban View accordingly.
 

Set the Default Status List for Quick Add

By default, the status that gets assigned to all new tasks created using Quick Add is Holding. You can change the default task status to any of the other statuses in your org.

  1. In the Values section, click Edit next to the status list that you want to set as the default for Quick Add.
  2. Select the Default - Make this value the default for the master picklist checkbox.
  3. Click Save.

  

Modify Status List Colors [Admin]

Each status list is automatically assigned a color, but the colors can be changed using the instructions below.

The status list colors are used throughout TaskRay for visual reference. Some examples are:

  • Kanban View: At the top of every column it is the color of the circle with the number of tasks.
  • Row View: Every Task Card has a color-coded status box.
  • Plan View: The task bars are color-coded by status (except for overdue tasks, which are always red).
  • My Work View: Every task row has a color-coded status box.

7Pjjvm1KFWaVTTIybqU0TxhIe4egVGetaw__1_.png

 

Below are the instructions for how to change the colors for the task status lists.

  1. In TaskRay, click on the Gear icon in the top right corner in the TaskRay toolbar.
    gear_in_tr_toolbar.png
  2. This will open Tools and Settings. Click on the Admin tab.
  3. In the Task Status List Colors section, use the Color dropdowns to select new colors for the different status lists. You can set colors either by using the color box and dials or by entering a specific HEX code.
    Task_Status_List_Colors.png
  4. When you are done setting the colors, click on the Save button that appears on the bottom right, below the table.
  5. You will see a confirmation message appear below the table. Refresh the page and you should see the new colors assigned to the Task Status Lists.

 

Configure Status Lists to Complete Tasks [Admin]

Each status list value can be configured to complete a task.  By default, the Finished status list value is the only one that completes tasks.  However, you can configure additional status list values to complete tasks by following these steps:

  1. In TaskRay, click on the Gear icon in the top right corner in the TaskRay toolbar.
    gear_in_tr_toolbar.png
  2. This will open Tools and Settings. Click on the Admin tab.
  3. In the Task Status List Colors section, use the Completes Task toggle to configure list status values that should complete tasks.  If you would like the Finished value to continue to complete tasks, make sure to enable the Completes Task setting for that value:Complete_Tasks.png
  4. Click Save.  You will see a confirmation message appear below the table.