> For the complete documentation index, see [llms.txt](https://docs.quickreply.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.quickreply.ai/product-modules/templates/rcs-templates/how-tos/how-to-add-and-organize-buttons-and-suggestions-in-rcs-templates.md).

# How to Add & Organize Buttons & Suggestions in RCS Templates

This guide covers the practical steps for adding, configuring, reordering, and removing buttons in rich card templates — both Card Actions (buttons on the card, max. 4) and Suggestions (chips below the message, max. 11).

For the full field reference of every button type, see[ Card Actions and Suggestions (Chips)](https://claude.ai/product-modules/templates/rcs-templates/concepts/card-actions-and-suggestions.md).

### Adding a Button

1. In the template editor, expand the Card Actions or Suggestions section.
2. Click + Add button (Card Actions) or + Add Suggestion (Suggestions).
3. Choose one of the five button types from the dropdown:
4. Quick Reply
5. Website
6. Call Phone
7. View Location
8. Create Calendar Event
9. Fill in the fields for that type. Every button needs a button text of up to 25 characters — the label your customer sees.

![](https://docs.google.com/drawings/u/0/d/1K8Eu2v7Lx-BcTQMJEuaWLrRtVujMU_4vhGQi-pEp57RQiJL8NP5OU96SAOB8sd2eHC25nrYuObjSWa8xiVZMP6CNlk9JZknKb09B3kIfUSgrPGd4Yar4Dw/image?w=624\&h=287\&rev=9\&drawingRevisionAccessToken=SQcT4ZiKNC7spQ\&ac=1\&fmt=svg\&parent=1qOUfC_gtaXUpevTfs4bW0JvAYWxYTUYHSZ38B9ANYbg)

Repeat until you reach the limit — the "Add" control disables once the maximum is reached (e.g., "A maximum of 4 buttons have been added").

### Configuring Each Button Type

* Quick Reply — enter the Reply text (max. 25 characters) that will be sent back to you when tapped.
* Website — enter the button text, choose the URL Type (Static with a fixed URL and optional UTM parameters, or Dynamic with a per-recipient btn\_{{1}} value), and keep Link Tracking on to record clicks.
* Call Phone — enter the button text and the phone number including country code.
* View Location — enter the button text, then choose the Location Source: Static (fill in Latitude −90 to 90, Longitude −180 to 180, and an optional Label; a Map Preview appears so you can verify the pin) or Dynamic (coordinates provided per recipient).
* Create Calendar Event — enter the button text, then choose the Calendar Source: Static (fill in Event Title, Description, Start Time, and End Time) or Dynamic (event details provided per recipient).

Disabling Link Tracking on a Website button will prompt a confirmation dialog — turning it off also disables UTM tracking, and no click data will be recorded for that button. 

### Reordering Buttons

Use the ↑ / ↓ arrow controls at the top right of each button block to move it up or down. The order in the editor is the order customers see — put your primary action first.

### Removing a Button

Click the delete (trash) icon at the top right of the button block.

![](https://docs.google.com/drawings/u/0/d/1hzcXQgTIxbelmRkp_o02Kg-8_Ycc0P1mqDReGdBHwTEDXlctwlnUA2bxbky-zswTFz2fxuSvgWQSzk8-a0iZTpj2MK5tUslU__VE9uxnV4ceiLp3ufDXwQ/image?w=624\&h=284\&rev=17\&drawingRevisionAccessToken=4zcdZYYEbt9EuQ\&ac=1\&fmt=svg\&parent=1qOUfC_gtaXUpevTfs4bW0JvAYWxYTUYHSZ38B9ANYbg)

### Organizing Tips

* Lead with the primary action. The first Card Action gets the most taps — make it your main conversion goal (e.g., "Shop Now").
* Don't duplicate across Card Actions and Suggestions. Use Card Actions for the card's core actions and Suggestions for secondary options (e.g., "Call store", "Visit store").
* Keep labels short and action-oriented. You have 25 characters — verbs work best: "Track Order", "Book a demo", "View address".
* On carousels, remember Card Actions belong to each card, while Suggestions apply to the whole message.