Using REST to work with item identity controls

The way identity controls are used with REST depend on whether a text provider has been enabled or not for an item.

Creating, updating or reading identity controls with no text provider enabled

When no text provider has been enabled on an item, identity controls work this way:

Table 1. REST tags with no text provider enabled
REST Tag Item field
<wcm:name>text</wcm:name> Name
<atom:title>text</atom:title> Display title
<atom:summary>text</atom:summary> Description

Enabling updating or reading text provider controls

To either enable, update or read text provider controls, you add the following parameters to the title tag:

Table 2. REST tags for text providers
REST Tag Text provider field
<wcm:title TextProviderName>text</wcm:title TextProviderName> Title name
<wcm:title TextProviderKey>text</wcm:title TextProviderKey> Title key
<wcm:desc TextProviderName>text</wcm:desc TextProviderName> Description name
<wcm:desc TextProviderKey>text</wcm:desc TextProviderKey> Description key

Creating, updating or reading identity controls with a text provider enabled

When a text provider has been enabled on an item, identity controls work this way:

Table 3. REST tags with a text provider enabled
REST Tag Item field
<wcm:name>text</wcm:name> Name
<wcm:displayTitle>text</wcm:displayTitle> Display title
<atom:title lang="language code" >text</atom:title>

For example:

<atom:title lang="fr" >text</atom:title>
Localized title
Note: Once a text provider is enabled, the localized title can only be read by the REST service. You will need to update the text provider plugin directly to change the localized title.
<wcm:description>text</wcm:description> Description
<atom:summary lang="language code" >text</atom:summary>

For example:

<atom:summary lang="fr" >text</atom:summary>
Localized description
Note: Once a text provider is enabled, the localized description can only be read by the REST service. You will need to update the text provider plugin directly to change the localized description.
Note: The language code required for the localized tags must be an IETF BCP47 compliant language code.