---
title: Creating a consent definition and localization
description: Create and update a consent definition and localization.
component: pingdirectory
version: 11.0
page_id: pingdirectory:consent_solution_guide:pd_cs_create_consent_def_localization
canonical_url: https://docs.pingidentity.com/pingdirectory/11.0/consent_solution_guide/pd_cs_create_consent_def_localization.html
revdate: September 13, 2023
section_ids:
  steps: Steps
  example: Example:
  example-2: Example:
  example-3: Example:
---

# Creating a consent definition and localization

Create and update a consent definition and localization.

## Steps

* Create a consent definition using `dsconfig create-consent-definition`.

  ### Example:

  ```shell
  $ bin/dsconfig create-consent-definition \
    --definition-name email_newsletter \
    --set "display-name:Email newsletter"
  ```

* Create a localization for the consent definition using `dsconfig create-consent-definition-localization`.

  ### Example:

  ```shell
  $ bin/dsconfig create-consent-definition-localization \
    --definition-name email_newsletter \
    --localization-name en-US \
    --set version:1.0 \
    --set "data-text:Your email address" \
    --set "purpose-text:To receive newsletter updates"
  ```

* Update a localization and the version using `dsconfig set-consent-definition-localization-prop` and `set version`.

  ### Example:

  The following example updates a localization and its version.

  ```shell
  $ bin/dsconfig set-consent-definition-localization-prop \
    --definition-name email_newsletter \
    --localization-name en-US \
    --set version:1.1 \
    --set "data-text:Your preferred email address"
  ```