From cd54e82a4c6c0f87265e18373cc6fbd13aaddcf7 Mon Sep 17 00:00:00 2001 From: sangeeta1911 Date: Tue, 28 Jul 2026 14:37:25 +0530 Subject: [PATCH] docs: document description field for dynamic interactive message list options glific/glific#4142 (merged in glific#5399) added support for populating a list option's description from a variable, not just its title. Document the new Description field in the dynamic interactive message node config, including the 72-character WhatsApp limit, and cross-link it from the related List options in Interactive Messages doc. Co-Authored-By: Claude Sonnet 5 --- ...c Interactive Messages via Google Sheet.md | 21 ++++++++++++------- ...5. List options in Interactive Messages.md | 4 ++-- 2 files changed, 15 insertions(+), 10 deletions(-) diff --git a/docs/4. Product Features/11. Link Google Sheets/04. Dynamic Interactive Messages via Google Sheet.md b/docs/4. Product Features/11. Link Google Sheets/04. Dynamic Interactive Messages via Google Sheet.md index 3d9e5714a..778d08a44 100644 --- a/docs/4. Product Features/11. Link Google Sheets/04. Dynamic Interactive Messages via Google Sheet.md +++ b/docs/4. Product Features/11. Link Google Sheets/04. Dynamic Interactive Messages via Google Sheet.md @@ -3,7 +3,7 @@ 5 minutes read Level: Beginner - Last Updated: June 2026 + Last Updated: July 2026 @@ -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. @@ -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. + image diff --git a/docs/4. Product Features/11. Link Google Sheets/05. List options in Interactive Messages.md b/docs/4. Product Features/11. Link Google Sheets/05. List options in Interactive Messages.md index 61c6481b4..f196e96a0 100644 --- a/docs/4. Product Features/11. Link Google Sheets/05. List options in Interactive Messages.md +++ b/docs/4. Product Features/11. Link Google Sheets/05. List options in Interactive Messages.md @@ -3,7 +3,7 @@ 5 minutes read Level: Beginner - Last Updated: June 2026 + Last Updated: July 2026 @@ -76,7 +76,7 @@ For quiz - Screenshot 2025-10-09 at 2 43 44 PM -
  • The Use Dynamic Fields 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.
    • +
  • The Use Dynamic Fields 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 Dynamic Interactive Messages via Google Sheet.
    • For Nested drill down –