Blocksy troubleshooting
Blocksy Mobile Menu Not Working: Trace the Tap From Trigger to Panel
A customer taps the three lines in your Blocksy header. Nothing moves. They tap again, harder, as if the glass were at fault, then go back to the search results. On a Blocksy site that dead tap almost always lives in one of five places, and you can check every one of them before lunch.
October 14, 2026 · 10 min read
The short answer
A Blocksy mobile menu that will not open is usually a script optimizer delaying or combining the theme's main.js, a Trigger missing from the mobile header layout, an Offcanvas area with no Mobile Menu element, or no menu assigned to the Mobile Menu location. Blocksy switches to its mobile header below 1000 pixels, and no setting moves that line.
On this page
- Dead taps, empty drawers and a menu of every page
- What happens between the tap and the slide-in on Blocksy
- Five suspects on a Blocksy site, most likely first
- Repair the Blocksy hamburger without guessing
- The fixed 1000 and 690 pixel lines, and the iPad problem
- Keep the drawer opening after the next update
- A menu that keeps breaking is a stack talking
Dead taps, empty drawers and a menu of every page
Write down exactly what happens before you change a setting. Each failure below points at a different layer of Blocksy, and owners who skip this step tend to fix the wrong one. Test on a real phone, logged out, in a private window, because a logged-in administrator often bypasses the page cache and the optimizer that visitors get.
- The tap does nothing at all. The Trigger button is drawn but no script is listening to it. Start with the optimizer suspects below.
- It opens on the second or third tap. Scripts are being held back until the first interaction, so the first tap only wakes them up.
- The drawer slides in empty. The panel exists, but the Mobile Menu element is missing from it.
- The drawer lists every page on the site. No menu is assigned to Blocksy's Mobile Menu location, so the theme falls back to a list of all published pages.
- Phones work, tablets show no hamburger. The Trigger's visibility is switched off for tablet, or the tablet is wide enough to get the desktop header.
- A dark overlay appears with no menu on it. The panel opened, but the styles for its open state were stripped or never loaded.
What happens between the tap and the slide-in on Blocksy
Blocksy builds its header in Customizer > Header, with a device switch that flips the builder between the desktop layout and the mobile layout. The mobile layout has the usual Top Row, Main Row and Bottom Row, plus an Offcanvas area. The hamburger is the Trigger element, usually in the Main Row. Whatever you drop into the Offcanvas area, normally the Mobile Menu element, is what the drawer shows. The drawer's own options, such as Reveal as (Side Panel or Modal) and Reveal From left or right, live in the Offcanvas settings.
Two details from the theme's 2.1.58 source explain most failures. First, Blocksy only prints the off-canvas panel into the page when the header layout contains a Trigger; inside the Customizer preview it prints it anyway, which is why a menu can work while you design and vanish on the live site. Second, the Trigger is a plain button. The click handler comes from the theme's main.js, loaded in the footer, and the code that animates the panel arrives as small numbered files from the theme's static/bundle folder, fetched on demand using an address the page carries in an inline data script. Break any link in that chain and the button stays a picture of a button.
| Header shown | What to check first | |
|---|---|---|
| 1000 pixels and wider | Desktop layout, Header Menu 1 or 2 | Menu items that do not fit fold into Blocksy's automatic overflow dropdown |
| 690 to 999 pixels | Mobile layout, tablet visibility rules | Trigger and Mobile Menu visibility toggles for Tablet |
| Below 690 pixels | Mobile layout, mobile visibility rules | Trigger present, Offcanvas area filled, Mobile Menu location assigned |
Five suspects on a Blocksy site, most likely first
1. An optimizer is holding main.js hostage
Delay JavaScript until interaction, combine scripts, and move inline scripts to the footer are the three settings we switch off first. Delay produces the second-tap symptom. Combining can reorder the inline data script so main.js cannot find the address for its panel files. Check by opening the page with the optimizer's bypass parameter or with the plugin paused, then watch the browser console for an error about loading a chunk. CreativeThemes' own documentation warns that aggressive CSS or JavaScript processing can interfere with dynamic theme features, and our Blocksy speed guide covers which switches are worth keeping.
2. The Trigger or the Mobile Menu left the mobile layout
Open the header builder, switch to the mobile view and look. A Trigger deleted during a redesign means no panel is printed at all. A Mobile Menu element dragged out of the Offcanvas area gives you the empty drawer. Click the Trigger and check Element Visibility: if Tablet is off, every screen from 690 to 999 pixels gets a header with no way in.
3. The Mobile Menu location has no menu
Blocksy registers four menu locations: Header Menu 1, Header Menu 2, Mobile Menu and Footer Menu. The Mobile Menu element's Select Menu option defaults to that location. Leave the location empty and the theme lists every published page instead. Point Select Menu at a menu you later deleted and it quietly falls back to the location. Check under Appearance > Menus > Manage Locations.
4. A cache is serving yesterday's header
Header changes are HTML. If the page cache or a CDN kept the old markup, visitors get the old Trigger, or none, until it is purged. Compare the page source logged out with what you see logged in. If they differ, purge, and read Blocksy CSS not updating for the full cache order.
5. Somebody else's header is on the page
Pro's conditional headers can show a different header on the shop or the blog, and that header may have no Trigger. A page builder's theme template can replace Blocksy's header entirely. View source and search for ct-header-trigger. If it is not there, the menu you are debugging is not Blocksy's, and the generic mobile menu guide is the better map.
Repair the Blocksy hamburger without guessing
- 1
Reproduce it as a visitor
Use a real phone or a private window at 375 pixels wide, logged out. Note which of the six symptoms you see and on which templates.
- 2
Pause every optimizer
Turn off JavaScript delay, script combining and unused CSS removal, or pause the plugin, then purge its cache. If the menu works now, turn options back on one at a time and exclude the theme's main.js from delay.
- 3
Read the console
Reload with developer tools open. An error about a failed chunk, or a reference error naming ct_localizations, confirms that the theme's scripts are being moved or blocked. Our theme JavaScript errors guide explains how to read the rest.
- 4
Rebuild the mobile layout
In Customizer > Header, switch to mobile. Make sure a Trigger sits in a visible row, the Mobile Menu element sits in the Offcanvas area, and both are visible on Tablet and Mobile. Publish.
- 5
Assign the menu
Under Appearance > Menus > Manage Locations, give Mobile Menu a real menu, or set the element's Select Menu to a specific menu that exists.
- 6
Check conditional headers
If you run Pro, open each conditional header and repeat the mobile layout check. A shop header without a Trigger is a common leftover.
- 7
Purge caches and retest
Clear the page cache, the CDN and the optimizer's files, then test the tap on two phones and one tablet upright and sideways.
The fixed 1000 and 690 pixel lines, and the iPad problem
Blocksy's front-end CSS hard-codes its breakpoints. The mobile header takes over at 999.98 pixels and below, and the phone rules start at 689.98 pixels. We found no setting for either in the free theme or the vendor's documentation. The 2.1.56 changelog notes that the Customizer's responsive preview was changed to match the theme breakpoints, which tells you the numbers are part of the design rather than an option waiting to be found.
The practical result: an iPad held sideways at 1024 pixels gets the desktop header, not the hamburger. If your desktop menu is long, Blocksy folds the items that do not fit into an overflow dropdown, which is clever until a custom CSS rule confuses its measurements. Shorten the desktop menu, or test that dropdown on a tablet. Moving the breakpoint means custom CSS that overrides the theme's media queries, and that is fragile across updates. If your audience lives on tablets, the responsive layout guide explains the trade-offs.
Keep the drawer opening after the next update
Most Blocksy menu failures arrive with a change somebody made elsewhere: a new optimizer setting, a redesign of the header, an update to Companion without the theme. A short routine prevents nearly all of them.
- Exclude main.js from JavaScript delay permanently, and write the exclusion down where the next person will find it.
- Before redesigning the header, use Customizer > General Options > Manage Options to export your settings. It needs the Companion plugin.
- Update the theme, Companion and Pro together, on staging. A version mismatch switches Companion features off; Blocksy update broke my site explains the check.
- After every header change, tap the hamburger on a phone before you close the laptop.
- On stores, open the drawer on a product page too. Shop pages often run a different conditional header, and Blocksy WooCommerce layout problems tend to arrive at the same time.
If you would rather not own this checklist, our hosting and maintenance plans run updates on staging and test the menu, the cart and the forms before anything goes live.
A menu that keeps breaking is a stack talking
The Blocksy menu itself is well built. It keeps failing because four parties have opinions about it: the theme that draws it, the Companion plugin that holds half its features, the optimizer that rewrites its scripts, and the cache that remembers last week's header. Each one updates on its own schedule. A fix today is a truce, not a treaty.
The hamburger is the most tapped button on a phone, and on WordPress it has four landlords.
A Next.js site ships the menu as part of one tested build. There is no optimizer rewriting it after deploy and no plugin that can switch half of it off. That costs more up front and needs a developer for layout changes, so it is not the answer for every brochure site. The honest comparison is in Blocksy vs Next.js, the move is mapped in Blocksy to Next.js, and Athena CMS keeps the editing simple afterward. For how tap response is measured, see WordPress vs Next.js on INP.
Not ready for that conversation? Our theme troubleshooting service finds the failing layer on a copy of your site, and theme repair fixes it with a written record of every setting touched. More Blocksy and other theme fixes live in the troubleshooting section.
Questions people ask before they call
Something is delaying the theme's JavaScript until the first interaction. The first tap loads the scripts, so only the second one reaches a working button. Exclude Blocksy's main.js from the delay setting in your caching or optimization plugin, purge its cache, and retest on a real phone. The mobile speed guide covers which delays are safe.
No menu is assigned to the Mobile Menu location, so Blocksy falls back to listing all published pages. Go to Appearance > Menus > Manage Locations and assign a menu, or set the Mobile Menu element's Select Menu option to a specific menu. Purge the page cache afterward so visitors see the change.
Not with a setting. The theme's CSS fixes the mobile header at 999.98 pixels and below and the phone rules at 689.98 pixels. Custom CSS can override parts of that, but it must be rechecked after every update. Most sites are better served by shortening the desktop menu so it fits a tablet turned sideways.
The Customizer preview always prints the off-canvas panel and skips most caching and optimization. On the live site, the panel is only printed when the header contains a Trigger, and visitors get cached HTML and optimized scripts. Check the mobile layout for a Trigger, then test with your optimizer paused. Blocksy CSS not updating covers the cache side.
No. The Trigger, Offcanvas area and Mobile Menu element are all free. Pro adds extras such as a second mobile menu, conditional headers and mega menu features, and conditional headers are a common place for a missing Trigger to hide. See Blocksy pricing for what each plan includes as of October 2026.
Keep reading
- Three lines, no menuWordPress Mobile Menu Not Working: Why the Hamburger Does NothingWordPress mobile menu not working? Trace the dead hamburger to combined or delayed scripts, a breakpoint gap, an empty menu location or a z-index trap.
- Blocksy troubleshootingBlocksy CSS Not Updating: Find the Old global.css Before You Clear AnythingBlocksy CSS not updating after you publish? Learn where global.css lives, what rebuilds it, which cache keeps the old copy, and how to clear them in order.
- Blocksy performance, tunedBlocksy Theme Speed: Four Free Switches, One Paid Font Fix, and Everything Else You AddedBlocksy theme speed, setting by setting: Dynamic CSS Output, the emoji and Gravatar switches, local fonts, Core Web Vitals fixes and the theme's real limits.
- Theme reviewBlocksy Theme Review (2026): Generous for Free, Fussy About UpdatesBlocksy theme review for 2026: the free header builder, Companion and Pro, lifetime pricing, speed settings, WooCommerce, and the update bugs to watch.
- A Customizer theme, weighedBlocksy vs Next.js: A Great Free Theme Against a Site With No Plugins at AllBlocksy vs Next.js compared on 22 rows: the free header builder, Companion and Pro, lifetime licenses, the 2.1.5x regressions and when to stay put.
- Leaving BlocksyBlocksy to Next.js: Moving the Customizer, Content Blocks and Shop ExtrasMove a Blocksy site to Next.js: Customizer settings, header builder, Content Blocks, Post Types Extra fields and Shop Extra features, mapped one by one.
- Everything in WordPress TroubleshootingSee the section
Make the Blocksy hamburger open on every phone
Tell us what the menu does and on which devices. We will reproduce it on a copy of your site, find the failing layer and quote the fix before we touch anything.
Which of these sounds like you? (pick any)
Rather talk now? Call (210) 346-0848.