Symbol Docs
Features

Tags and categories

Two ways to classify a capsule, one free-form and one from a fixed list.

A capsule can carry tags and categories. They look similar and do different jobs.

  • Tags are yours. You invent them, and there is no list to pick from.
  • Categories come from a fixed taxonomy. You choose from what exists, and anything else is refused.

Use tags for how you think. Use categories when you want a capsule to sit in a shelf everyone shares.

Tags

Add up to twenty tags to a capsule.

Tags are normalized before they are stored, so "Foo Bar" and "foo-bar" become the same tag rather than two. That means you cannot accidentally split a group in half by capitalising it differently.

A few tags cannot be stored and are dropped:

  • anything purely numeric, such as 1972
  • anything with no letters or digits left after normalizing, such as !!!

The tag box refuses such a tag when you add it, and says why, so it never becomes a chip. Text you type in the tag box but do not enter is added as a tag when you save.

If a tag is dropped, or you exceed twenty, the rest still save and you are told what happened. The write does not fail. After a save, the editor names the tags that were not saved.

Suggestions as you type

The tag box suggests tags as you type. Suggestions come only from capsules you can already read, so tag names from other people's capsules never appear, even though the underlying tag list is shared.

Renaming or merging a tag

On the Tags page you can rename a tag across every capsule you can edit, including shared workspaces. If you already use the new name, the two tags merge, and the page tells you so before anything changes.

A rename can be undone. Right after it, the page offers Undo, and Recent renames lists the renames you made in the last 30 days, each with its own Undo. Undoing a merge is exact: a capsule that only had the old tag gets the old tag back, and a capsule that already had both keeps both. A rename whose changes have partly expired says how many of them can still be undone. Undoing a rename needs a plan that includes revisions.

Each capsule's history also shows the tags a rename added and removed on it. See Revisions.

A link to a Type page opens that Type in the Symbol app when the app is installed, whether someone sent it to you or you paste it into Open a link. A link from a tag, which is a Type page filtered by that tag, opens the Type with the tag applied. The app names the tag above the list, and Clear filters shows every capsule in the Type again.

A link that does not say which workspace it belongs to can match a Type of the same name in more than one of your workspaces. The app then asks which one to open. A link to a Type you cannot see shows that it is unavailable, without saying whether the Type exists.

Categories

Add up to ten categories, chosen from the curated taxonomy. An unknown category is rejected outright, and the error names the value that was wrong.

That strictness is the point: categories are only useful for grouping if everyone is using the same words.

Replacing rather than adding

When you edit a capsule and supply tags or categories, the list you send replaces what was there. Send an empty list to clear them. Leave the field out entirely to keep them as they are.

On this page