---
updatedAt: 2025-11-03T17:19:13.000Z
agentTools:
  projectIndex: https://docs.gupshup.io/llms.txt
---

# Quick Reply

It is a special type of message using which a chatbot can provide multiple options for a customer to select. It is a message type with a text message and clickable buttons. The clickable buttons are treated as a response from the user to process the journey further.

Quick Reply has the following constituents:

1. A text message (max 640 characters)
2. Buttons with a title (max 20-character limit)

Buttons support emojis and variables can be added to the buttons.

Synonyms can be added to the buttons' names.

### When to use

If there is a need to show multiple options with a message where the user can select one of the provided options, a quick reply can be used.

### Limitations

1. Applicable for Instagram channel only

### How to use

Check the video below:

<Embed url="https://www.youtube.com/watch?v=TfRMLWJH9yg" title="Quick Reply" favicon="https://www.google.com/favicon.ico" image="https://i.ytimg.com/vi/TfRMLWJH9yg/hqdefault.jpg" provider="youtube.com" href="https://www.youtube.com/watch?v=TfRMLWJH9yg" typeOfEmbed="youtube" html="%3Ciframe%20class%3D%22embedly-embed%22%20src%3D%22%2F%2Fcdn.embedly.com%2Fwidgets%2Fmedia.html%3Fsrc%3Dhttps%253A%252F%252Fwww.youtube.com%252Fembed%252FTfRMLWJH9yg%253Ffeature%253Doembed%26display_name%3DYouTube%26url%3Dhttps%253A%252F%252Fwww.youtube.com%252Fwatch%253Fv%253DTfRMLWJH9yg%26image%3Dhttps%253A%252F%252Fi.ytimg.com%252Fvi%252FTfRMLWJH9yg%252Fhqdefault.jpg%26key%3D7788cb384c9f4d5dbbdbeffd9fe4b92f%26type%3Dtext%252Fhtml%26schema%3Dyoutube%22%20width%3D%22854%22%20height%3D%22480%22%20scrolling%3D%22no%22%20title%3D%22YouTube%20embed%22%20frameborder%3D%220%22%20allow%3D%22autoplay%3B%20fullscreen%22%20allowfullscreen%3D%22true%22%3E%3C%2Fiframe%3E" />

### Quick Reply Node

![](https://files.readme.io/74e5994-Quick_Reply.PNG)

### How to use Quick Reply Node with Dynamic Buttons

We have improved the functionality of Quick Reply(QR) Node which allows you to dynamically send a JSON Payload to extract the Quick Reply values and use these to send it to the user.

The feature is as simple as defining a JSON Payload which has a key containing the QR values and Bot Studio will iterate through the key element referred to fetch the values to be listed as the QR Buttons. Below is a representation of how this can be used:

For reference we are taking the below JSON Payload as our dynamic payload:

```
{
  "categories": [
    {
      "name": "Personal Accessories",
      "items": [
        "sunglasses",
        "watches"
      ]
    },
    {
      "name": "Clothes",
      "items": [
        "premium Tshirt",
        "premium shirts",
        "pant"
      ]
    },
    {
      "name": "Skin Care Products",
      "items": [
        "sunscreen",
        "facewash"
      ]
    }
  ]
}
```

As a use case lets assume we want to share the categories of products to a user. The above JSON has `categories` key which contains the category names in the `name` key which we need to populate. We will store the JSON object on a local or global variable and will use that in the QR Node

To do this we will refer the JSON Key `categories` on the QR Node as shown below and will map the `name` key as the iterator key inside the categories object to fetch the QR Button Names.

### Representation on Journey Canvas

![](https://files.readme.io/c8f5524-image.png)

Here `var_local.qrjson.categories` denotes that the variable `qrjson` contains the payload the `qrjson.categories` is where the object to be iterated. The next placeholder `<<element.name>>` denotes that the iterator should find the `name` key value for the QR Button value. The term `element` refers to the parsed value of the above element.

### Representation on WhatsApp

<Image align="center" src="https://files.readme.io/804780b-IMG-20230928-WA0030.jpg" />