> For the complete documentation index, see [llms.txt](https://gitbook.semantify.it/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.semantify.it/draft/domainspecifications/ds-v2/grammar/domainspecification/customenumerationvalue.md).

# Grammar Documentation for node type "CustomEnumerationValue"

This is a node specifying the usage of a custom enumeration value instance.

This node should allow the usage of value instances that are NOT stated as an enumeration value instance by Schema.org.

Usually, enumerations have a set of valid instances for that enumeration:

e.g. <https://schema.org/EBook> is an enumeration value instance for the enumeration <https://schema.org/BookFormatType>

But there are also enumerations, which do not specify such a set of valid instances; There is a set of "commonly used values" at most, which are in the description of the enumeration:

e.g. <https://schema.org/PaymentMethod> is an enumeration without enumeration value instances. However, the description lists a set of commonly used values for this enumeration (which are not part of Schema.org), e.g. <http://purl.org/goodrelations/v1#DirectDebit>

The node type "CustomEnumerationValue" enables the definition and usage of such external enumeration values.

![Syntax diagram](https://4171987096-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MXl6YtFKrJ1dUqsLouU%2Fsync%2Ff702d4c90c3d31f69af18ab13390a9264708e687.png?generation=1617879605300320\&alt=media)

## $type

**Required**. Has always the string "CustomEnumerationValue" as value.

Based on "@type" from JSON-LD (Indicates the type of the node/object). This value is a short form for the URI identifying this node type in the DS grammar.

## $customEnumerationValue

**Required**. Has always a string as value.

The string must be an URI for the custom enumeration value, e.g. "<http://purl.org/goodrelations/v1#DirectDebit>"

## name

**Optional**. Has always a string as value.

Same as the property "name" from Schema.org (meta information about the entity).

## description

**Optional**. Has always a string as value.

Same as the property "description" from Schema.org (meta information about the entity).