Table of Contents

Buttons block

Desirée M Updated by Desirée M

The Buttons block is the heart of your bot, keeping your bot flows organized and conversations flowing smoothly.

This versatile block lets users interact effortlessly and allows you to create smarter, faster, and more engaging bots. Mastering the Buttons block is one of the most important web bot features, forming the foundation for more dynamic and personalized experiences.

If you're building a WhatsApp or Facebook Messenger bot, jump to their specific sections:

Buttons for WhatsApp

Buttons for Facebook Messenger

✨ What you can do with the Buttons block

The Buttons block is one of the most versatile bot features, giving you multiple ways to guide your users and capture responses. You can:

📝 Use text, emoji, icons, or images for buttons to make interactions more visual

🔗 Add external links so users can jump to websites or resources directly

🎲 Randomize button order or allow searchable/filterable lists for long menus

✅ Enable multiple choice and save user selections as an array/multi choice field

✨ Dynamically change button labels using field values to personalize the flow

Your user sees it like this:

✏️ Write your message

Start by adding a short message that introduces the choices to your users. You can format it with bold, italics, headers, links, emojis, and more.

For a richer experience, add multiple message blocks or include Media blocks (images, GIFs, or videos). Learn more in our Media block guide.

Now, let's see what you can do in the buttons!

🔧 Buttons Editor

For every button, you can:

⚙️Edit content (click the cogwheel)

⋮⋮ Rearrange the order (use the dots/drag handle)

🗑️ Delete a button (click the bin icon)

🎨 Button Style

Choose how your button will look: plain text, an icon, an emoji, or an image.

Plain text: Simple and clean, perfect for straightforward choices.

Icon: Adds a small graphic to help illustrate the option.

Emoji: Makes the button more fun and expressive.

Image: Use a small picture to visually represent the option.

Button style options are currently available for web bots only.

You can redirect users to an external website when they click a button. Just enter the URL in the field provided.

Learn more about using External Links in this article: URL in a Button

Warning: The URL must start with https://. Otherwise, the bot will show an error and you won’t be able to save your changes.

The External Link option is currently available for web bots only.

Button options

Buttons come with a few extra settings that let you control how they look and behave. These options help you organize choices, make long lists easier to browse, and keep the flow clear for your users.

↔️ Buttons alignment

Decide how your buttons are displayed. You can show them in a row (horizontal) or one below the other (vertical). Try both and pick the style that feels clearer for your users.

Horizontal

Vertical

🎲 Randomize Button Order

You can mix up your buttons so they appear in a different order each time users see them. This keeps your bot fresh and prevents users from always choosing the first option out of habit.

This is how you'll see it in the builder, and where you'll enable the option:

And this is how it will show in random order when the user interacts with it:

🔍 Searchable options

If your Buttons block has a long list (10 or more options), you can make it searchable. This allows users to type and instantly filter the available buttons, instead of scrolling through a long list.

This makes big menus faster, easier, and less overwhelming. For example, if you show 12 cities, a user can just type “Bar” to quickly find Barcelona.

☑️ Multiple choices

Sometimes one answer isn’t enough. With the Multiple choices option, users can select more than one button before moving forward in the flow.

When this option is enabled, all selected answers are stored together in a single field as an array/multi choice. You can then use this data later in your flow for personalization, segmentation, or filtering.

Important: Connect “Any of the Above” output
When allowing multiple choice, you MUST link the Any of the Above output, or your bot will get stuck and users won’t be able to move forward after making their selections. Always connect it to the next block to keep the flow running smoothly.

You can set minimum and maximum limits (for example, “Choose at least 1 and up to 5”).

You can customize the min/max message text (default is English) in:

Settings → Custom System Messages → Help Texts → Multi-option range help

If you let users pick more than one option, don’t forget to check the box “Save output as Multi choice type field” This ensures the answers are stored correctly.

Selections can also be saved as an Array, letting you reuse the data later in Dynamic Data, or display it in other Buttons, Cards, or blocks.

⚠️ Important: If you enable “Save output as Multi choice type field.”, make sure the variable of the Buttons block is also set as Multi Choice. Otherwise, the selections won’t be stored correctly.

Want to send multiple selections to a Google Sheet?

Add a Formulas block right before your Google Spreadsheet block to clean the data and send it as an array/multi choice. Use the formula below, replacing multitest (the multi choice-type field from your Buttons block) with the name of your own field:

Replace(Replace(Replace(@multitest,"[",""),"]",""),"'","")

This ensures each selection is properly formatted before being sent to your spreadsheet.

You can also check this article for more information on how to build a list out of an array/multi choice field.

🏷️ Displaying Fields as Button Text

You can use fields as button text to make your buttons dynamic instead of fixed.

To do this, enter the field in the following format:

@{field_name}

Example: If your field is @field_name, typing @{field_name} will display its value as the button text.

This allows your buttons to automatically show personalized or dynamic content based on user data.

For WhatsApp

The Buttons block is no longer fully supported on WhatsApp because it didn’t provide an optimal user experience. If your bot already has it, it will still work, but we recommend switching to native blocks instead.

These native blocks replace the main functions of Buttons and provide a much better experience for WhatsApp users.

You can learn more about these native blocks and how to use them in the articles below:

⏩ Reply buttons block

The Reply Buttons block lets you add clickable buttons in your WhatsApp bot, making it faster and easier for users to respond — learn how to set it up in this article: Reply buttons block

📋 List buttons block

The List Buttons block lets you organize multiple options in a neat list in your WhatsApp bot, helping users choose quickly and easily — check out this article to see how to use it: List buttons block

✏️ Keyword Options block

The Keyword Options block lets you provide users with selectable options in WhatsApp, so they can reply by number or keyword — learn how to set it up in this article: Keyword Options block

For Facebook Messenger

The Buttons block works in Messenger bots, but there are some important limits:

● Facebook Messenger buttons display in a single horizontal row.

● Advanced button options (Searchable, Multiple Choices, Alignment, Randomize) are not available in Messenger.

● Only text buttons are supported: icons, images, and hyperlinks don’t work.

● Messenger allows a maximum of 14 buttons per block, including “Any of the above.”

● Each button label is limited to 20 characters; longer text will be cut off.

❌ If you exceed these Facebook Messenger button limits, the block may fail and your bot can stop working.

👍 Regular buttons in Facebook Messenger:

📌 Tip: You can still add emojis by typing them manually.

● On Mac: Control + Cmd + Space to open the emoji picker.

● On other devices: install a Chrome emoji keyboard.

⚠️ Emojis may look different depending on the user’s device.

NOTE: For a list of all the types of content you can use in Messenger bots, please see this article.

😀 Buttons with emojis in Facebook Messenger:

📑 Multiple buttons displayed in Facebook Messenger:

✂️ Truncated text when button labels are too long in Facebook Messenger:

⏩ “Any of the above”

Always connect the Any of the above output when using Buttons in Messenger.

Here’s why:

● If the user doesn’t tap a button and instead types something random, the bot will stop.

● By connecting “Any of the above,” you make sure the flow continues.

You can choose how to handle it:

● Redirect back to the same question, asking them to pick a button.

● Send a different message, guiding them forward in the flow.

This keeps your bot running smoothly and avoids dead ends in conversations.

🖼️ Images and buttons

You can add an image in the same message bubble as your buttons, but Messenger has some limitations:

● If you place text between the image and the buttons, the image will display normally.

● If you place the image right before the buttons, it will only appear as a link.

To make sure your image displays correctly:

● Use a Media block for the image, then add a Buttons block after it.

● Or add a short text line between the image and the buttons.

This ensures your users always see the image clearly instead of a link.

Was this article helpful?

Ask for a Name block

Contact