---
title: "s.syntax.group-choice"
description: "## Syntax **s.syntax.group-choice**   ## Purpose The s.syntax.group-choice annotation is used to tag a span element as being an option that the user can choose in a syntax diagram. A group choice can be nested within a group sequence or…"
url: "https://www.stilo.com/docs/migrate/programming/s-syntax-group-choice/"
updated: "2023-12-18"
category: Annotations / Programming
tags:
  - Annotations
---

# s.syntax.group-choice

## Syntax

**s.syntax.group-choice**

 

## Purpose

The s.syntax.group-choice annotation is used to tag a span element as being an option that the user can choose in a syntax diagram. A group choice can be nested within a group sequence or group composite.

 

This annotation can be applied at both the span and paragraph scopes.

## Examples

The following is an example of a time when you might want to use the annotations

![](https://www.stilo.com/wp-content/uploads/2023/12/stilo-dita-xml-annotation-s.syntax.group-choice0.png)

 

The following is an example of a rule that will apply the annotation

![](https://www.stilo.com/wp-content/uploads/2023/12/stilo-dita-xml-annotation-s.syntax.group-choice1.png)

The following is the DITA XML output for the rule:

<groupchoice>

<title>>group </title>

<repsep>,</repsep>

<kwd>OptionA</kwd>

<kwd>OptionB</kwd>

<kwd>OptionC</kwd>

</groupchoice>