Skip to main content
Version: 0.13.1

Custom Ownership Types

Feature Availability
Self-Hosted DataHub
Managed DataHub

🤝 Version compatibility

Open Source DataHub: 0.10.4 | Acryl: 0.2.8

What are Custom Ownership Types?

Custom Ownership Types are an improvement on the way to establish ownership relationships between users and the data assets they manage within DataHub.

Why Custom Ownership Types?

DataHub brings a pre-defined opinion on ownership relationships. We are aware that it may not always precisely match what you may need. With this feature you can modify it to better match the terminology used by stakeholders.

Benefits of Custom Ownership Types

Custom ownership types allow users to bring in their organization's ownership nomenclature straight into DataHub. This allows stakeholders to discover what relationships an owner of an entity has using the language already in-use at organizations.

How Can You Use Custom Ownership Types?

Custom Ownership types have been implemented as a net-new entity in DataHub's Metadata Model meaning all entity-related APIs can be used for them. Additionally, they can be managed through DataHub's Admin UI and then used for ownership across the system in the same way pre-existing ownership types are.

Custom Ownership Types Setup, Prerequisites, and Permissions

What you need to create and add ownership types:

  • Manage Ownership Types metadata privilege to create/delete/update Ownership Types at the platform level. These can be granted by a Platform Policy.
  • Edit Owners metadata privilege to add or remove an owner with an associated custom ownership type for a given entity.

You can create this privileges by creating a new Metadata Policy.

Using Custom Ownership Types

Custom Ownership Types can be managed using the UI, via a graphQL command or ingesting an MCP which can be managed using software engineering (GitOps) practices.

Managing Custom Ownership Types

To manage a Custom Ownership type, first navigate to the DataHub Admin page:

Then navigate to the `Ownership Types` tab under the `Management` section.

To create a new type simply click '+ Create new Ownership Type'.

This will open a new modal where you can configure your Ownership Type.

Inside the form, you can choose a name for your Ownership Type. You can also add descriptions for your ownership types to help other users more easily understand their meaning.

Don't worry, this can be changed later.

Once you've chosen a name and a description, click 'Save' to create the new Ownership Type.

You can also edit and delete types in this UI by click on the ellipsis in the management view for the type you wish to change/delete.

Assigning a Custom Ownership Type to an Entity (UI)

You can assign an owner with a custom ownership type to an entity either using the Entity's page as the starting point.

On an Entity's profile page, use the right sidebar to locate the Owners section.

Click 'Add Owners', select the owner you want and then search for the Custom Ownership Type you'd like to add this asset to. When you're done, click 'Add'.

To remove ownership from an asset, click the 'x' icon on the Owner label.

Notice: Adding or removing an Owner to an asset requires the Edit Owners Metadata Privilege, which can be granted by a Policy.

Need more help? Join the conversation in Slack!