Get AI summaries of any video or article — Sign up free
How I use Tags vs Links in LogSeq thumbnail

How I use Tags vs Links in LogSeq

Tools on Tech·
5 min read

Based on Tools on Tech's video on YouTube. If you like this content, support the original creators by watching, liking and subscribing to their content.

TL;DR

Use bracket links for inline, sentence-readable references—especially for multi-word titles like people, projects, and books.

Briefing

Logseq’s “tags vs links” distinction is mostly visual, but the practical choice matters for how information gets organized, filtered, and surfaced. Bracket links are embedded in the writing flow—often inside sentences—while hashtags function more like labeled markers that you place at the end of blocks. That difference drives most of the workflow decisions: use tags sparingly as bundle-and-filter primitives, and default to links when you want readable, sentence-like references that can include multi-word titles.

Tags in Logseq behave like colored labels in a book: they’re best for grouping related ideas and for quick filtering later. They’re typically written as one-word hashtags (multi-word hashtags get treated like bracket links with a hash prefix), and themes may render them with distinct colors. The transcript notes that there’s no major data-level difference between tags and links, but Logseq treats them differently in edge cases—such as generating a nice list when using page properties and powering the Tag Manager plugin, which shows only tags and ignores links.

Several concrete tag use cases are offered. When journaling, hashtags like “idea” capture thoughts that should be revisited later. In script work, tags like “green screen” act as a lightweight retrieval system: later, it’s easy to “show me all” blocks tagged with that label and jump straight to the relevant take. Because tag colors are theme-driven, customizing them requires editing the CSS theme code; the creator suggests copying an example line and changing the tag name and color.

A special tag variant is also highlighted: using the page-level `tags` property. It applies tags to an entire page rather than a specific block. The workflow has shifted over time—page properties used to support a “type” system (e.g., “type book” vs “type project”), but the plan is to move toward more explicit page tags like “book tag” and “project tag” so books and projects automatically appear as clean lists.

Links, by contrast, are positioned as the default when in doubt. They’re written as part of sentences using brackets, which makes them more readable and natural for entities like people (first and last name), projects (often multi-word titles), and books. The transcript also recommends avoiding “linking tags” or “tagging links,” since mixing the two can create confusion.

Finally, the Tag Manager plugin is used to keep the tag system tidy. After installing and activating it, a tag list appears with search and sorting options based on tag name or usage count. The workflow includes merging duplicates (e.g., combining “tag” into “tags”) and notes that merges may require refreshing and re-indexing so usage counts update correctly. The takeaway is that tags are powerful for lightweight labeling and filtering, while links are better for readable, sentence-integrated references—together forming a practical division of labor in Logseq.

Cornell Notes

Logseq treats tags and links differently in how they surface and manage information, even though the underlying data model is largely similar. Tags work best as one-word, label-like markers for bundling and filtering—such as capturing “idea” entries in a journal or tagging script segments like “green screen” for later retrieval. Links, written inline with brackets, are the default when in doubt because they read naturally inside sentences and support multi-word titles (useful for people, projects, and books). The Tag Manager plugin helps maintain tag hygiene by listing only tags, sorting by usage frequency, and merging duplicates; after merges, refreshing and re-indexing may be needed. Page-level `tags` properties provide a page-wide version of tagging for generating lists.

Why does the transcript treat tags as “bundle and filter” tools rather than general-purpose references?

Tags are positioned like colored markers in a book: they’re meant to group related content and enable quick filtering later. The workflow emphasizes sparing use—too many tags or too many colors reduces usefulness. Tags are also constrained to one-word hashtags for clean behavior; multi-word tags trigger bracket-like behavior. Concrete examples include using `#idea` to capture thoughts for later processing and `#green screen` to quickly retrieve all relevant script takes.

What practical advantages do links have over tags in Logseq?

Links are described as the default because they integrate into writing. Bracket links can be embedded in sentences, making references more readable—e.g., “Ask Person Y” where “Person Y” becomes a link. Links also support spaces, enabling multi-word titles that tags can’t handle cleanly, which is especially useful for people names (first + last), projects, and books.

How does Logseq handle tags differently in edge cases, and why does that matter?

Even with minimal data-driven differences, Logseq distinguishes tags and links in certain situations. Two examples are highlighted: page properties can produce a nice list when tags are used, and the Tag Manager plugin displays only tags while ignoring links. That means choosing tags can directly affect how management and listing features behave.

What is the role of page-level `tags` properties compared with block-level hashtags?

Using the `tags` property at the top of a page applies tags to the entire page rather than a specific block. The transcript notes a shift in usage: page properties were previously used with a `type` approach (e.g., “type book” and “type project”), but the plan is to switch to clearer page tags like “book tag” and “project tag” so books and projects automatically form tidy lists.

How does the Tag Manager plugin help keep a tag system from getting messy?

After installing and activating the Tag Manager plugin, it shows a list of tags that exist in the system (based on actual hashtag usage). It supports searching and sorting by tag name or by usage count. A key maintenance workflow is merging duplicates—such as combining `tag` into `tags`—and then confirming the updated counts. The transcript warns that merges may require refreshing and re-indexing so the usage numbers reflect the changes.

When should someone avoid mixing tags and links?

The transcript recommends not “linking the tags” or “tagging the links,” because it can create confusion. The suggested mental model is separation of roles: tags are specific and limited labels, while links are everything else that benefits from inline, readable references.

Review Questions

  1. In what situations would you prefer a bracket link over a one-word hashtag in Logseq, and why?
  2. How would you use the Tag Manager plugin to reduce duplicate tags, and what follow-up step might be necessary?
  3. What’s the difference between block-level hashtags and page-level `tags` properties, and how could that affect list generation?

Key Points

  1. 1

    Use bracket links for inline, sentence-readable references—especially for multi-word titles like people, projects, and books.

  2. 2

    Use one-word hashtags as sparse labels for bundling and filtering, such as `#idea` for journal prompts or `#green screen` for script retrieval.

  3. 3

    Treat tags as markers: too many tags or too many colors reduces clarity and makes filtering less effective.

  4. 4

    Customize tag colors through CSS theme edits rather than expecting a simple click-based configuration.

  5. 5

    Leverage page-level `tags` properties when the goal is to tag an entire page for list-style outputs.

  6. 6

    Install and activate the Tag Manager plugin to search, sort, and merge duplicate tags based on usage counts.

  7. 7

    After merging tags in the plugin, refresh and re-index if usage numbers don’t update immediately.

Highlights

Tags are framed as label-like markers for grouping and filtering, while links are positioned as the default for readable, inline references.
Links support spaces and multi-word titles, making them especially suitable for names and titled items that tags can’t represent cleanly.
The Tag Manager plugin lists only hashtags (not links) and enables duplicate cleanup by merging tags based on usage frequency.
Merging tags may require refreshing and re-indexing so the plugin’s usage counts stay accurate.

Topics

  • Tags vs Links
  • Logseq Workflow
  • Tag Manager Plugin
  • CSS Tag Colors
  • Page-Level Tags