Back To Top

Add a nestable scroll-to-top control that becomes visible after the visitor has scrolled down. Its children define the visible button or icon, while the element manages the scroll behavior.

Setup and First Use


Before starting, enable the relevant element or feature family under Bricks → BricksUltimate → General Elements, save, and reopen the Bricks editor. Integrations also require their corresponding plugin to be active.

  1. Enable Back To Top and add (BU)Back to top once to a site-wide template or page.
  2. Keep or customize its nested visual control. Use a recognizable upward icon with an accessible label.
  3. Set Scroll offset(in px) to the distance at which the control should become visible.
  4. Set Transition duration(in sec) for the return scroll.
  5. Position the element using Bricks layout controls and leave enough space from viewport edges and sticky controls.
  6. Use Hide in builder editor? only for editing convenience, then test by scrolling a long frontend page.

Controls and Settings


ControlPurpose and usage
Scroll offset(in px)Visibility threshold. Default: 350. It is not the final scroll destination.
Transition duration(in sec)Controls the scroll animation duration; default: 0.5 seconds.
Hide in builder editor?Hides the control while designing without defining the frontend visibility threshold.
HTML tag / Nested contentChoose an appropriate wrapper and customize the child icon/button rather than deleting the visual children.

Site-wide Placement


Use one instance in a shared footer or other site template to avoid duplicate floating controls. Check cookie banners, chat widgets, bottom navigation, and safe spacing on mobile so the button does not block another action.

Behavior and Accessibility


This control returns to the page top; it is not an anchor navigator or a reading-position bookmark. Test keyboard activation and focus visibility. A short page may never cross the configured offset, which is normal and not evidence of a missing script.

Practical Example


Use a small upward arrow at the bottom-right of a long article, appearing after 350 pixels of scrolling. Give it the accessible name Back to top and a contrasting hover state.

Troubleshooting


  • Always hidden: test a sufficiently long page and verify the offset and frontend script.
  • Visible twice: check for duplicate instances in both the page and site template.
  • Click does nothing: inspect overlay interception, missing child markup, or script errors.

Related Documentation