You are here: User Interface Elements - How to Use Each One > Inserting Bookmarks into Topics

Inserting Bookmarks into Topics

A bookmark is a marker, or flag, that lets you create hyperlinks to specific locations within topics (rather than to another topic file in general). You can insert a bookmark at a specific location in your topic (e.g., at a subheading) and then insert a hyperlink that "connects" to that bookmark. This is a useful feature, for example, if you have a somewhat lengthy topic and want the user to be able to locate a specific place in the topic quickly.

How to insert a bookmark into a topic

Open the topic where you want to insert the bookmark.
Click in the topic where you want to insert a bookmark (e.g., in front of a subheading or a specific paragraph).
Do one of the following:
- Select Insert>Bookmark.
  OR
- Press SHIFT+CTRL+K on your keyboard.

The Manage Bookmarks dialog opens.

In the New bookmark field, type a name for your bookmark (do note use spaces).

example

If the bookmark is being placed at the beginning of a bulleted list of product features, you might type ProductFeatures as the bookmark name.
Click Add.

A bookmark icon and the name of the bookmark are displayed at the appropriate location in the topic (as long as your markers are turned on). (You can hide the bookmark name if you want.)
Press CTRL+S or click to save your work.
Now you can insert a cross-reference or hyperlink elsewhere in this topic or in another topic that links to this bookmark.

Note: You can also move an existing bookmark to a new location in the topic. To do this, place your cursor in the topic where you want the bookmark to be moved. Select Insert>Bookmark. In the Manage Bookmarks dialog, select the existing bookmark that you want to move (instead of typing the name of a new bookmark). Then click Move.