---
title: "About the <code class=\"codeph\">canonicalValue</code> element"
description: A canonicalValue element has the following XML attribute:
component: pingdirectory
version: 10.1
page_id: pingdirectory:pingdirectory_server_administration_guide:pd_ds_canonicalvalue_element
canonical_url: https://docs.pingidentity.com/pingdirectory/10.1/pingdirectory_server_administration_guide/pd_ds_canonicalvalue_element.html
revdate: July 5, 2024
---

# About the `canonicalValue` element

A `canonicalValue` element has the following XML attribute:

* `name`: specifies the value of the type sub-attribute. For example, work is the value for emails, phone numbers and addresses intended for business purposes.

A `canonicalValue` element contains the following XML element:

* `subMapping`: an optional element specifying mappings for one or more of the sub-attributes. Any sub-attributes that have no mappings will be ignored by the mapping service.