Introduction to Supertags

Supertags are the backbone of Tana, it's how you can give structure and context to item lightning fast, keeping your flow.

In this video you'll get an introduction to Supertags, how to create, change and use them.


This video/page has outdated content

Tana is changing at a rapid pace 🚀 While many concepts remain the same, some user interface and features have changed a lot since they first were documented here! Please keep this in mind while browsing.

You can create a supertag by:

Adding a tag to an item, clicking it and insert fields via the configure panel

Create a structure you want, and launching the command "Create supertag"

Remember to have 📋 Fields in the supertag, not regular content if you want to be able to add values in the tagged node.

🏷️ Supertags typically looks like this:

A good way to check if a supertag is right, is thinking "is a" when adding the tag. Marisha is a #person. Oslo is a #city.

Below are examples of how NOT to do it:

  • Supertags #TanaInc

  • or

  • Recipes from #JaneDoe

Supertag configuration

Extend allows you to use the template of an existing supertag. This supertag will be seen as an extension of the chosen supertag, which will make it appear in searches for the extended tag. For example, a #person can be extended by a #colleague or #author. Searching for #person will return all three but #colleague only returns colleagues.

Show as checkbox gives the supertag a checkbox which can be used to track not checked/checked states.

Done state mapping allows you to map the checkbox states to one or more field values. For example, you have a field that has three Task state options: Inbox, Doing, Done. For "not checked", you want this mapped to Inbox and Doing. For "checked" you want this mapped to Done.

Built title from fields allows you to build the title of the node based on its Fields - just tag a node, fill in the fields, and the item gets its title automatically populated. This is a great way for a team to have a consistent way of writing titles.

Navigation shortcuts is a custom target that shows up when you click on the supertag itself. This gives you the option to go straight to the target. If you have a list of tasks, a list of bugs, or a kanban for your team, it basically works like a shortcut that sends users to a default or custom view of a supertag collection.

You can add # to an item without doing anything else. This will behave like any other #, like on Twitter or Instagram. You can find it in search, make lists and a table of it.

Related Content