Troubleshooting
GeneratePress Smooth Scroll Not Working: Causes and How to Fix It

Short answer
GeneratePress smooth scroll needs GP Premium active, the smooth scroll option ticked in the Customizer General panel, and the smooth-scroll class on each link. If those are set, check that the target ID matches the link exactly, then turn off JavaScript delay or combine in your speed plugin and clear all caches.
Key takeaways
- Smooth scroll is a GP Premium feature, not part of the free theme.
- Only links with the smooth-scroll class get the smooth effect.
- The anchor link must match a unique ID on the target section.
- JavaScript delay and combine options often break it for visitors.
- Use scroll-margin-top when a sticky header hides the target.
- CSS scroll-behavior is a simple fallback that needs no script.
Why is GeneratePress smooth scroll not working?
GeneratePress smooth scroll usually fails because GP Premium is not active, the option is switched off, links lack the smooth-scroll class, the target ID is wrong, or a script optimization plugin breaks the JavaScript.
Smooth scroll is the gentle sliding motion when a visitor clicks a link that jumps to another part of the same page. Without it, the page snaps straight to the section.
In GeneratePress, smooth scrolling is a GP Premium feature. The free theme on its own does not add it, so the first check is always whether the premium plugin is installed and active.
The official GeneratePress smooth scroll documentation explains how the feature is meant to work. The sections below walk through each cause in the order most likely to fix it.
Is GP Premium installed and the smooth scroll option turned on?
Smooth scroll only works when GP Premium is active and the smooth scroll option is ticked in the Customizer, so confirm both before anything else.
Check these steps:
- Go to Plugins and confirm GP Premium is active, not only installed.
- Go to Appearance > Customize.
- Open the General panel.
- Tick the smooth scroll option and click Publish.
If you do not see the option, GP Premium may be outdated or inactive. Our guide on how to install GeneratePress Premium covers activation and license setup.
Some GP Premium versions tie features to modules on the Appearance > GeneratePress screen. If a related module is switched off, its Customizer options disappear.
Do your links have the smooth-scroll class?
GeneratePress applies smooth scrolling to links that carry the smooth-scroll class, so a plain anchor link without it will still jump instantly.
This is the most common reason the feature seems broken. People switch on the option and expect every anchor link to glide, but only links with the class do.
How to add the class in different places:
- Menu items. Go to Appearance > Menus, open Screen Options at the top, and tick CSS Classes. Then type smooth-scroll in the CSS Classes field of each menu item.
- Block editor buttons and links. Select the button block, open the Advanced panel in the sidebar, and add smooth-scroll under Additional CSS class(es).
- HTML links. Add class=“smooth-scroll” directly to the a tag.
For a text link inside a paragraph, the block editor does not let you set a class on the link alone. Use a Button block, or switch the paragraph to HTML editing and add the class by hand.
If you use the block-based navigation in a full site editing setup, check the GeneratePress forum for your version's method, because menus work differently there.
Is the anchor link pointing at a real ID?
A smooth scroll link needs a matching ID on the target section, and a typo, a missing ID or a duplicate ID stops the scroll from finding its destination.
An anchor link looks like #pricing. The section it points to must have id=“pricing” exactly. Capital letters matter.
How to set IDs:
- Block editor. Select the target block, open Advanced, and type the name in the HTML anchor field without the hash sign.
- GenerateBlocks containers. Use the HTML anchor field in the block's advanced settings.
- Page builders. Elementor, Beaver Builder and others have their own ID or anchor fields.
WordPress explains HTML anchors in its page jumps documentation. Each ID must be unique on the page. If two blocks share the same ID, the browser goes to the first one.
To test, add the hash to the end of the page address in your browser, such as /about/#pricing. If the page does not jump at all, the ID is the problem, not smooth scroll.
Could a script optimization plugin be breaking smooth scroll?
Yes, deferring, delaying or combining JavaScript can stop the smooth scroll script from loading before a visitor clicks, so the browser falls back to an instant jump.
Speed plugins such as WP Rocket, LiteSpeed Cache, Autoptimize, Perfmatters and others often delay scripts until the user interacts. Smooth scroll needs its script ready on the first click.
How to check:
- Open the page in a private browser window while logged out.
- Open your browser's developer console and look for red JavaScript errors.
- Temporarily turn off JavaScript delay, defer and combine in your speed plugin.
- Clear all caches and test again.
If smooth scroll starts working, exclude the GP Premium smooth scroll script from delay or combine. Search the speed plugin's exclusion field for smooth-scroll or gp-premium. Our guide to WP Rocket delay JavaScript exclusions shows how exclusion lists work.
Cloudflare's Rocket Loader can cause the same problem because it changes how scripts load. Try turning it off in your Cloudflare dashboard as a test.
Is a sticky header hiding the section after the scroll?
Smooth scroll may work but land the section underneath a sticky or fixed header, which makes it look like it scrolled to the wrong place.
This is not a failure of the script. The page scrolls to the exact top of the section, and the sticky header then covers the first part of it.
The cleanest fix is the CSS property scroll-margin-top. Add it to the targets, using a value about the same as your header height:
- Target all anchored sections with a rule such as [id] { scroll-margin-top: 100px; }.
- Adjust the number until the heading sits just below the header.
MDN documents scroll-margin-top with examples. Add the rule in Appearance > Customize > Additional CSS.
GP Premium's sticky navigation also offers its own options. Check its settings for an offset value if your version includes one.
Does a plugin or theme conflict stop the scroll?
Another plugin can capture link clicks first, add its own smooth scroll, or throw a JavaScript error that stops later scripts from running.
Common sources of conflict:
- Page builders with their own scrolling. Elementor and others have their own anchor scrolling that may fight GP's.
- Other smooth scroll plugins. Two smooth scroll scripts on one page can cancel each other out.
- Slider and popup plugins. Some stop click events from passing through.
- Broken scripts. Any JavaScript error earlier on the page can stop the smooth scroll code from running.
Use a staging site or a troubleshooting plugin to disable other plugins one at a time. Our plugin conflict guide covers a safe way to do this on a live site.
Is the CSS scroll-behavior property interfering?
If your site also sets scroll-behavior to smooth in CSS, it can clash with GP's JavaScript scrolling and make the motion jerky or doubled.
Modern browsers support smooth scrolling through CSS alone. MDN's scroll-behavior reference explains how it works.
Pick one method, not both:
- Use GP Premium's option if you want control through the class and theme settings.
- Use CSS only with html { scroll-behavior: smooth; } if you want every anchor link to glide without adding classes.
The CSS method works for all anchor links, needs no JavaScript, and is not affected by script delay plugins. That makes it a good fallback when nothing else works.
Note that some visitors set their system to reduce motion. Respecting that setting with a prefers-reduced-motion media query is good practice.
Is caching serving an old version of the page?
Page, browser and CDN caches can keep serving the page from before you enabled smooth scroll or added the classes, so changes look like they failed.
After any change:
- Clear your caching plugin.
- Clear server cache if your host offers one.
- Purge your CDN.
- Hard refresh the browser or test in a private window.
Our guide on how to clear cache in WordPress lists where each common cache lives.
Which fix matches which symptom?
Match what you see to the likely cause so you can go straight to the right fix.
| Symptom | Likely cause | Fix |
|---|---|---|
| Page jumps instantly, no slide | Missing smooth-scroll class or option off | Add the class, tick the Customizer option |
| Nothing happens on click | Wrong or missing target ID | Set a matching HTML anchor |
| Works logged in, not logged out | Caching or script delay for visitors | Clear cache, exclude the script |
| Lands too low or under the header | Sticky header covering target | Add scroll-margin-top |
| Jerky or double motion | Two smooth scroll methods active | Keep one method only |
| Worked before an update | Cached files or script conflict | Clear caches, check console errors |
When should you contact GeneratePress support?
Contact GeneratePress support when the option is on, the class and ID are correct, caches are cleared and plugins are ruled out, but smooth scroll still fails.
GP Premium customers can use the GeneratePress support forum. Include a link to the page, the link you are clicking, the target ID, your GP Premium version, and any console errors.
Support staff usually reply with a specific fix or CSS snippet. Before posting, update both the theme and GP Premium, since older versions handled smooth scroll differently.
Frequently asked questions
Does the free GeneratePress theme include smooth scroll?
No. Smooth scrolling is added by the GP Premium plugin. Without it, you can still get smooth scrolling by adding the CSS rule scroll-behavior set to smooth on the html element in Additional CSS.
How do I add the smooth-scroll class to a menu item?
Go to Appearance, Menus, open Screen Options at the top and tick CSS Classes. A CSS Classes field then appears on each menu item. Type smooth-scroll into it for every anchor link and save the menu.
Why does smooth scroll work for me but not for visitors?
Logged-in users often bypass caching and script optimization. Visitors get the cached, optimized version where the script may be delayed. Exclude the smooth scroll script from delay and combine settings, then clear every cache layer.
Why does the page scroll past my section heading?
A sticky header is probably covering the top of the section. Add a scroll-margin-top value to the target elements roughly equal to your header height, so the browser stops a little earlier.
Can I make every anchor link scroll smoothly without classes?
Yes. Add html with scroll-behavior set to smooth in Additional CSS. Modern browsers then animate every same-page anchor jump. Turn off the GP Premium option if you do this, so two methods do not clash.
Sources
- Smooth Scroll GeneratePress Docs
- Page Jumps WordPress.org
- scroll-behavior MDN Web Docs
- scroll-margin-top MDN Web Docs
- GeneratePress Support GeneratePress
Is your product missing, or something out of date?
Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.
Thanks — we review requests within 3 business days.
Related guides
About the editors
Researched from the primary sources listed above and checked against our editorial rules before publishing.


