Skip to content

docs: document description field for dynamic interactive message list options #660

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
SangeetaMishr wants to merge 2 commits into
base: main
Choose a base branch
from
+15 −10
Open

docs: document description field for dynamic interactive message list options #660

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
cd54e82
docs: document description field for dynamic interactive message list…
sangeeta1911 Jul 28, 2026
3e8b2e8
Merge branch 'main' into docs/dynamic-interactive-message-description
mahajantejas Jul 30, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 13 additions & 8 deletions ...res/11. Link Google Sheets/04. Dynamic Interactive Messages via Google Sheet.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
<tr>
<td><b>5 minutes read</b></td>
<td style={{ paddingLeft: '40px' }}><b>Level: Beginner </b></td>
<td style={{ paddingLeft: '40px' }}><b>Last Updated: June 2026</b></td>
<td style={{ paddingLeft: '40px' }}><b>Last Updated: July 2026</b></td>
</tr>
</table>
</h3>
Expand Down Expand Up @@ -33,6 +33,8 @@ For example:
| --- | ------- | ------- | ------- | ------- |
| 1 | English | Hindi | Tamil | Kannada |

If you also want to show a description under each option (list messages only), add a column for it too - for example `course1_desc`, `course2_desc`, and so on.

> **Note**
>
> You can update the values in the row at any time, and the interactive message will automatically display the latest options. You can also add additional rows to create different sets of options.
Expand Down Expand Up @@ -114,19 +116,22 @@ For example, if your Google Sheet contains **8 options**, enter:
For each variable:

* **ID:** Any unique identifier.
* **Value:** The corresponding value retrieved from the Google Sheet.
* **Value:** The corresponding value retrieved from the Google Sheet. This becomes the option's title.
* **Description:** Optional. Another value retrieved from the Google Sheet, shown as smaller text under the option's title (list messages only - reply buttons don't have a description). Leave it blank if you don't need one.

Example:

| ID | Variable |
| ------- | ------------------------ |
| option1 | `@results.sheet.course1` |
| option2 | `@results.sheet.course2` |
| option3 | `@results.sheet.course3` |
| option4 | `@results.sheet.course4` |
| ID | Variable | Description |
| ------- | ------------------------ | ------------------------------- |
| option1 | `@results.sheet.course1` | `@results.sheet.course1_desc` |
| option2 | `@results.sheet.course2` | `@results.sheet.course2_desc` |
| option3 | `@results.sheet.course3` | `@results.sheet.course3_desc` |
| option4 | `@results.sheet.course4` | `@results.sheet.course4_desc` |

Continue the same pattern for all remaining options.

Descriptions longer than WhatsApp's 72-character limit for list item descriptions are automatically trimmed.

<img width="668" height="706" alt="image" src="https://github.com/user-attachments/assets/26bff284-39c8-4399-95bb-21b42959badc" />


Expand Down
4 changes: 2 additions & 2 deletions ...uct Features/11. Link Google Sheets/05. List options in Interactive Messages.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
<tr>
<td><b>5 minutes read</b></td>
<td style={{ paddingLeft: '40px' }}><b>Level: Beginner </b></td>
<td style={{ paddingLeft: '40px' }}><b>Last Updated: June 2026</b></td>
<td style={{ paddingLeft: '40px' }}><b>Last Updated: July 2026</b></td>
</tr>
</table>
</h3>
Expand Down Expand Up @@ -76,7 +76,7 @@ For quiz -

<img width="355" height="398" alt="Screenshot 2025-10-09 at 2 43 44 PM" src="https://github.com/user-attachments/assets/59ba324d-ba05-4a06-891c-5cd2db1c58a1" />

<li> The <code>Use Dynamic Fields</code> option is enabled, and since only two options need to be shown to the user, the Read Option Limit is set to 2. Corresponding IDs and variable names are configured to fetch the option values from the correct columns in the linked Google Sheet. </li>
<li> The <code>Use Dynamic Fields</code> option is enabled, and since only two options need to be shown to the user, the Read Option Limit is set to 2. Corresponding IDs and variable names are configured to fetch the option values from the correct columns in the linked Google Sheet. A description can optionally be configured the same way for each option - see <a href="https://glific.github.io/docs/docs/Product%20Features/Link%20Google%20Sheets/Dynamic%20Interactive%20Messages%20via%20Google%20Sheet/">Dynamic Interactive Messages via Google Sheet</a>. </li>
</ul>

For Nested drill down –
Expand Down
Loading