Benjamin Olsen
All topics

Guide

Breakdance Back To Top: A return link on a long documentation page

A return link on a long documentation page. Learn when to use Back To Top, follow a practical setup, and diagnose common problems.

2 min read · Updated 30 September 2026

Practice recipe based on public documentation; the Breakdance extension is not installed here.

What it does and when to use it

Provides a control for returning to the top of a page. Use it for the specific job described below. If a simpler native element can deliver the same outcome, prefer the simpler structure and fewer competing styles.

Before you start

This is a Breakdance catalogue recipe for use with a compatible Breakdance Elements for Oxygen extension. It is not a guarantee of availability in your version. Check the installed element list and official reference before following the steps. Exact control labels can differ; this recipe has not been executed on this site.

Worked example: A return link on a long documentation page

Scenario: A return link on a long documentation page. The goal is a useful result on a real project, not a claim that this scenario was a completed client project.

  1. Give the control a clear Back to top label.
  2. Position it without covering reading content or mobile controls.
  3. Activate it from the bottom of the page and verify the resulting focus and scroll position.

Expected result

You should have a return link on a long documentation page. Verify the result on the frontend using the same content or object described in the steps. A correct builder preview alone does not establish that links, data or interactions work for visitors.

Troubleshooting

If the scroll reaches the top but keyboard focus stays in a confusing place, test the element's focus behavior. Keep a conventional navigation path available as well.

Checks before publishing

Use real text and assets rather than a perfect placeholder. Check a long label, narrow screen and empty-data state before publishing.

  • Compare desktop and narrow-screen layouts using actual content.
  • Follow every destination and operate interactive controls with a keyboard where applicable.
  • Check an empty or unavailable-data state when the element depends on a provider.

Official reference and version notes

Official Back To Top reference provides the current provider information. This is independent, AI-assisted documentation on Benjamin Olsen’s website; examples are clearly identified as practice recipes.

Check extension element visibility in Oxygen. An element may be hidden where a native equivalent exists.

Explore more topics