# Dataset Attributes & Responsibilities

Dataset settings allow you to define key metadata, ownership, and business context for your datasets. This information helps ensure data governance, accountability, and seamless integration with other tools like your data catalog.

## Dataset Owner

#### Purpose of the Dataset Owner

Each dataset should have a designated **dataset owner**: a person or team responsible for the dataset's quality, availability and usage.

**Typically, the role of a Dataset Owner includes:**

* Defining and maintaining the dataset's purpose and documentation.
* Ensuring the dataset meets data quality standards and contract requirements.
* Responding to issues, such as failed checks or data quality alerts.
* Reviewing and approving changes to the dataset schema or contract.

#### Updating the Dataset Owner

{% hint style="warning" %}
Only users with the **Configure Dataset** permission on the dataset can update the dataset owners. [Global and Dataset Roles](https://docs.soda.io/soda-v4/organization-and-admin-settings/global-and-dataset-roles)
{% endhint %}

To assign a **Dataset Owner**:

{% stepper %}
{% step %}
Open the **dataset page**.
{% endstep %}

{% step %}
Click the **context menu** (⋮) in the top-right corner and select **Edit Dataset**.

<figure><img src="https://1123167021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2PmHkO5cBgeRPdiPPOG%2Fuploads%2FLfhVVZ8KkKQllFYiPrdj%2Fimage.png?alt=media&#x26;token=cef4f909-73ad-4085-873a-7a1fa9f971d8" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
In the **Owned by** section, select one or more users and/or user groups.

<figure><img src="https://1123167021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2PmHkO5cBgeRPdiPPOG%2Fuploads%2Ff48t1eFD34mT5riwfGmn%2Fimage.png?alt=media&#x26;token=203796ed-6814-4d79-aef8-b259992d6587" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Fill in the optional information and click **Save** (top right) to apply the changes.
{% endstep %}
{% endstepper %}

## Responsibilities

#### What are Responsibilities?

**Responsibilities** allow you to assign permissions to users or user groups, ensuring they have the access they need to work with a dataset.

A **Responsibility** is a combination of:

* A **User** or **User Group**.
* A **Dataset Role**, which is a predefined collection of permissions (such as the ability to edit contracts, view checks, or manage settings).

By assigning Responsibilities, you define **who can do what** for each dataset, supporting clear ownership, governance, and collaboration.

> Learn about defining custom roles: [Global and Dataset Roles](https://docs.soda.io/organization-and-admin-settings/global-and-dataset-roles).

#### How to Add Responsibilities

Managing responsibilities requires the following dataset role: "Manage dataset responsibilities"

To assign a Responsibility to a user or group:

{% stepper %}
{% step %}
Open the **dataset page**.
{% endstep %}

{% step %}
Click the **context menu** (⋮) in the top-right corner and select **Edit Responsibilities**.

<figure><img src="https://1123167021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2PmHkO5cBgeRPdiPPOG%2Fuploads%2FQLlq87Ey0BN2ZHNxf0ba%2Fimage.png?alt=media&#x26;token=02b31f04-6763-4a22-bfd7-ed4311e2e3f7" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Add the desired **users** or **user groups**.

<figure><img src="https://1123167021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2PmHkO5cBgeRPdiPPOG%2Fuploads%2F9Qi3GKkiDGenYC7rGS21%2Fadd-user-to-responsibility.png?alt=media&#x26;token=8c55d521-cc36-4ba1-a844-4c6a55aa4a91" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Select the appropriate **Dataset Role** for each.

<figure><img src="https://1123167021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2PmHkO5cBgeRPdiPPOG%2Fuploads%2FXrCdqhhVDcoHX9voGAXW%2Fselect-role.png?alt=media&#x26;token=5d1ecee4-dfe7-4bb0-9169-6b380550c525" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Click **Save** to apply the changes.

<figure><img src="https://1123167021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2PmHkO5cBgeRPdiPPOG%2Fuploads%2FDTT2fEFy9woIC6ziJJyb%2Fedit-responsibility-save.png?alt=media&#x26;token=7fb47bda-7e3a-4f4b-b01f-2a57d2a54818" alt="" width="535"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### Default Dataset Owner role

Every dataset has a **default Dataset Owner role**, automatically assigned to the designated Dataset Owner(s).

* This role provides essential permissions to manage and maintain the dataset.
* The Dataset Owner role **cannot be removed**, but it can be combined with other roles for additional permissions.

<figure><img src="https://1123167021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2PmHkO5cBgeRPdiPPOG%2Fuploads%2Fw7sLOR7VpUICVdFK7iRY%2Fdefault-owner-responsibility.png?alt=media&#x26;token=011c8a42-43b0-42a1-bc59-b1a783cb62ab" alt="" width="535"><figcaption></figcaption></figure>

{% hint style="info" %}
The **default permissions** granted to the Dataset Owner role are customizable at the organization level. For more details on configuring the default Dataset Owner role and other roles, see the [#define-default-responsibilities](https://docs.soda.io/organization-and-admin-settings/global-and-dataset-roles#define-default-responsibilities "mention")
{% endhint %}

## Dataset Attributes

{% hint style="info" %}
Only users with the **Configure Dataset** permission on the dataset can update the attributes. [Global and Dataset Roles](https://docs.soda.io/soda-v4/organization-and-admin-settings/global-and-dataset-roles)
{% endhint %}

#### Purpose of Attributes

Dataset attributes allow you to add descriptive **metadata** to your datasets. This metadata can then be:

* **Used for filtering** in Soda Cloud, making it easier to search and organize datasets and checks based on specific criteria (e.g., business domain, sensitivity, criticality).
* **Leveraged in reporting**, enabling you to group datasets, track ownership, and monitor data quality across different categories or dimensions.

Adding meaningful attributes enhances discoverability, governance, and collaboration within Soda and its integrations.

Learn how to define attribute types: [check-and-dataset-attributes](https://docs.soda.io/manage-issues/check-and-dataset-attributes "mention")

#### Adding Dataset Attributes

You can add or modify dataset attributes in the Dataset Settings page:

{% stepper %}
{% step %}
Click the **context menu** (⋮) in the top-right corner and select **Edit Dataset**.

<figure><img src="https://1123167021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2PmHkO5cBgeRPdiPPOG%2Fuploads%2FQLlq87Ey0BN2ZHNxf0ba%2Fimage.png?alt=media&#x26;token=02b31f04-6763-4a22-bfd7-ed4311e2e3f7" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Set a value for the existing attribute type. They are all optional.

<figure><img src="https://1123167021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2PmHkO5cBgeRPdiPPOG%2Fuploads%2FvXDPpfxdvvOLy3qqpEJZ%2FEdit-attributes.png?alt=media&#x26;token=5a8b0fbf-ee13-4f95-b80c-0d6005bae258" alt="" width="536"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Save** your changes.

<figure><img src="https://1123167021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2PmHkO5cBgeRPdiPPOG%2Fuploads%2FwMlq6qShftDbaCUx9za4%2Fedit-attributes-save.png?alt=media&#x26;token=0bdd9d16-f955-4f6d-9b54-acd84c55999c" alt="" width="536"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

## Bulk edit of Attributes and Responsibilities

When managing multiple datasets, you can save time by applying changes in bulk using the **Bulk Edit** feature.

#### How to bulk edit Datasets

{% stepper %}
{% step %}
Go to the **Datasets** page.
{% endstep %}

{% step %}
Select the datasets you want to edit using the checkboxes. Click **Edit** in the action menu.

<figure><img src="https://1123167021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2PmHkO5cBgeRPdiPPOG%2Fuploads%2FRwNdvte1dndDUJbB3nwP%2Fimage.png?alt=media&#x26;token=a52139c4-088f-466a-ad44-b7f1ca67bf3d" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Define attributes you want to add or modify across the selected datasets.

<figure><img src="https://1123167021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2PmHkO5cBgeRPdiPPOG%2Fuploads%2FZXw68W1zrBkgDr7OrBLf%2FScreenshot%202025-05-29%20at%2011.21.53%20AM.png?alt=media&#x26;token=209544f2-2690-4661-8990-f6a81a1f7c94" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Define responsibilities you want to add or modify across the selected datasets.

Choose whether to **update existing** responsibilities (add new without removing existing) or **reset** (replace all existing responsibilities with the new definition).

<figure><img src="https://1123167021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2PmHkO5cBgeRPdiPPOG%2Fuploads%2FgoZDGE2iTsOWJUHN2qcd%2Fbulk-responsibility.png?alt=media&#x26;token=f631db39-7764-4ac7-a4bc-eb132f206f8d" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Click **Continue** to review your changes.

<figure><img src="https://1123167021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2PmHkO5cBgeRPdiPPOG%2Fuploads%2FSeGisSnoLyiuWKeUFBUr%2Fbulk-save.png?alt=media&#x26;token=5415a624-1d9f-411c-b54c-9614a6fdc8f8" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

## Integrate with data catalog

You can automate the management of **dataset attributes** and **responsibilities** in Soda Cloud using our **REST API**. This allows you to:

* Programmatically **set or update attributes** for multiple datasets.
* Assign **responsibilities** (users, groups, and roles) to datasets at scale.
* Keep your Soda Cloud configuration in sync with your data catalog or external metadata management systems.

This automation ensures that your metadata stays up-to-date and consistent across your ecosystem, supporting seamless governance and discoverability.

To do so, you can leverage our APIs: [Broken link](https://docs.soda.io/broken-reference "mention") and [Broken link](https://docs.soda.io/broken-reference "mention").

<br>

***

{% if (visitor.claims.plan === 'datasetStandard')%}
{% hint style="success" %}
You are **logged in to Soda** and seeing the **Free license** documentation. Learn more about [documentation-access-and-licensing](https://docs.soda.io/reference/documentation-access-and-licensing "mention").
{% endhint %}
{% endif %}

{% if (visitor.claims.plan === 'enterprise')%}
{% hint style="success" %}
You are **logged in to Soda** and seeing the **Team license** documentation. Learn more about [documentation-access-and-licensing](https://docs.soda.io/reference/documentation-access-and-licensing "mention").
{% endhint %}
{% endif %}

{% if (visitor.claims.plan === 'enterpriseUserBased')%}
{% hint style="success" %}
You are **logged in to Soda** and seeing the **Enterprise license** documentation. Learn more about [documentation-access-and-licensing](https://docs.soda.io/reference/documentation-access-and-licensing "mention").
{% endhint %}
{% endif %}

{% if !(visitor.claims.plan === 'enterprise' || visitor.claims.plan === 'enterpriseUserBased' || visitor.claims.plan === 'datasetStandard')%}
{% hint style="info" %}
You are **not logged in to Soda** and are viewing the default public documentation. Learn more about [documentation-access-and-licensing](https://docs.soda.io/reference/documentation-access-and-licensing "mention").
{% endhint %}
{% endif %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.soda.io/dataset-attributes-and-responsibilities.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
