Skip to main content

Relations & Links

Connect documents to each other with internal relations and external links

Published: April 17, 2026

Relations & Links

Relations connect any two documents in your workspace so you can track dependencies and build context. External links let you attach URLs with auto-fetched metadata to any document.

Internal Relations

What is a Relation

A relation is a directed link from one document to another. It appears in the Relations panel on any document detail page. The main Relations panel lets you relate tasks, projects, lists, spaces, leads, deals, customers, contacts, organizations, and tickets to each other. Pages link to other documents through a separate Pages panel on the document detail page, not through the main Relations search.

Relation Types

Every relation has a type that describes the nature of the connection.

TypeColorDescription
RelatedBlueA general connection between two documents
DependsOrangeThe current document depends on the target document
BlockerRedThe target document is blocking progress on the current document
ChildPurpleThe target document is a child of (subordinate to) the current document

The default type for new relations is Related.

Adding a Relation

Before you begin: You need write permission on the source document. Members, Editors, and Admins can create relations. Viewers see relations but cannot add them.

  1. Open any document in your workspace
  2. Locate the Relations panel on the detail page
  3. Click the search bar that reads “Search for tasks, lists, projects, spaces, or paste a URL…” (pages are not searchable here — use the Pages panel instead)
  4. Type the name of the document you want to link
  5. Click the matching result from the dropdown list

The relation is created immediately. Mosic shows a confirmation message. The linked document now appears in the Relations list.

Viewing Relations

The Relations panel has two tabs at the top:

  • Relations — shows outgoing links you created from this document
  • Back Relations — shows incoming links from other documents pointing to this one

The count next to each tab tells you how many links exist in each direction. If there are no outgoing relations but there are incoming ones, Mosic automatically switches to the Back Relations view.

Each relation card displays the target document title, type badge, status, and metadata such as assignees or due dates. Click a relation card to open the linked document.

Back Relations

Back Relations show you which documents link to the current one. When another document creates a relation pointing here, it appears under the Back Relations tab.

Relation types are reversed for back relations. If Document A marks Document B as a Depends relation, Document B sees that relation as Blocker in its Back Relations tab.

Auto-Generated Relations

Mosic creates relations automatically when you mention a document using the @mention feature in block-based descriptions (Editor.js format). The mentioned document appears as a Related link in the Relations panel. Auto-generated relations use the Related type by default, but you can change the type or delete them the same way as any other relation. Plain-text mentions outside of block-based editors do not create auto-relations.

You can attach any URL to a document as an external link. Mosic fetches the page title, description, favicon, and preview image automatically.

Before you begin: You need write permission on the source document, the same as creating internal relations.

  1. Open any document in your workspace
  2. Locate the Relations panel on the detail page
  3. Paste a URL into the search bar
  4. Mosic detects the URL and shows the “Add as External Link” option with a URL badge
  5. Click “Add as External Link”

Mosic fetches the page metadata and creates the link. The external link card shows the page title, domain, description, favicon, and preview image when available. Click the card to open the URL in a new browser tab.

External links appear alongside internal relations in the Relations list. Each external link card shows:

  • Page title or URL
  • Domain name in a badge
  • Description (when available)
  • Favicon (when available)
  • Preview image (when available)

You can remove an external link the same way you remove any relation. See the permissions section below for who can delete relations.

Changing or Removing a Relation

  1. Hover over the relation card you want to change
  2. Click the “Relation actions” button (three dots icon) on the right side of the card
  3. Choose from the menu:
    • Relation Type — use the dropdown to switch the type to Related, Depends, Blocker, or Child
    • Delete Relation — remove the relation entirely

Permissions

ActionWho can do it
View relationsAnyone with read access to the document
Create a relationMembers, Editors, and Admins (write access to the source document)
Change relation typeMembers, Editors, and Admins (write access to the source document)
Delete a relationMembers, Editors, and Admins (write access to the source document), or the person who created the relation

Viewers can see relations but cannot create, edit, or delete them.

Note: Relations can only be created between documents in the same workspace. You cannot create relations across different workspaces.

Empty States

When a document has no outgoing relations, you see the message “No relations yet” with the prompt “Connect with other documents”. When there are no incoming links, the Back Relations tab shows “No incoming relations” with “No documents linking here”.

Best Practices

  • Use Depends to signal that work on one item cannot start until another is complete
  • Use Blocker to flag urgent dependencies that are preventing progress
  • Use Related for general cross-references, context, or organizational grouping
  • Link related tasks across projects to maintain visibility of cross-team dependencies
  • Add external links for reference materials, design files, or documentation that supports a task
  • Review Back Relations to discover which documents depend on the one you are editing