How I use Tags vs Links in LogSeq
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.
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?
What practical advantages do links have over tags in Logseq?
How does Logseq handle tags differently in edge cases, and why does that matter?
What is the role of page-level `tags` properties compared with block-level hashtags?
How does the Tag Manager plugin help keep a tag system from getting messy?
When should someone avoid mixing tags and links?
Review Questions
- In what situations would you prefer a bracket link over a one-word hashtag in Logseq, and why?
- How would you use the Tag Manager plugin to reduce duplicate tags, and what follow-up step might be necessary?
- What’s the difference between block-level hashtags and page-level `tags` properties, and how could that affect list generation?
Key Points
- 1
Use bracket links for inline, sentence-readable references—especially for multi-word titles like people, projects, and books.
- 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
Treat tags as markers: too many tags or too many colors reduces clarity and makes filtering less effective.
- 4
Customize tag colors through CSS theme edits rather than expecting a simple click-based configuration.
- 5
Leverage page-level `tags` properties when the goal is to tag an entire page for list-style outputs.
- 6
Install and activate the Tag Manager plugin to search, sort, and merge duplicate tags based on usage counts.
- 7
After merging tags in the plugin, refresh and re-index if usage numbers don’t update immediately.