Pins and bookmarks

Pins and bookmarks keep a list of nodes you return to often, such as the settings you change in a configuration file or the record you are investigating in a log. Each list belongs to its file: it comes back when you open the file again, even after a restart.

The two work the same way. Pins are quicker to add, from a button on each tree row; bookmarks also record the node’s type and value at the time you bookmark it.

Pin a node

Hover over a row in the tree and select the pin button on its right, or right-click the node and choose Pin/Unpin Node.

Select Pins on the activity rail to open the Pins panel. Each pin shows its name and path:

Click a pin to go to its node.
Select Unpin on a pin to remove it, or Clear all to remove every pin of the file.

Bookmark a node

Right-click a node in the tree and choose Bookmark/Unbookmark Node. In other views, select the node and run the same command from the command palette (Ctrl+K).

Select Bookmarks on the activity rail to open the Bookmarks panel. Each bookmark shows the node’s type, its name, its path, and its value when you bookmarked it. Click a bookmark to go to its node; select Remove bookmark to remove it, or Clear all to remove every bookmark of the file.

A file can have up to 50 pins and 50 bookmarks. When you add one more, the oldest is removed. See Limits.

Pins and bookmarks after edits

Pins and bookmarks follow their node when you edit the file:

Renaming a key updates the pins and bookmarks on it and inside it.
Inserting or deleting an array element updates the positions of the elements after it.
Deleting a node removes its pins and bookmarks. Undo brings them back.

When a pinned or bookmarked path no longer exists, for example after another program changed the file, clicking it shows a notice.