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