---
title: "<canonicalValue> element"
description: A canonicalValue element has the following XML attributes:
component: pingdirectory
version: 10.1
page_id: pingdirectory:pingdatasync_server_administration_guide:pd_sync_canonicalvalue_element
canonical_url: https://docs.pingidentity.com/pingdirectory/10.1/pingdatasync_server_administration_guide/pd_sync_canonicalvalue_element.html
revdate: September 13, 2023
---

# \<canonicalValue> element

A `canonicalValue` element has the following XML attributes:

* `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 in sequence:

* `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.