What are custom properties?
Custom properties are structured metadata fields that you can attach to repositories or organizations in GitHub.com. 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.
Примечание.
Organization custom properties are in public preview and subject to change. For GitHub Enterprise Server, this feature will only be available from version 3.22.
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 Создание наборов правил для репозиториев в организации and Управление настраиваемыми свойствами для репозиториев в организации.
- For organization custom rules, see Управление наборами правил кода для репозиториев в вашей организации.
How do I add and manage custom properties?
Custom properties are fully supported through GitHub's REST API, enabling programmatic management and integration with external systems. See Пользовательские свойства.
You can add custom properties through GitHub's UI. See Управление настраиваемыми свойствами для репозиториев в организации and Managing custom properties for organizations.