docs/content/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/custom-properties.md

title, intro, permissions, versions, topics, shortTitle, contentType

title	intro	permissions	versions	topics	shortTitle	contentType
Custom properties	Custom properties allow you to add structured metadata to repositories and organizations, enabling better organization, governance, and automation across your {% data variables.product.github %} environment.	Repository custom properties can be managed by organization owners and users with admin permissions to the repository. Organization custom properties can be managed by enterprise owners and users with the "Manage the Enterprise's custom properties definitions" permission.	ghec ghes * *	Enterprise Organizations Repositories Policies	Custom properties	concepts

What are custom properties?

Custom properties are structured metadata fields that you can attach to repositories or organizations in {% data variables.location.product_location %}. They allow you to decorate your repositories or organizations with information such as compliance frameworks, data sensitivity, or project details.

An enterprise can have up to 100 property definitions. An allowed value list can have up to 200 items.

There are two types of custom properties:

• Repository custom properties: Metadata attached to individual repositories.
• Organization custom properties: Metadata attached to organizations within an enterprise.

{% data reusables.enterprise-accounts.org-custom-properties-public-preview %}

What are the benefits of using custom properties?

As well as providing improved discovery, automated workflows, compliance tracking, targeted policy enforcement, and better reporting capabilities, custom properties enable powerful governance through ruleset integration.

Both repository and organization custom properties can be used as targeting criteria for rulesets, enabling fine-grained policy enforcement based on metadata.

• For repository custom rules, see AUTOTITLE{% ifversion ghec %} and AUTOTITLE.
• For organization custom rules, see AUTOTITLE.{% endif %}

How do I add and manage custom properties?

{% ifversion ghec %}

Custom properties are fully supported through {% data variables.product.github %}'s REST API, enabling programmatic management and integration with external systems. See AUTOTITLE.

{% endif %}

You can add custom properties through {% data variables.product.github %}'s UI. See AUTOTITLE and AUTOTITLE.