Glossary

What is a persistent menu in Messenger and Instagram?

A persistent menu is a menu of buttons a business attaches to its chats, so options such as opening hours, store locations or products stay one tap away for the whole conversation. Facebook Pages set one for Messenger and Instagram professional accounts for their DMs. On Messenger it holds up to 20 buttons, and each one either opens a web page or sends the business a message its bot can answer.

Updated 6 October 2026

A persistent menu is a set of buttons a business keeps available in its Messenger or Instagram chats, linking to things like opening hours, products or support.

Messages and DMs

How the menu works

  • Size: up to 20 buttons, each with a title of up to 30 characters, although Meta’s guidance is to keep it to five.
  • Two button types. A URL button opens a web page; a postback button sends the business a hidden payload, and its bot replies in the chat.
  • A Get Started button comes first. Without one set on the Page, the menu doesn’t appear.
  • The Page must be published, the bot needs the pages_messaging permission and must be set to public in its app settings, and the person setting the menu needs the Administrator role on the Page.
  • Commands come first. If the Page has bot commands set, they take priority over the persistent menu.
  • Timing: a change to the Page’s menu can take up to 24 hours to show. A menu set for one person overrides it and updates straight away.
  • Languages: each locale can have its own menu, with a default one as the fallback.
  • Devices: it shows in the Messenger app on iPhone and Android from version 106, but not in Facebook’s mobile browser.

The menu stays available for the whole conversation, and Messenger brings it back into view when someone returns after a while away. That makes it the place for things people need at any point, not just at the start.

What to put in it

Good menu items answer the questions that keep coming back, or take people somewhere they’d otherwise ask for a link to. A restaurant’s menu might look like this:

ButtonTypeWhat happens
Book a tableURLOpens the booking page
Opening hoursPostbackThe bot replies with today’s hours
Track my orderPostbackThe bot asks for the order number
Talk to a personPostbackThe chat is flagged for the team

Keep a route to a person. A menu made only of automated paths frustrates anyone whose question doesn’t fit, and they’ll type it anyway.

Hiding the text box

Setting composer_input_disabled to true hides the text box, leaving the menu as the only way to interact. That can suit a narrow bot, one that only books appointments, say. For most businesses it backfires: customers want to ask their own questions, and a chat they can’t type into looks broken.

With the text box left on, which is the default, people can tap or type, and whatever they type reaches the business as an ordinary message.

The persistent menu on Instagram

Instagram DMs can have a persistent menu too. Meta’s Messenger API support for Instagram sets it with the same Messenger Profile API call, adding platform=instagram, and it takes the same two button types: URL and postback. When someone taps an item, the business gets a postback webhook and the standard messaging window opens, so it has 24 hours to reply.

  • No hidden text box. composer_input_disabled isn’t available on Instagram, so people can always type.
  • One menu for everyone. A menu can’t be set for a single person, so a Track my order button shows to all.
  • Slow to reach old chats. An existing conversation shows a new menu only after the person refreshes their inbox; new conversations get it straight away.
  • Requirements: Meta’s guide names version 226 or above on iOS or Android, and an Instagram professional account, Page, developer account and app set up for Messenger API support for Instagram.
  • No webview_height_ratio, so a URL button can’t choose a compact or tall webview.

Tip: Changed the menu and can’t see it in the Instagram app? Go to the messages inbox and swipe down to refresh, which is the check Meta’s own guide gives.

An example

A pizza place’s Messenger menu has three buttons: Order online, Opening hours and Talk to us. A customer scrolling an old chat taps Opening hours and gets tonight’s closing time without typing a word.

Questions people ask

How many buttons can a persistent menu have?

Up to 20. Meta suggests about five, and a phone screen agrees: past that, people scroll and skim instead of choosing.

Why isn’t my persistent menu showing?

On Messenger, check that the Page is published and has a Get Started button, that no bot commands are set (they take priority), and that you’ve waited, since changes to the Page’s menu can take up to 24 hours. It doesn’t show in Facebook’s mobile browser or in Messenger versions older than 106. On Instagram, swipe down in the messages inbox to refresh an existing chat.

Can different people see different menus?

Yes. A menu set for one person replaces the Page’s menu for them and updates at once, so a bot can show a Track my order button only to people who have ordered.

Does Instagram have a persistent menu?

Yes. Meta’s Messenger API support for Instagram includes a persistent menu with URL and postback buttons. Unlike Messenger’s, it can’t hide the text box or show one person a different menu. Ice breakers, up to four questions at the start of a chat, and quick replies under a single message are separate features.

What’s the difference between a persistent menu and quick replies?

Quick replies belong to one message and disappear after a tap. The persistent menu belongs to the whole conversation and stays available, so it suits options people may want at any point.

Sources

Related terms

More terms

Answer DMs in seconds, within Meta’s rules

DMFast answers comments, DM keywords and Instagram Story replies automatically, inside the 24-hour window and Meta’s other messaging rules. Free plan, no card.

Start free