Documentation

Jump Markers

Version 3.3.1 · updated November 18, 2026

Video tutorial

Playing the video loads it from YouTube and transfers data to YouTube. Privacy policy

Overview

With Jump Markers you link straight to a section of the same page: a click on “Knitwear” scrolls smoothly to the knitwear section instead of reloading the page. The plugin comes with two Shopping Experience blocks for this:

  • Jump Marker / Page-Internal Reference: the invisible target you place at the start of a section.
  • Jump Marker Navigation: a table of contents built from all jump markers (or headings) on the page, in five styles, optionally scrolling along and with reading progress.

Without a navigation block, the plugin can automatically create a dot navigation at the edge of the page. It takes a scrolling (sticky) header into account on its own: after the jump, the section always lands visibly below the header.

Horizontal jump marker navigation with reading progress
After a click on “Knitwear”: 1 active item, 2 reading progress, 3 “Back to top” link

Setup

  1. Install and activate the plugin under Extensions › My extensions.
  2. Under Content › Shopping Experiences, open the layout where you want to use jump markers.
  3. In the right sidebar, switch to Blocks and choose the category 1 FlinkFactory CMS blocks. There you’ll find 2 Jump Marker / Page-Internal Reference and 3 Jump Marker Navigation.
Block selection in the Shopping Experience editor
1 “FlinkFactory CMS blocks” category, 2 Jump Marker block, 3 Jump Marker Navigation block

In Shopware, new blocks can only be added in the system’s default language. If the editor is set to a different content language, the block list is grayed out.

  1. Drag a jump marker directly above each section you want to jump to, and give it a title (see below).
  2. Optionally, drag a Jump Marker Navigation to the top of the page. It lists all jump markers automatically.
  3. Save, done.

Setting jump markers

Click the jump marker’s gear icon in the editor to edit it.

Settings of a jump marker
1 Title, 2 ID, 3 regenerate ID from title, 4 generate ID automatically, 5 custom title for the navigation
  • Jump marker title 1: appears in the navigation and is the basis for the automatic ID.
  • Jump marker ID 2: the part after the # in links, e.g. knitwear. Lowercase letters, numbers, hyphens and underscores are allowed. The ID must be unique on the page.
  • Generate anchor ID automatically 4: the ID is created from the title and stays stable afterwards, even if you change the title later. That way existing links keep working. If you still want to update it, click Regenerate ID from title 3.
  • Show in jump marker navigation: switch it off to hide the jump marker from all navigations. It stays linkable anyway.
  • Custom navigation label 5: a shorter text just for the navigation, e.g. “Care” instead of “How to care for wool properly”.

If you use an ID twice, the editor warns you right away:

Warning for a duplicate ID
1 an ID that's already in use, 2 the warning about it

Linking to a jump marker

As the link target, enter # and the ID, e.g. #knitwear. This works in any link: in the text element, in buttons, in image links and in the menu. From other pages, link with the full address plus ID, e.g. https://your-shop.com/fall-guide/#knitwear. Even then, the visitor lands at the right section below the sticky header.

Jump Marker Navigation

The Jump Marker Navigation block creates a table of contents. In the editor, it shows a preview of the current items.

Settings of the jump marker navigation
1 Style, 2 item source, 3 scroll along, 4 reading progress

Navigation style 1:

StyleDisplay
Dot navigationDots, title on hover
Dots with titleDots with permanently visible title
HorizontalBar with items side by side. Arrows appear as soon as not all items fit; the bar can be dragged with the mouse and centers the active item. On mobile devices it turns into a select list.
ListClassic table of contents
Numbered listTable of contents with numbers
Numbered list with title and back-to-top link
“Numbered list” style: 1 text above the navigation, 2 items, 3 “Back to top” link

More options:

  • Item source 2: the page’s Jump marker elements or Page headings. With headings, choose H2 only or H2 and H3 under Included headings. You don’t need any jump marker blocks for this.
  • Navigation scrolls with the viewport 3: the navigation stays visible below the header as long as its section is in view.
  • Show reading progress 4: a bar below the horizontal navigation that shows the progress on the page.
  • Show “back to top” link: adds a link back to the top of the page.
  • Dot color: overrides the global dot color for this navigation (dot styles only). The colors come from your theme configuration.
  • Text above the navigation (e.g. a title): e.g. “Contents” or “On this page”.

For long guides or legal texts, you don’t have to set a single jump marker: set the source to Page headings. The plugin creates the anchors from the H2 (and optionally H3) headings of the text elements.

Navigation from the headings with copy-link button
1 List built from the headings, 2 heading as jump target, 3 copy-link button on hover

Mobile

On smartphones, the horizontal navigation turns into a select list that saves space and is easy to use with your thumb.

Jump marker navigation on a smartphone
1 Select list instead of a horizontal bar

Dot navigation at the edge of the page

If you don’t want to place a navigation block, switch on Generate a dot navigation from jump markers in the plugin configuration. As soon as a page contains at least two jump markers, a floating dot navigation appears at the edge of the page. If the page contains a visible jump marker navigation, the plugin hides the dots automatically so nothing appears twice.

Floating dot navigation with titles
1 Dot navigation with all titles, 2 active section

Settings

Found under Extensions › My extensions › Jump Markers › ⋯ › Configure. As usual, you can pick a sales channel at the top and configure each channel differently.

Plugin configuration, Dot navigation: General card
1 Generate dot navigation, 2 show all titles, 3 color of the active dot, 4 hide in modals

Dot navigation: General

SettingEffectDefault
Generate a dot navigation from jump markersFloating dot navigation from two jump markers per page. The navigation block works independently of this.off
Always show the title of the active dotShows the section title next to the active dot.off
Always show the titles of all dotsAll titles permanently visible.off
Color of the dotsColor from the theme (Primary, Secondary, Border, Background, Success, Information, Warning, Danger, Text color, Headline color, Price, Buy button …).Text color
Color of the active dotColor of the active dot, same choices.Text color
Hide dot navigation in modals/dialogsHides the dots while a dialog is open.off

Dot navigation: Mobile

SettingEffectDefault
Hide dot navigation on mobile devicesNo dots on smartphones.off
Always show the title of the active dot on mobile devicesTitle of the active section on mobile too.off
Position of the dot navigation on mobile devicesTop, Middle or Bottom, each Left or RightBottom left
Size of the dots on mobile devicesSmaller, Normal, Larger (mobile only).Normal

Jump markers

SettingEffect
Show a copy-link button next to visible jump markersOn hover, a small button appears next to visible jump targets (heading anchors and your own anchors) that copies the direct link to the section.
CSS selector(s) for additional sticky header elementsOnly needed if jump targets disappear behind your theme’s sticky header. The plugin detects fixed elements in the standard header by itself. Separate multiple selectors with commas.

Tips & hidden features

  • Table of contents without jump markers: The Page headings source turns every long text element into a linked table of contents – ideal for FAQ, guide or terms and conditions pages.
  • Share deep links: With the copy-link button, visitors (and your support team) copy the link straight to a section in one click.
  • Hide a jump marker, keep the link: Switch off Show in jump marker navigation if an anchor is only meant for a button or newsletter link and shouldn’t appear in the table of contents.
  • Short navigation titles: Use Custom navigation label so the horizontal bar doesn’t overflow while the heading in the content stays descriptive.
  • Stable IDs: Automatically generated IDs don’t change when you edit the title later. Links in newsletters or ads stay valid.
  • Direct visits with #id: The header offset is also taken into account when a URL with #id is opened (e.g. from Google or a newsletter).

Frequently asked questions

After the jump, the header covers the start of the section.

The plugin measures the sticky header’s height automatically, including fixed elements inside it. If your theme uses additional fixed bars outside the standard header, enter their CSS selector under CSS selector(s) for additional sticky header elements, e.g. .my-sticky-bar.

I used to set an “offset from the top edge”. What happens to it?

The value is ignored because the offset is calculated automatically. The editor shows a corresponding note on old jump markers.

The dot navigation doesn’t appear.

Check three things: Generate a dot navigation from jump markers is active, the page contains at least two jump markers, and there’s no visible jump marker navigation block on the page (in that case the dot navigation is hidden on purpose). On smartphones, also check Hide dot navigation on mobile devices.

The ID in the link has to match the jump marker’s ID exactly, without spaces and in lowercase. In the editor you’ll find the ID in the Jump marker ID field.

Does the navigation also work with Grid Builder Pro or other blocks?

Yes. Jump markers and the navigation are regular Shopping Experience blocks and can be combined with all other blocks. The headings source reads H2/H3 from text elements.

Is the jump marker visible in the shop?

No, the jump marker itself is invisible. Only the navigations are visible and, if enabled, the copy-link button on hover.