Zettlr LogoZettlr Documentation
Setup
Troubleshooting
FAQ
  • About Zettlr
  • Download Zettlr
  • GitHub
  • English
  • Español
  • Deutsch
  • Français
  • Italiano
  • 日本語
  • Português
  • Русский
Setup
Troubleshooting
FAQ
  • About Zettlr
  • Download Zettlr
  • GitHub
  • English
  • Español
  • Deutsch
  • Français
  • Italiano
  • 日本語
  • Português
  • Русский
  • Welcome
  • Getting started

    • Setup
    • Migrating from Obsidian
    • Migrating to a New Computer
    • Installing LaTeX
    • A Note on Security
    • Get involved
    • Troubleshooting
  • First Time Users

    • First Steps
    • Workspaces
    • Creating Files and Folders
    • Writing Markdown
    • Importing Word- and other Documents into Zettlr
    • Exporting Files
  • Interface

    • File Manager
      • Workspaces and Root Files
      • Choosing Which Files To Display
      • File Manager Appearance (Modes)
      • The File List
      • Properties
      • Filtering
      • Global Search
      • Projects
    • Split View
      • Document Tab Bar
      • Markdown Editor
      • Code Editor
      • Image Viewer
      • PDF Viewer
    • Sidebar
      • Table of Contents
      • References
      • Related Files
      • Other Files
  • Writing

    • Markdown Editor
      • Markdown Compendium
      • Appearance
      • Search
      • Autocomplete
      • Footnotes
      • Citations
      • Working With Comments
      • Status Bar
      • Table Editor
      • Text Transforms
      • Snippets
      • YAML Front Matter
    • Language & Style
      • Spellchecking
      • LanguageTool
      • Markdown Syntax
      • Autocorrect and Magic Quotes
      • Readability
    • Scientific & Technical
      • Math
      • Code Blocks
      • Mermaid Diagrams
      • Pomodoro Timer
      • Writing Statistics
    • Exporting
      • Exporting Workflow
      • Defaults Files (Profiles)
      • Selecting the PDF Engine
      • Assets Manager
      • Custom Templates and Reference Documents
      • Custom Commands
      • Printing and Previewing
      • Lua Filters
    • PKMS & Zettelkasten
      • The Zettelkasten method
      • Graph View
      • Tag Manager
  • Guides
    • Custom CSS
    • Reference Manager Integration
    • Setting up LanguageTool locally
    • Presentations
    • Submitting to a Journal using a LaTeX Template
    • Zettlr as a Portable App
  • Reference
    • Keyboard Shortcuts
    • Settings
    • Frequently Asked Questions

Tag Manager

Tag Manager

Zettlr features a comprehensive tagging system to add keywords to your files for a horizontal, non-hierarchical file sorting system. However, as the amount of files in your setup increases, it can become difficult to maintain overview over the tags. In addition, you may want to use some tags in a more functional way, such as #todo or #needs-review.

This is why Zettlr contains a powerful tag manager that allows you to manage the tags in your setup. You can open the tag manager by selecting “File” → “Preferences” → “Tag Manager” (macOS: “Zettlr” → “Tag Manager”).

The Tag Manager Window

The tag manager lists all the tags that the app has found across your files alongside a count and an Inverse Document Frequency (IDF) score. The IDF score is reversely proportional to the amount of files a tag occurs in and offers an informational score as to how important a tag is. The lower the number, the less relevant the keyword likely is for differentiating files from each other. Usually, functional tags will have a very small IDF score, while rarely used tags will have a high score.

Sorting and Filtering Tags

You have various options of viewing your tags. First, you can filter the tags with the input field on top of the list. This can help you find tags you need more quickly.

The table can be sorted by clicking on the column headers. For example, by clicking on the “Count” column label, Zettlr will toggle between listing files with the counts ascending and descending.

Assigning Colors to Tags

In the middle of the tag manager, you will find a “Color” column. You can use this to denote “special” tags (sometimes called “functional” tags) that will give files that contain this tag a special color in appropriate places such as the file list.

For example, you might want to include a “todo” tag or a “needs review” tag. In order to do this, follow these steps:

  1. Assign the tag to at least one file so that it shows up in the tag manager.
  2. Then open the tag manager and search for the tag you want to assign a color to.
  3. Click “Assign color” to choose a color.
  4. Optionally, write a short description into the corresponding field that will be shown when you move your mouse over a color indicator in, e.g., the file list.

To remove the color association from a tag, simply click “Remove color.”

When you are finished, click “Save” to close the tag manager and apply the changes.

Renaming Tags

Lastly, the tag manager allows you to rename tags in bulk. For example, if you have used a given tag frequently, but decided it should be named differently, click “Rename tag.” Write the new tag in the text field and confirm by clicking on “Rename.”

Then, Zettlr will first determine how many files will be affected and give you a final confirmation window that asks you if you really want to replace the provided tag across all affected files. Click “Cancel” to abort the process.

After clicking on “Yes,” Zettlr will immediately begin replacing the tags in all affected files.

Edit on GitHub
Last update: 8/4/26, 2:35 PM
Contributors: Hendrik Erz
Prev
Graph View
Next
Guides
© 2017-2026 by Zettlr and Contributors