Expertise AI Knowledge Base

   Playbooks  Tool: @show_options

Tool: @show_options

Display multiple-choice button options for visitors to select

Last updated on October 27, 2025

@show_options

What it does

Displays clickable button choices for the visitor to select from (multiple choice).

When to use it

When you want structured responses from a predefined set of choices.

Can combine with

Syntax

Always use bracket notation with quoted options:
@show_options["Choice A", "Choice B", "Choice C"]

Configuration

No special configuration required. HubSpot advanced users can configure property mappings for specific questions.

Examples

Basic usage:
1. @ask_question: "What is your company size?" @show_options["1-50 employees", "51-200 employees", "201+ employees"]
With branching:
1. @ask_question: "What's your company size?" @show_options["1-50", "51-200", "201+"]
    - If "1-50", proceed to Step 2.
    - If "51-200", proceed to Step 3.
    - If "201+", proceed to Step 4.
Yes/No decision:
1. @ask_question: "Would you like to schedule a demo?" @show_options["Yes", "No"]
    - If "Yes", proceed to Step 2.
    - If "No", proceed to Step 5.

Tips

  • Use for answer choices, NOT for listing questions
  • Keep option text concise (2-5 words ideal)
  • Provide clear, mutually exclusive choices
  • Order options logically (by size, priority, etc.)
  • Keep the number of options reasonable for good UX

Common Patterns

Binary choice (Yes/No):
@show_options["Yes", "No"]
Size/Scale options:
@show_options["Small (1-50)", "Medium (51-200)", "Large (201+)"]
Category selection:
@show_options["Sales", "Support", "Billing", "General"]

Learn More