> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pensiv.so/llms.txt
> Use this file to discover all available pages before exploring further.

# 10.2.5 Track connections with backlinks

> Linking files with @, automatic backlinks, where to see them, when to use

In Pensiv, files can link to each other.

Documents, sheets, plot cards—any file can reference another.

Backlinks show **where this file is referenced**.

***

## 1. Link files with @

When you type `@` in the body, a list of linkable files appears.

![@ file link](https://prod-files-secure.s3.us-west-2.amazonaws.com/24100a87-f568-4119-8737-ecdd32e8de5c/fa599ecd-b2cd-4351-aa72-1e7f89ca6e87/image.png?X-Amz-Algorithm=AWS4-HMAC-SHA256\&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD\&X-Amz-Credential=ASIAZI2LB4664MOM62KT%2F20260228%2Fus-west-2%2Fs3%2Faws4_request\&X-Amz-Date=20260228T215647Z\&X-Amz-Expires=3600\&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEJX%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaCXVzLXdlc3QtMiJGMEQCIGI%2BzbnA91hRUE4uUQ%2Buxl5eeo0q5wz9PbDfYnejliMuAiAkl4KqKN52sEVBmBSwiPBlts4aY1P4DV2uq1zGLj1oeir%2FAwheEAAaDDYzNzQyMzE4MzgwNSIMMA2QLfSQayXQ68h8KtwD9iPlHOTqxK0V4jkmAvqBhP6nIh4gXI91bd2f4gWvNux%2FbhaQW%2FRg4uPJy09cHKWHL%2FeRkCLnWWopEcN92fM8%2F5FhbKpBlhewxpBrtpyoFCdNsxpzLvbFAya9ihwnyki%2FPswq%2BiefnwUiqwpJqWl4JQ1bdQ%2BrgU2UG%2B9sWElBOxnnNW97d9pNFVVIdkWUt20UgOCgWKD5GmQli%2BALKnwgNUkjJbvgDJCQBgiViXR1DJdtHmSCdGJdItv6bPYLqXdmu7Su%2Fgh00iLuu9U6IXZAsl9s64m9vtHgao7Mj1APVZn%2BXAeAcXDKrjpxYugMtkjDhDIMdhdaSgwfINUZJSGBgji9%2F8pEyXur8DED3B7uqfKB%2BWQEFALmKCLOvFvwj%2FCDZ58TZNWZpD5%2FiO8KC9JD5SDb%2FsaTooFKGp4v8ZGAeSQ3lb9yL8pQcvVR4BBdB5MWYIQQJADGhX103ICq1zWoF0cCOBNc0ri1M%2FXTDEthEV3SiJaRjVdebxno0RA44zIHy2N9SxokMAg2um1QTaoGygSJ4WQVAxRjvDWxnlGHEGwyNovGRTV8a34L3V4OtThjiA1sbwVASMYdB2mS%2ByF%2F%2BOVCiOq0gAiDu2n5YpxgJmvTf8Mcvj5JYX3ouv4w0KuNzQY6pgGG0AUDrdap2Rq2e4fc%2FDj5%2BDYnRtuKfIWNMdXnSFGBZKBDoLFHkE%2B7saUyJt4ZUD6sqKtVQxEmbtAVVzYtSxb4iESLFsy%2Fx3hbxAmMEBRd%2FGV52xKYnUelVme8l1mszWAqWAT%2FDDIcAu8siSm3NvUmbn82ForQ8ASgVWNU8TJI%2FE5iDoD5P%2BdZGnuRFd%2BKZRXJCHMvap%2B4dSSQap1El6BJCEaw8KtQ\&X-Amz-Signature=4518b0ece4998ed7b083256baac22bffe998b559704e786ed9372f7e92a06e7b\&X-Amz-SignedHeaders=host\&x-amz-checksum-mode=ENABLED\&x-id=GetObject)

Choose a file from the list to insert a link at the cursor.

Examples:

* Link a character sheet in a document with `@CharacterName`
* Link a document from a plot card

That’s **creating a link**.

***

## 2. Backlinks are recorded automatically

When one file references another, the referenced file gets a backlink automatically.

![Backlinks recorded automatically](https://prod-files-secure.s3.us-west-2.amazonaws.com/24100a87-f568-4119-8737-ecdd32e8de5c/6d01602d-8df3-4f96-9dc1-428cef964565/image.png?X-Amz-Algorithm=AWS4-HMAC-SHA256\&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD\&X-Amz-Credential=ASIAZI2LB4664MOM62KT%2F20260228%2Fus-west-2%2Fs3%2Faws4_request\&X-Amz-Date=20260228T215647Z\&X-Amz-Expires=3600\&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEJX%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaCXVzLXdlc3QtMiJGMEQCIGI%2BzbnA91hRUE4uUQ%2Buxl5eeo0q5wz9PbDfYnejliMuAiAkl4KqKN52sEVBmBSwiPBlts4aY1P4DV2uq1zGLj1oeir%2FAwheEAAaDDYzNzQyMzE4MzgwNSIMMA2QLfSQayXQ68h8KtwD9iPlHOTqxK0V4jkmAvqBhP6nIh4gXI91bd2f4gWvNux%2FbhaQW%2FRg4uPJy09cHKWHL%2FeRkCLnWWopEcN92fM8%2F5FhbKpBlhewxpBrtpyoFCdNsxpzLvbFAya9ihwnyki%2FPswq%2BiefnwUiqwpJqWl4JQ1bdQ%2BrgU2UG%2B9sWElBOxnnNW97d9pNFVVIdkWUt20UgOCgWKD5GmQli%2BALKnwgNUkjJbvgDJCQBgiViXR1DJdtHmSCdGJdItv6bPYLqXdmu7Su%2Fgh00iLuu9U6IXZAsl9s64m9vtHgao7Mj1APVZn%2BXAeAcXDKrjpxYugMtkjDhDIMdhdaSgwfINUZJSGBgji9%2F8pEyXur8DED3B7uqfKB%2BWQEFALmKCLOvFvwj%2FCDZ58TZNWZpD5%2FiO8KC9JD5SDb%2FsaTooFKGp4v8ZGAeSQ3lb9yL8pQcvVR4BBdB5MWYIQQJADGhX103ICq1zWoF0cCOBNc0ri1M%2FXTDEthEV3SiJaRjVdebxno0RA44zIHy2N9SxokMAg2um1QTaoGygSJ4WQVAxRjvDWxnlGHEGwyNovGRTV8a34L3V4OtThjiA1sbwVASMYdB2mS%2ByF%2F%2BOVCiOq0gAiDu2n5YpxgJmvTf8Mcvj5JYX3ouv4w0KuNzQY6pgGG0AUDrdap2Rq2e4fc%2FDj5%2BDYnRtuKfIWNMdXnSFGBZKBDoLFHkE%2B7saUyJt4ZUD6sqKtVQxEmbtAVVzYtSxb4iESLFsy%2Fx3hbxAmMEBRd%2FGV52xKYnUelVme8l1mszWAqWAT%2FDDIcAu8siSm3NvUmbn82ForQ8ASgVWNU8TJI%2FE5iDoD5P%2BdZGnuRFd%2BKZRXJCHMvap%2B4dSSQap1El6BJCEaw8KtQ\&X-Amz-Signature=f4d179ed39148adb8ddd6cc2ab4977d55bceca5fe91ffd8080a937cba8d2e2d0\&X-Amz-SignedHeaders=host\&x-amz-checksum-mode=ENABLED\&x-id=GetObject)

So:

* If you link file B from document A,
* File B automatically gets “referenced from document A.”

You don’t manage backlinks manually; they’re created when you create the link.

***

## 3. Where to see backlinks

When you open a file, the **backlink icon** is in the header.

Click it to see:

* A list of files that reference this file.

Click an item to jump to that file.

***

## 4. When to use backlinks

### Check if a file is actually used

If there are no backlinks, the file may not be part of the structure yet.

***

### Find where something appears

Example:

* Open a character sheet
* Check backlinks
* Jump to the scene document

One click to see the context.

***

### Check that structure is connected

You can confirm that the links plot → document → sheet really exist.

If a link is missing, that part of the structure may be isolated.

***

## 5. Backlinks vs. Graph

| Feature  | Role                        |
| -------- | --------------------------- |
| Link     | Create a single connection  |
| Backlink | Track references per file   |
| Graph    | Visualize all relationships |

Backlinks are for **tracking relationships at the file level**.

The graph is for seeing the whole project.

***

## Summary

* Use `@` to link files.
* Backlinks are created automatically when you link.
* Use the backlink icon in the header to see referencing files.
* Click to jump to that file.

Backlinks show whether a file is actually used in the structure.

Creating connections matters more than creating files.

Backlinks are how you track those connections.