Wiozen Market

Why doesn't my WordPress menu show on phones, and how do you add a hamburger menu to a block theme?

In short:In a block theme, the Navigation block's overlay setting decides how the menu looks on phones. If it's set to "Off", the menu never turns into a button on phones and stays a row; links that don't fit wrap to a new line or run off the screen. Since 1.4.0, Wiozen Theme has a phone menu button in all five designs: on screens narrower than 782 pixels (761 in the Guide design) the menu row is hidden, and the button next to search and dark mode opens the whole menu, submenus included, full screen. No plugin or setting is needed.

What decides the menu on phones?

In a block theme, the menu in the header is a Navigation block. When you select it in the Site Editor, the settings on the right show an overlay option (called "Overlay Menu" or "Overlay Visibility" depending on your WordPress version) with three values:

  • Off: the menu is a row on every screen and never turns into a button on phones.
  • Mobile: on narrow screens WordPress turns the menu into its own button; on wide screens it's a row.
  • Always: the menu is a button on every screen.

When a menu vanishes or overflows on phones, it's usually the first case. To fix it in another block theme, open the header under Appearance › Editor, select the menu, set the overlay option to Mobile and save.

How does the phone menu work in Wiozen Theme?

In the Classic and Centered headers the menu sits in a separate bar on desktop, and that bar's overlay setting is Off on purpose. On phones a separate button takes over:

  • In the News, Technology, Finance and Food designs, the menu bar in the Classic and Centered headers is hidden on screens 781 pixels wide or narrower.
  • In the Guide design all three header layouts have the button; the limit there is 760 pixels.
  • The button sits on the right, next to the search and dark mode buttons. Tapping it opens the menu full screen in the page's background and text colors.
  • Submenus show as a plain indented list under their parent instead of boxes that open and close.

In the Compact header of News, Technology, Finance and Food, the menu shares the bar with the logo and its overlay setting is Mobile, so on narrow screens it turns into WordPress's own button. Submenus there use the same indented list.

The open menu comes from WordPress's Navigation block: screen readers hear it as a dialog, the Escape key closes it, and focus goes back to the button when it closes. On screens 782 pixels or wider the menu shows as the normal bar, so a 768-pixel tablet held upright also gets the button (in the Guide design it gets the bar).

Which links appear in the phone menu?

The button opens the same menu as on desktop; you don't build a separate phone menu. If you picked categories in the "Categories in the menu" card on the Appearance › Wiozen Theme › Settings tab, the menu is built from them: parent categories first, and a subcategory you picked becomes a submenu under its parent. If you didn't pick any, the menu that came with the demo content is shown, and without demo content WordPress shows its fallback menu.

To edit the links by hand, use the Appearance › Editor › Navigation screen. The header layouts and the categories card are covered in the header layout guide.

Does a header I saved in the Site Editor get the button?

Yes. If you saved the header in the Site Editor before 1.4.0, you don't need to reset it: the theme adds the button to your saved copy right after the dark mode button, using the menu your bar already uses. Your copy in the database doesn't change, and the button shows in the Site Editor too.

The theme leaves these headers alone:

  • A header whose menu already opens on phones, meaning it has a Navigation block whose overlay setting isn't Off.
  • A header with no menu at all.
  • A header where you deleted the button in the Site Editor and saved. WordPress remembers the deletion and the button doesn't come back.

Because the button is added after the dark mode button, it isn't added if you deleted the dark mode block from your saved header. In that case reset the header in the "Customized templates" card on the Customize tab (your manual changes to it are lost), or set your menu's overlay option to Mobile. Turning off the "Dark mode button" switch under Settings doesn't affect the menu button; the switch only hides the dark mode button.

If you're on an older version

Before 1.4.0 only the Technology design had the phone menu button (since 1.2.1); in the Classic and Centered headers of the other designs (and all three Guide layouts) the menu stayed a sideways-scrolling bar on phones. Updating the theme is enough to get the button, and your settings and saved templates stay. See the theme update guide.

Frequently asked questions

Do I need a plugin for a phone menu?
No. The button is WordPress's own Navigation block and comes ready in the header of every Wiozen Theme design.
How do submenus look on phones?
Open, as an indented list under their parent. You don't need to tap an arrow to expand them.
If I turn off the dark mode button, does the menu button disappear too?
No. The switch under Settings only hides the dark mode button; the menu button stays.
Does a tablet get the button or the bar?
In the Classic and Centered headers, the button if the screen is 781 pixels wide or narrower, the bar if it's wider. In the Guide design the limit is 760 pixels.

For a block theme with the phone menu already in place, download Wiozen Theme for free.

Download free