JetBrains Rider 2021.3 Help

Bookmarks

If you want to return to some place in your code later, you can bookmark code lines in your solution and in library code.

Line bookmarks are shown in the gutter and in addition to that, all bookmarks in the current solution are available in the Bookmarks tool window (View | Tool Windows | Bookmarks Alt+2) where they can be grouped in lists. The tool window also shows all breakpoints , which are added automatically to the dedicated list.

JetBrains Rider: Bookmarks tool window

Toggle bookmarks

There are two types of bookmarks that you can add:

  • Mnemonic bookmarks are identified by a mnemonic — a digit (0 to 9) JetBrains Rider: Mnemonic bookmark with a digit or a letter (A to Z) JetBrains Rider: Mnemonic bookmark with a letter and their total number in your solution is limited to available digits and letters. Bookmarks with digits have dedicated shortcuts: press Ctrl+Shift+[digit] to toggle a bookmark with that digit and Ctrl+[digit] to jump to it.

  • Anonymous bookmarks JetBrains Rider: Anonymous bookmark don't have any unique identifiers and allow you to place as many bookmarks as you want; you can quickly add and remove them by pressing F11

Add an anonymous bookmark

  1. To bookmark a code line, place the caret at that line in the editor.

  2. Press F11.

  3. Alternatively, right-click the gutter next to the code line select Add Bookmark.

  4. If there are multiple bookmark lists, and none of them is set as default, you will have to choose the list to add the new bookmark to, otherwise the bookmark is added immediately to the default list.

An orange bookmark icon is added in the gutter next to the bookmarked line.

Add a mnemonic bookmark

  1. To bookmark a code line, place the caret at that line in the editor.

  2. To add a bookmark with a digit, press Ctrl+Shift+[digit].

  3. To add a bookmark with a digit or letter using a popup, press Ctrl+F11, or alternatively, right-click the gutter next to the code line select Add Mnemonic Bookmark.

    When the popup opens, press the desired digit or letter key on the keyboard, or click the desired mnemonic with the mouse.

    JetBrains Rider: Adding a mnemonic bookmark, selecting an identifier
  4. If the selected mnemonic is already used, the IDE will ask you whether to overwrite an existing bookmark with the new one. Select Don't ask again to silently overwrite mnemonics.

  5. If there are multiple bookmark lists, and none of them is set as default, you will have to choose the list to add the new bookmark to, otherwise the bookmark is added immediately to the default list.

A letter or a digit bookmark icon is added in the gutter next to the bookmarked line .

Add a mnemonic to an anonymous bookmark

  1. Place the caret at a bookmarked line of code and press Ctrl+Shift+[digit] to add a bookmark with a digit or Ctrl+F11 to use the popup.

  2. Alternatively, right-click an anonymous bookmark and select Assign Mnemonic.

  3. When the popup opens, press the desired digit or letter key on the keyboard, or click the desired mnemonic with the mouse.

Remove bookmarks

  • To remove any bookmark, set the caret to the corresponding line and press F11.

    Alternatively, right-click a bookmark icon on the gutter and select Delete Bookmark.

  • To remove a mnemonic bookmark with a digit, set the caret to the corresponding line and press Ctrl+Shift+[digit].

  • You can also remove bookmarks using the Bookmarks window — select a bookmark and press Delete or right-click it and choose Delete Bookmark.

Jump to mnemonic bookmark with a digit

  • Mnemonic bookmarks with digits are quickest to navigate to — just press Ctrl+[digit].

Jump to any mnemonic bookmark

  1. Press Ctrl+Shift+F11 or select Edit | Bookmarks | Go to Mnemonic... from the main menu.

  2. In the popup that opens, press a digit or a letter key corresponding to a specific bookmark or alternatively, double-click it or select it with the keyboard and press Enter.

    JetBrains Rider: Go to mnemonic bookmark
  1. Press Shift+F11 (Edit | Bookmarks | Show Line Bookmarks...).

    JetBrains Rider: Line bookmarks in the Bookmarks popup
  2. Double-click the desired bookmark or select it with the keyboard and press Enter For mnemonic bookmarks in this list, you can press a digit or a letter key corresponding to a specific bookmark .

  1. Choose View | Tool Windows | Bookmarks from the main menu or press Alt+2 to open the Bookmarks tool window.

  2. To locate a bookmark in the window, start typing the name of the file or contents of the line where it is located.

    JetBrains Rider: Speed search in the Bookmarks window
  3. Select the desired bookmark and press F4 or double-click it to locate the marked code lines in the editor .

Go to next/previous bookmark

  • To go to next/previous bookmark in the entire solution, in the order they appear in the Bookmarks tool window, press F2/Shift+F2.

Navigate with error stripe

  • All bookmarks in the current file have dedicated markers on the error stripe. You can hover the mouse over these markers to see the bookmarks outside the editor viewport and click the marks to jump to the corresponding lines.

    JetBrains Rider: Bookmark on the error stripe

Manage bookmarks

All bookmarks management actions are available in the Bookmarks tool window Alt+2 and some of them are also available by right-clicking the corresponding bookmark icons on the gutter .

Rename bookmarks

In the Bookmarks tool window, bookmarks have short descriptions. By default, they contain the code from the line or the name of the item on which they are placed. If necessary, you can give bookmarks your own short descriptions.

  1. Choose View | Tool Windows | Bookmarks from the main menu or press Alt+2 to open the Bookmarks tool window.

  2. Select a bookmark and click Rename Bookmark on the toolbar.

  3. In the dialog that opens, specify a new description and click OK.

You can also rename a bookmark from the gutter: click the bookmark icon and provide a new description. To rename a bookmark from the Project tool window, right-click it and select Bookmarks | Rename Bookmark.

In a project, there's one predefined empty bookmarks list that has the same name as the project. By default, JetBrains Rider adds your bookmarks there. If necessary, you can use another list as the default. You can also create multiple lists and move items between them.

Create a bookmarks list

  1. Choose View | Tool Windows | Bookmarks from the main menu or press Alt+2 to open the Bookmarks tool window.

  2. In the tool window, click Create Bookmarks List and name the new list in the dialog that opens.

  3. Enable the Use as default list option if you want your bookmarks to go to this list automatically and click Create.

Move a bookmark to another list

  • In the Bookmarks tool window, drag a bookmark to another list.

Sort and group bookmarks

  • To move a bookmark up or down the list, right-click it in the Bookmarks tool window and select Move Up or Move Down.

  • To display line bookmarks in the tool window grouped by containing files, click Show Options Menu in the Bookmarks tool window and select the Group Line Bookmarks by File option.

Change the default list

JetBrains Rider adds all your bookmarks to the list that is configured as the default one. If necessary, you can use another default list for your bookmarks.

  1. From the main menu, select View | Tool Windows | Bookmarks or press Alt+2 to open the Bookmarks tool window.

  2. Right-click the list that you want to use as your default bookmarks list and select Mark List as Default.

    The list is now located above others in the tool window and has the Default tag.

Delete a list of bookmarks

After you delete a list, all bookmarks from it are removed from code and project items.

  1. From the main menu, select View | Tool Windows | Bookmarks or press Alt+2 to open the Bookmarks tool window.

  2. Right-click the list that you want to delete and select Delete Bookmarks List.

Last modified: 07 April 2022