Mobile
Usage
Open Appearance → Customize → Header & Menus → Mobile to control when the site switches to the mobile menu and how the slide-out drawer looks. Set the width where the desktop links collapse (Below this width), then adjust the header height, Menu width, and link colors.
Show the mobile menu decides when the menu button replaces the desktop links. Below this width (the default) swaps them below the width you enter. Auto swaps them where your menu would start to break, and keeps up when the menu changes. Always hides the desktop links at every width, so the menu button and drawer are the only menu, on desktop too. With Always, the width under Below this width still sets where the header changes from Header height and any mobile logo size to the desktop height and logo size.
With Auto, the width field gives way to a note under the choice, such as "Switches at 1,004 px". When you publish, and when an administrator next opens any wp-admin page after the menu or header changes, their browser loads your site out of sight and finds the widest screen where the header starts to wrap or collide. The site then switches 32 px above that, in 4 px steps, and never below 768 px. Visitors run nothing extra, and if a measure can't finish (a font that didn't load, say) the site stays at its last width. Until the first measure it uses the Below this width you had. If a menu would need more than 1,600 px, the site stays where it was and the Customizer, Dashboard and Menus screen tell you the menu doesn't fit. Existing sites stay on their own Below this width until you pick Auto.
Menu width sets the drawer's width on tablets and larger. Width on phones can stay the Same as tablet (the default) or fill the screen with Full width on anything under 768 px wide. With Full width, visitors close the menu with its close button (or Escape), since no page is left beside the drawer to tap.
Pick a Menu icon and Close icon and set their sizes. The close icon sits at the top of the open drawer, where the menu button was, in the drawer's link color. The header stays where it is while the menu is open, logo and all. Page dim color and Page dim amount dim the page behind the open menu. Tapping that page closes the menu, and so does trying to scroll it (a swipe, or a mouse wheel or trackpad); the page stays where it is. Pinching there still zooms. Scrolling inside the drawer stops at its ends and doesn't carry through to the page.
Menu button changes how the menu button looks. Icon is the bare icon. Icon + Menu adds the word Menu beside it. Pill puts the icon on a filled, rounded button in your button color (or Pill color), and Pill + Menu adds the word too. A pill turns into a round close button when the menu opens, so visitors close the menu where they opened it. The Plus Menu Icon turns into an X when the menu opens.
Left unset, the pill's text turns black or white, whichever reads on the pill, and is picked again for the slightly darker pill on hover, so it always meets WCAG AA. Pill text color and Pill hover text color set it yourself; a color you pick is used as is, so check it reads (4.5:1).
The drawer slides in on a smooth ease-in-out and its links slide in from the left one after another as it arrives (with Push Page and Reveal Under, the page moves on the same curve). Menu speed sets the pace: Relaxed, Normal (the default) or Quick. Visitors who ask their device for less motion get a plain fade.
How it opens sets how the drawer meets the page. Overlay (the default) slides the drawer over the dimmed page. Push Page moves the page aside as the drawer slides in. Reveal Under slides the page off a drawer that stays put. With Push Page and Reveal Under the header stays put while the page below it moves, and the drawer's own close icon closes the menu (a Pill stays a pill under the drawer).
Menu style sets how the links inside the drawer look. New sites start on Clean; existing sites keep Classic until you pick another look.
- Classic: the original drawer, with a line under each link.
- Clean: no lines, a little more room per link, and a + that turns into × when a submenu is open.
- Editorial: top-level links in your H3 heading type, submenus in body text, and a small "Menu" label above the list.
- Grouped: every submenu stays open under its parent, which shows as a small label (it still links to its page). Best for a few top-level links with short submenus.
- Bold: top-level links in large nav type, with the header button and social icons on one row at the bottom.
- Panel: tapping a link with a submenu opens the submenu as its own page over the list, with a Back row at the top (Escape also goes back). The parent's page is the first link under Back. Best for long submenus. The drawer loads a small script only with this look.
Every look except Classic keeps the header button, search and social icons at the bottom of the drawer.
On a Reverse Print drawer (a coloured drawer with light links), submenu links, Grouped's labels and Panel's Back row are faded only as far as they stay readable: on a dark drawer they're faded as usual, on a mid-tone one they're brightened just enough, up to the full link color.
When to use it
- After setting up the desktop header, when the phone layout feels cramped or links are hard to tap.
- Sites with photo heroes that need a light menu icon on the first screen.
- Long menus that need a wider drawer.
- Phones where a side drawer leaves a thin strip of page: try Full width under Width on phones.
- Menus that change often, or a header you don't want to check by hand after each change: set Show the mobile menu to Auto.
- Minimal or photo-led sites where the drawer should be the only menu, even on desktop: set Show the mobile menu to Always.
- Sites that want a more modern, more obvious menu button: try Pill + Menu with the Plus icon.
Tips
- Background colors the drawer. Drawer link colors are set separately below it.
- Light text and icons here affects the social icons and other text in the drawer. Set the drawer Links yourself rather than relying on the desktop colors.
- If the menu switches to mobile too early or too late, try Auto, or change the width under Below this width a little at a time and check on a real device.
- Translated sites (GTranslate) should keep Below this width with a hand-set width. Translated labels are often much wider, and Auto only measures the original language.
- Auto measures what an administrator's browser sees. A menu with items only logged-out visitors get would need Below this width with a hand-set width.
- A measure is one logged-in page load in an administrator's browser. It isn't counted in Dirigible Analytics, and tracking set up in Tracking & Privacy doesn't run for it unless you track admin sessions and load scripts after page load. Code pasted into an embed runs for it, as on any page an administrator views.
- A new width from Auto reaches visitors the way any header setting does, as cached pages refresh.
- Open the menu in the preview before you start: it stays open while you change these settings, so you see each change in place.
Settings
Mobile
When the menu button replaces the desktop links. Below this width swaps them at the Breakpoint. Auto swaps them where your menu would start to break and keeps up when it changes, using an administrator's browser to measure; translated sites should keep a fixed width. Always hides the desktop links at every width, so the drawer is the only menu, on desktop too; the Breakpoint still switches the header height.
Same as tablet uses Drawer Width on phones too. Full width fills the screen under 768 px wide, and wider screens keep Drawer Width. Visitors close a full-width drawer with its close button or Escape, since no page is left beside it to tap.
Turn on when the drawer background is dark. Social icons and drawer text switch to white, and links left on the Text color show white too. Other link colors come from the settings below.
Off by default.
Color of the links in the drawer menu. With Reverse Print on, the default Text color shows as white so links stay readable on a dark drawer. Pick any other color to use it instead.
Higher is bigger: 5 is 16 px, 15 is 32 px.
5 to 20. Default 9.
Higher is bigger: 5 is 16 px, 15 is 32 px.
5 to 20. Default 9.
Overlay slides the drawer over the page. Push Page moves the page aside with it; Reveal Under slides the page off a drawer that stays put. A Pill turns into the close button only with Overlay.
How the open menu looks.