Skip to main content

Introduction to Bookmark and Link Tags

Bookmark and Link Tags work together to create clickable navigation links within your generated output. A Link Tag defines where the clickable link appears, and a Bookmark Tag marks the destination that the link jumps to.

These tags also support external URLs — a Link Tag can point to a website rather than an internal bookmark, pulling the URL dynamically from your data source.

How Do They Work Together?​

Think of it like a table of contents: you click a link at the top of a document and it takes you to the relevant section. Bookmark and Link Tags let you build this kind of navigation dynamically in your generated reports.

There are three tags involved:

  • Link Tag — Marks the beginning of a clickable link. Its query specifies where the link points to (a bookmark name or a URL).
  • EndLink Tag — Marks the end of the clickable link. Any text between the Link and EndLink Tags becomes the clickable link text in your output.
  • Bookmark Tag — Marks a destination in the document. Its query specifies a name that Link Tags can reference.
note

Every Link Tag must have a corresponding EndLink Tag. The Bookmark Tag is only needed when linking to another location within the same document.

The Link Tag's type property controls what kind of link it creates:

Set the Link Tag type to bookmark to create a link that jumps to another location within the same document. The Link Tag's query must match the name defined in the Bookmark Tag's query.

Example use cases: Table of contents entries, "back to top" links, cross-references between sections in a long report.

Set the Link Tag type to link (the default) to create a link to an external URL. The Link Tag's query pulls the URL from your data source, so each row or iteration can link to a different website or resource.

Example use cases: Linking to product pages, customer portals, external documents, or any URL stored in your data.

  1. Insert a Link Tag — Place your cursor where you want the clickable link to appear. Use the Tags button on the Fluent Designer ribbon to insert a Link Tag.
  2. Set the type to bookmark — In the Tag Editor, set the type property to bookmark.
  3. Name the bookmark — In the Query Pane, enter a name for the bookmark destination (e.g., SectionTwo).
  4. Add link text — After the Link Tag, type the text you want to be clickable (e.g., "Jump to Section Two").
  5. Insert an EndLink Tag — Place an EndLink Tag immediately after the link text.
  6. Insert a Bookmark Tag — Navigate to the destination location in your template and insert a Bookmark Tag. In its Query Pane, enter the same name you used in step 3 (e.g., SectionTwo).
  7. Generate output — The link text is now clickable and jumps to the bookmark location.
  1. Insert a Link Tag — Place it where you want the clickable link. The type defaults to link, so no change is needed.
  2. Write a query — In the Tag Editor, write a select statement that returns the URL from your data source.
  3. Add link text — After the Link Tag, type the display text for the link.
  4. Insert an EndLink Tag — Place it immediately after the link text.
  5. Generate output — The text between the Link and EndLink Tags becomes a clickable hyperlink to the URL returned by your query.
tip

You can combine Link Tags with looping tags (like BeginRepeat or ForEach) to generate a list of clickable links dynamically — for example, a list of product names that each link to their own detail page.

Learn More​

For a complete breakdown of all properties and configuration options:

For step-by-step walkthroughs: