Task categories – setup and management

While this is not yet supported by our Task Builder interface, it is possible to assign categories and subcategories to tasks.

This can be useful when you have a large number of tasks to deliver – and we have clients using Task to deliver education content – the tasks are divided into the category “Courses” and subcategory “Modules” – the tasks themselves in this case represent “Lessons”.

Defining a task category/subcategory

Add your task as usual using the Task Editor – once all the details have been added, click the JSON link in the top right:

This will show you the “JSON” that Task uses to describe a task. Look about halfway down the JSON and you will see:

 "verify": false,
 "category": "",
 "subcategory": "",
 "components_attributes": [

Update the category and subcategory values, for example:

 "verify": false,
 "category": "Course 1",
 "subcategory": "Module 1",
 "components_attributes": [

Save your task and refresh the page (to reload the task list on the left) – you will now see your category and subcategory appear:

Go take a look at your project in the mobile app – you’ll find the same category/subcategory reflected there too.

WARNING: You must be sure to use the exact same category and subcategory spelling to avoid problems with the layout!

Defining custom labels

By default the tasks will be organised under the headings “Category” and “Subcategory”. If you would like to change this, go into the Edit Project area and click on “Advanced settings” in the menu:

Here you can define your custom labels for the cats/subcat – so in my education example above I would set the labels like this: 

How to remove categories

Categories and subcategories are added because you have added them inside the Task JSON. If you wish to remove a category or subcategory you have two choices:

1. Edit the tasks that are within a category/subcategory and either change the values in the JSON back to an empty set, or change them to the new values you would like for your task
2. Delete the tasks that are within a category/subcategory

If you want to remove the categorisation from a task, you should end up with this inside your JSON:

"verify": false,
 "category": "",
 "subcategory": "",
 "components_attributes": [

This allows you to use Task as a powerful content delivery tool. Any problems, please drop us a line.