Scroll to top button
Appearance → Customize → Footer → Display the scroll to top button? Off by default.
A small round button appears in the bottom corner once the visitor has scrolled down about a screenful, and takes them back to the top.
Why it is off by default
A floating button over the corner of the page is an opt-in, not something a fresh install should grow on its own. It permanently occupies a piece of the viewport, and on a short site it is answering a question nobody asked.
A site that already had the button when it was on by default (version 1.4) keeps it — the old answer is written in on update. This only affects new sites.
When to turn it on
- Long posts. Anything that routinely runs past three or four screens.
- A non-sticky header. If you have turned Sticky header off, this is the way back to the navigation, and the two pair naturally.
- A grid listing with many posts per page, where the reader is deep in a wall of cards.
Leave it off on a site with a sticky header and short posts. The navigation is already there.
How it works
It is a real link to the top of the page, so:
- it works with JavaScript disabled,
- it is a normal keyboard target,
- a screen reader announces it properly.
The theme’s script only decides when it is on screen and swaps the jump for a smooth scroll — and it skips the smooth scroll for anyone who has asked their system for reduced motion.
Appearance
A circle with a chevron, drawn in the theme’s muted grey rather than full body colour, so it sits back from the page it floats over. Its border uses your border colour.
There is no size or position setting. If you want to move or restyle it, the
element is .scroll-top — see Custom CSS.