커스텀 필드

요약

커스텀 필드는 특정 계획 요구사항에 맞게 이슈 및 에픽과 같은 워크 아이템에 특수 정보를 추가합니다. 커스텀 필드는 팀이 전체 워크플로우에서 정보를 기록하고 보고하는 방식을 표준화하는 데 도움이 됩니다. 최상위 그룹에 커스텀 필드를 구성하여 해당 그룹, 하위 그룹 및 프로젝트의 워크 아이템에서 사용할 수 있도록 합니다.

히스토리

GitLab 17.11에서 custom_fields_feature라는 기능 플래그와 함께 도입.
GitLab 18.0에서 일반 공개. 기능 플래그 custom_fields_feature 제거됨.

커스텀 필드는 특정 계획 요구사항에 맞게 이슈 및 에픽과 같은 워크 아이템에 특수 정보를 추가합니다. 비즈니스 가치, 위험 평가, 우선순위 순위 또는 팀 속성과 같은 데이터 포인트를 추적하기 위해 그룹에 커스텀 필드를 구성합니다. 이러한 필드는 그룹, 하위 그룹 및 프로젝트의 모든 워크 아이템에 표시됩니다.

커스텀 필드는 팀이 전체 워크플로우에서 정보를 기록하고 보고하는 방식을 표준화하는 데 도움이 됩니다. 이 표준화는 프로젝트 전반에 걸쳐 일관성을 만들고 더 강력한 필터링 및 보고 기능을 지원합니다. 다양한 데이터 요구사항 및 계획 시나리오를 수용하기 위해 다양한 필드 유형 중에서 선택합니다:

단일 선택
다중 선택
숫자
텍스트

그룹에 대한 커스텀 필드 구성#

최상위 그룹에 커스텀 필드를 구성하여 해당 그룹, 하위 그룹 및 프로젝트의 워크 아이템에서 사용할 수 있도록 합니다.

커스텀 필드 만들기#

팀이 추적해야 하는 특정 정보를 캡처하기 위한 커스텀 필드를 만듭니다. 각 필드를 하나 이상의 워크 아이템 유형에 맞게 구성하여 조직의 요구사항에 맞는 워크플로우를 만들 수 있습니다.

다음 제한 사항을 염두에 두세요:

최상위 그룹은 최대 50개의 활성 커스텀 필드를 가질 수 있습니다.
워크 아이템 유형에는 최대 10개의 커스텀 필드가 할당될 수 있습니다.

사전 요구사항:

그룹에 대한 Maintainer 또는 Owner 권한이 있어야 합니다.

커스텀 필드를 만들려면:

상단 바에서 검색 또는 이동을 선택하고 그룹을 찾습니다. 이 그룹은 최상위 레벨이어야 합니다.
설정 > 워크 아이템을 선택합니다.
필드 만들기를 선택합니다.
필드를 작성합니다:
- 유형에서 필드의 유형을 선택합니다:
  - 단일 선택
  - 다중 선택
  - 숫자
  - 텍스트 필드
  필드 유형은 필드를 만든 후에 변경할 수 없습니다.
- 사용 위치에서 이 필드를 사용할 수 있도록 할 워크 아이템 유형을 선택합니다.
- 옵션(단일 선택 및 다중 선택 필드에서)에서 가능한 선택 옵션을 입력합니다. 단일 선택 또는 다중 선택 필드는 최대 50개의 선택 옵션을 가질 수 있습니다.
  - 각 옵션 왼쪽에 있는 그립 아이콘 ([grip])을 드래그하여 옵션 순서를 변경합니다.
  - 여러 옵션을 한 번에 추가하려면 입력란을 선택하고 줄당 하나씩 항목 목록을 붙여넣습니다.
저장을 선택합니다.

커스텀 필드 편집#

조직의 변화하는 요구사항을 반영하기 위해 기존 커스텀 필드를 편집합니다. 기존 데이터를 잃지 않고 필드의 이름, 적용되는 워크 아이템 유형, 사용 가능한 옵션을 수정할 수 있습니다.

사전 요구사항:

그룹에 대한 Maintainer 또는 Owner 권한이 있어야 합니다.

커스텀 필드를 편집하려면:

상단 바에서 검색 또는 이동을 선택하고 그룹을 찾습니다. 이 그룹은 최상위 레벨이어야 합니다.
설정 > 워크 아이템을 선택합니다.
편집하려는 필드 옆에서 <필드 이름> 편집 (✏️)을 선택합니다.
필드를 변경합니다.
업데이트를 선택합니다.

커스텀 필드 아카이브#

더 이상 필요하지 않은 커스텀 필드를 아카이브하면서 기록 데이터를 보존합니다. 아카이브하면 해당 필드를 가지고 있던 워크 아이템에서 필드가 제거됩니다.

사전 요구사항:

그룹에 대한 Maintainer 또는 Owner 권한이 있어야 합니다.

커스텀 필드를 아카이브하려면:

상단 바에서 검색 또는 이동을 선택하고 그룹을 찾습니다. 이 그룹은 최상위 레벨이어야 합니다.
설정 > 워크 아이템을 선택합니다.
아카이브하려는 필드 옆에서 <필드 이름> 아카이브 ([archive])를 선택합니다.

커스텀 필드 아카이브 해제#

다시 사용해야 할 때 이전에 아카이브된 커스텀 필드를 복원합니다. 이 필드에 대한 값이 설정된 워크 아이템은 필드가 아카이브되기 전과 동일한 값을 유지합니다.

사전 요구사항:

그룹에 대한 Maintainer 또는 Owner 권한이 있어야 합니다.

커스텀 필드를 아카이브 해제하려면:

상단 바에서 검색 또는 이동을 선택하고 그룹을 찾습니다. 이 그룹은 최상위 레벨이어야 합니다.
설정 > 워크 아이템을 선택합니다.
아카이브됨 탭을 선택하여 아카이브된 필드를 나열합니다.
아카이브 해제하려는 필드 옆에서 <필드 이름> 아카이브 해제 ([redo])를 선택합니다.

워크 아이템에 커스텀 필드 값 설정#

그룹에 대해 구성된 커스텀 필드를 사용하여 워크 아이템에 관련 정보를 추가합니다.

사전 요구사항:

워크 아이템의 프로젝트 또는 그룹에 대한 Planner, Reporter, Developer, Maintainer 또는 Owner 권한이 있어야 합니다.
Guest 권한이 있는 경우 워크 아이템을 만들 때만 커스텀 필드를 설정할 수 있습니다.

워크 아이템으로 이동합니다.
오른쪽 사이드바에서 편집할 커스텀 필드의 섹션을 찾은 다음 편집을 선택합니다.
원하는 값을 입력하거나 선택합니다.
- 텍스트 필드 값은 최대 1024자를 가질 수 있습니다.
필드 외부의 아무 곳이나 선택합니다.

필드 유형 선택 가이드#

커스텀 필드를 만들 때 추적하려는 데이터 종류에 맞는 필드 유형을 선택합니다. 올바른 필드 유형은 데이터 품질을 향상시키고 보고를 더 효과적으로 만듭니다.

단일 선택 필드#

다음과 같은 경우 단일 선택 필드를 사용합니다:

사용자가 미리 정의된 목록에서 정확히 하나의 옵션을 선택해야 할 때.
옵션이 상호 배타적일 때.
일관성을 강제하고 자유 형식 입력을 방지하려는 경우.

단일 선택 필드는 다음에 적합합니다:

우선순위 표시기(예: High, Medium, Low)
카테고리 할당
팀 할당
승인 상태
우선순위 수준

다중 선택 필드#

다음과 같은 경우 다중 선택 필드를 사용합니다:

여러 값이 동시에 적용될 수 있을 때.
중복되는 속성을 추적해야 할 때.
항목이 여러 카테고리에 속할 수 있을 때.

다중 선택 필드는 다음에 적합합니다:

태그 또는 레이블
필요한 기술
영향을 받는 컴포넌트
이해관계자 그룹
기능 역량

숫자 필드#

다음과 같은 경우 숫자 필드를 사용합니다:

정량적 데이터를 수집해야 할 때.
계산 또는 집계를 수행하려는 경우.
정보를 숫자로 정렬할 수 있어야 할 때.

숫자 필드는 다음에 적합합니다:

비용 추정
시간 추정
비즈니스 가치 점수
순위 또는 우선순위 점수
완료율

텍스트 필드#

다음과 같은 경우 텍스트 필드를 사용합니다:

미리 정의된 카테고리에 맞지 않는 고유한 정보를 캡처해야 할 때.
데이터가 매우 가변적일 때.
컨텍스트나 세부 정보를 제공해야 할 때.

텍스트 필드는 다음에 적합합니다:

추가 컨텍스트
외부 참조 ID
연락처 정보
간략한 메모 또는 댓글
URL 또는 링크

커스텀 필드 명명 규칙#

커스텀 필드의 일관된 명명 규칙은 이해하고 사용하기 쉽게 만듭니다. 좋은 필드 이름은 채택과 데이터 품질을 향상시킵니다.

일반 지침#

이름을 간결하지만 설명적으로 유지합니다.
조직이 이해하는 명확하고 구체적인 언어를 사용합니다.
대소문자를 일관되게 유지합니다(제목 대/소문자 권장).
널리 이해되는 경우를 제외하고 약어를 사용하지 않습니다.
해당하는 경우 측정 단위를 포함합니다.

단일 선택 및 다중 선택 필드 명명#

카테고리 이름 다음에 설명자를 붙입니다. 예를 들어:

Risk 대신 Risk Level
Segment 대신 Customer Segment
Phase 대신 Development Phase
Status 대신 Approval Status

숫자 필드 명명#

필드 이름에 측정 단위를 포함합니다. 예를 들어:

Points 대신 Effort Points
Budget 대신 Budget Estimate ($)
Time 대신 Implementation Time (days)
Value 대신 Business Value Score

텍스트 필드 명명#

입력해야 하는 정보를 명확하게 나타냅니다. 예를 들어:

Reference 대신 External Reference ID
Notes 대신 Implementation Notes
Source 대신 Requirements Source

팀별 접두사#

여러 팀이 동일한 GitLab 인스턴스를 사용하는 경우 혼란을 방지하기 위해 팀 접두사를 추가하는 것을 고려합니다:

DEV: Sprint Priority
QA: Test Environment
UX: Design Status
PM: Market Segment

이 접근 방식은 팀이 자신의 작업과 관련된 필드를 빠르게 식별하는 데 도움이 됩니다.

커스텀 필드

Tier: Premium, Ultimate
Offering: GitLab.com, GitLab Self-Managed

원문 보기

번역일: 2026-05-22

요약

히스토리

GitLab 17.11에서 custom_fields_feature라는 기능 플래그와 함께 도입.
GitLab 18.0에서 일반 공개. 기능 플래그 custom_fields_feature 제거됨.

단일 선택
다중 선택
숫자
텍스트

그룹에 대한 커스텀 필드 구성#

최상위 그룹에 커스텀 필드를 구성하여 해당 그룹, 하위 그룹 및 프로젝트의 워크 아이템에서 사용할 수 있도록 합니다.

커스텀 필드 만들기#

다음 제한 사항을 염두에 두세요:

최상위 그룹은 최대 50개의 활성 커스텀 필드를 가질 수 있습니다.
워크 아이템 유형에는 최대 10개의 커스텀 필드가 할당될 수 있습니다.

사전 요구사항:

그룹에 대한 Maintainer 또는 Owner 권한이 있어야 합니다.

커스텀 필드를 만들려면:

상단 바에서 검색 또는 이동을 선택하고 그룹을 찾습니다. 이 그룹은 최상위 레벨이어야 합니다.
설정 > 워크 아이템을 선택합니다.
필드 만들기를 선택합니다.
필드를 작성합니다:
- 유형에서 필드의 유형을 선택합니다:
  - 단일 선택
  - 다중 선택
  - 숫자
  - 텍스트 필드
  필드 유형은 필드를 만든 후에 변경할 수 없습니다.
- 사용 위치에서 이 필드를 사용할 수 있도록 할 워크 아이템 유형을 선택합니다.
- 옵션(단일 선택 및 다중 선택 필드에서)에서 가능한 선택 옵션을 입력합니다. 단일 선택 또는 다중 선택 필드는 최대 50개의 선택 옵션을 가질 수 있습니다.
  - 각 옵션 왼쪽에 있는 그립 아이콘 ([grip])을 드래그하여 옵션 순서를 변경합니다.
  - 여러 옵션을 한 번에 추가하려면 입력란을 선택하고 줄당 하나씩 항목 목록을 붙여넣습니다.
저장을 선택합니다.

커스텀 필드 편집#

사전 요구사항:

그룹에 대한 Maintainer 또는 Owner 권한이 있어야 합니다.

커스텀 필드를 편집하려면:

상단 바에서 검색 또는 이동을 선택하고 그룹을 찾습니다. 이 그룹은 최상위 레벨이어야 합니다.
설정 > 워크 아이템을 선택합니다.
편집하려는 필드 옆에서 <필드 이름> 편집 (✏️)을 선택합니다.
필드를 변경합니다.
업데이트를 선택합니다.

커스텀 필드 아카이브#

사전 요구사항:

그룹에 대한 Maintainer 또는 Owner 권한이 있어야 합니다.

커스텀 필드를 아카이브하려면:

상단 바에서 검색 또는 이동을 선택하고 그룹을 찾습니다. 이 그룹은 최상위 레벨이어야 합니다.
설정 > 워크 아이템을 선택합니다.
아카이브하려는 필드 옆에서 <필드 이름> 아카이브 ([archive])를 선택합니다.

커스텀 필드 아카이브 해제#

사전 요구사항:

그룹에 대한 Maintainer 또는 Owner 권한이 있어야 합니다.

커스텀 필드를 아카이브 해제하려면:

상단 바에서 검색 또는 이동을 선택하고 그룹을 찾습니다. 이 그룹은 최상위 레벨이어야 합니다.
설정 > 워크 아이템을 선택합니다.
아카이브됨 탭을 선택하여 아카이브된 필드를 나열합니다.
아카이브 해제하려는 필드 옆에서 <필드 이름> 아카이브 해제 ([redo])를 선택합니다.

워크 아이템에 커스텀 필드 값 설정#

그룹에 대해 구성된 커스텀 필드를 사용하여 워크 아이템에 관련 정보를 추가합니다.

사전 요구사항:

워크 아이템의 프로젝트 또는 그룹에 대한 Planner, Reporter, Developer, Maintainer 또는 Owner 권한이 있어야 합니다.
Guest 권한이 있는 경우 워크 아이템을 만들 때만 커스텀 필드를 설정할 수 있습니다.

워크 아이템으로 이동합니다.
오른쪽 사이드바에서 편집할 커스텀 필드의 섹션을 찾은 다음 편집을 선택합니다.
원하는 값을 입력하거나 선택합니다.
- 텍스트 필드 값은 최대 1024자를 가질 수 있습니다.
필드 외부의 아무 곳이나 선택합니다.

필드 유형 선택 가이드#

단일 선택 필드#

다음과 같은 경우 단일 선택 필드를 사용합니다:

사용자가 미리 정의된 목록에서 정확히 하나의 옵션을 선택해야 할 때.
옵션이 상호 배타적일 때.
일관성을 강제하고 자유 형식 입력을 방지하려는 경우.

단일 선택 필드는 다음에 적합합니다:

우선순위 표시기(예: High, Medium, Low)
카테고리 할당
팀 할당
승인 상태
우선순위 수준

다중 선택 필드#

다음과 같은 경우 다중 선택 필드를 사용합니다:

여러 값이 동시에 적용될 수 있을 때.
중복되는 속성을 추적해야 할 때.
항목이 여러 카테고리에 속할 수 있을 때.

다중 선택 필드는 다음에 적합합니다:

태그 또는 레이블
필요한 기술
영향을 받는 컴포넌트
이해관계자 그룹
기능 역량

숫자 필드#

다음과 같은 경우 숫자 필드를 사용합니다:

정량적 데이터를 수집해야 할 때.
계산 또는 집계를 수행하려는 경우.
정보를 숫자로 정렬할 수 있어야 할 때.

숫자 필드는 다음에 적합합니다:

비용 추정
시간 추정
비즈니스 가치 점수
순위 또는 우선순위 점수
완료율

텍스트 필드#

다음과 같은 경우 텍스트 필드를 사용합니다:

미리 정의된 카테고리에 맞지 않는 고유한 정보를 캡처해야 할 때.
데이터가 매우 가변적일 때.
컨텍스트나 세부 정보를 제공해야 할 때.

텍스트 필드는 다음에 적합합니다:

추가 컨텍스트
외부 참조 ID
연락처 정보
간략한 메모 또는 댓글
URL 또는 링크

커스텀 필드 명명 규칙#

커스텀 필드의 일관된 명명 규칙은 이해하고 사용하기 쉽게 만듭니다. 좋은 필드 이름은 채택과 데이터 품질을 향상시킵니다.

일반 지침#

이름을 간결하지만 설명적으로 유지합니다.
조직이 이해하는 명확하고 구체적인 언어를 사용합니다.
대소문자를 일관되게 유지합니다(제목 대/소문자 권장).
널리 이해되는 경우를 제외하고 약어를 사용하지 않습니다.
해당하는 경우 측정 단위를 포함합니다.

단일 선택 및 다중 선택 필드 명명#

카테고리 이름 다음에 설명자를 붙입니다. 예를 들어:

Risk 대신 Risk Level
Segment 대신 Customer Segment
Phase 대신 Development Phase
Status 대신 Approval Status

숫자 필드 명명#

필드 이름에 측정 단위를 포함합니다. 예를 들어:

Points 대신 Effort Points
Budget 대신 Budget Estimate ($)
Time 대신 Implementation Time (days)
Value 대신 Business Value Score

텍스트 필드 명명#

입력해야 하는 정보를 명확하게 나타냅니다. 예를 들어:

Reference 대신 External Reference ID
Notes 대신 Implementation Notes
Source 대신 Requirements Source

팀별 접두사#

여러 팀이 동일한 GitLab 인스턴스를 사용하는 경우 혼란을 방지하기 위해 팀 접두사를 추가하는 것을 고려합니다:

DEV: Sprint Priority
QA: Test Environment
UX: Design Status
PM: Market Segment

이 접근 방식은 팀이 자신의 작업과 관련된 필드를 빠르게 식별하는 데 도움이 됩니다.