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.
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:
| Button | Type | What happens |
|---|---|---|
| Book a table | URL | Opens the booking page |
| Opening hours | Postback | The bot replies with today’s hours |
| Track my order | Postback | The bot asks for the order number |
| Talk to a person | Postback | The 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
- Ice breakersIce breakers are up to four frequently asked questions a business shows in its Instagram or Messenger chat. Tapping one starts the conversation.
- Quick repliesQuick replies are up to 13 buttons attached to a business’s message. Tapping one posts its words as the person’s reply, and the buttons disappear.
- Generic template (message cards)A generic template is a DM card with a title, an optional image and subtitle, and up to three buttons. Up to 10 cards in one message make a carousel.
- Messenger PlatformThe Messenger Platform is Meta’s free API that passes messages sent to a Facebook Page, or a linked Instagram account, to an app and lets the app reply.
- Facebook PageA public Facebook presence for a business, brand or creator, managed by people with roles. It is separate from a personal profile and is what messaging tools connect to.
- ChatbotA chatbot is software that answers messages automatically, either by following rules you set, like keywords and buttons, or by writing replies with AI.
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