Skip to main content

Managing custom properties for organizations

With custom properties, you can add metadata to organizations in your enterprise and use that metadata to target repositories with rulesets.

누가 이 기능을 사용할 수 있나요?

Enterprise owners and users with the "Manage the Enterprise's custom properties definitions" permission can add and set a custom property schema at the enterprise level.

참고 항목

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.

About custom properties

Custom properties are structured metadata fields that you can add to repositories and organizations in GitHub to enable better organization, governance, and automation across your environment. See Custom properties.

This article relates to organization custom properties.

Allowed characters

사용자 지정 속성 이름 및 값은 특정 문자만 포함할 수 있습니다.

  • 이름: a-z, A-Z, 0-9, _, -, $, #.
  • 값: "를 제외한 인쇄 가능한 모든 ASCII 문자.

Adding custom properties

You can add custom properties to your enterprise and set values for those properties for organizations in your enterprise.

  1. GitHub Enterprise Server의 오른쪽 위 모서리에서 프로필 사진과 Enterprise settings를 차례로 클릭합니다.

  2. 엔터프라이즈 이름에서 Organizations를 클릭합니다.

    엔터프라이즈의 스크린샷 "Organizations" 탭은 주황색 윤곽선으로 강조 표시되어 있습니다.

  3. In the left sidebar, click Custom properties.

  4. To add a new custom property, click New property in the upper right corner.

  5. In the "Name" field, type the name you'd like to use for your custom property. The name can't contain spaces, and cannot exceed 75 characters in length.

  6. Optionally, in the "Description" field, add a description for the custom property.

  7. Under "Type", select the type of property you'd like to add.

  8. Optionally, select Allow organization actors to set this property to allow organization users and apps with the organization-level "custom properties" fine-grained permission to set and update the property value for their organization.

  9. Optionally, select Require this property for all organizations and add a default value. Enabling this option indicates that you require that all organizations in your enterprise have a value for this property. Organizations that don't have an explicit value for this property will inherit the default value.

  10. Click Save property.

Setting values for organizations in your enterprise

You, and any users with the "Edit custom properties values at the organization level" permission, can set values for custom properties for organizations in your enterprise.

  1. GitHub Enterprise Server의 오른쪽 위 모서리에서 프로필 사진과 Enterprise settings를 차례로 클릭합니다.

  2. 엔터프라이즈 이름에서 Organizations를 클릭합니다.

    엔터프라이즈의 스크린샷 "Organizations" 탭은 주황색 윤곽선으로 강조 표시되어 있습니다.

  3. In the left sidebar, click Custom properties.

  4. Click the "Set values" tab.

  5. Select one or more organizations from the list and click Edit properties.

  6. In the modal dialog that appears, select a value for each property you'd like to set for the selected organizations.

  7. Click Save changes.