이슈 생성

요약

이슈를 생성하면 이슈의 필드를 입력하라는 안내가 표시됩니다. GitLab에서는 여러 방법으로 이슈를 생성할 수 있습니다: 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다. Type 드롭다운 목록에서 Issue가 선택되어 있지 않다면 선택합니다.

이슈를 생성하면 이슈의 필드를 입력하라는 안내가 표시됩니다. 이슈에 지정할 값을 이미 알고 있다면 퀵 액션으로 입력할 수 있습니다.

GitLab에서는 여러 방법으로 이슈를 생성할 수 있습니다:

프로젝트에서
그룹에서
다른 이슈 또는 인시던트에서
이슈 보드에서
이메일 전송으로
사전 입력된 값이 있는 URL 사용
Service Desk 사용

프로젝트에서#

필수 조건:

프로젝트의 Guest, Planner, Reporter, Developer, Maintainer 또는 Owner 권한이 있어야 합니다.

이슈를 생성하려면:

상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
다음 중 하나를 수행합니다:
- 왼쪽 사이드바에서 Plan > Work items를 선택한 다음 오른쪽 위에서 New item을 선택합니다.
- 오른쪽 위에서 더하기 기호(+)를 선택한 다음 In this project에서 New work item을 선택합니다.
Type 드롭다운 목록에서 Issue가 선택되어 있지 않다면 선택합니다.
필드를 입력합니다.
Create issue를 선택합니다.

새로 생성된 이슈가 열립니다.

그룹에서#

이슈는 프로젝트에 속하지만, 그룹에 있을 때는 그룹 내 프로젝트에 속한 이슈에 접근하고 이슈를 생성할 수 있습니다.

필수 조건:

그룹 내 프로젝트의 Guest, Planner, Reporter, Developer, Maintainer 또는 Owner 권한이 있어야 합니다.

그룹에서 이슈를 생성하려면:

상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
왼쪽 사이드바에서 Plan > Work items를 선택합니다.
오른쪽 위에서 Select project to create issue를 선택합니다.
이슈를 생성할 프로젝트를 선택합니다. 이제 버튼에 선택한 프로젝트가 반영됩니다.
**New issue in <project name>**을 선택합니다.
필드를 입력합니다.
Create issue를 선택합니다.

새로 생성된 이슈가 열립니다.

가장 최근에 선택한 프로젝트가 다음 방문 시 기본값이 됩니다. 주로 같은 프로젝트에 이슈를 생성한다면 시간을 크게 줄일 수 있습니다.

다른 이슈 또는 인시던트에서#

기존 이슈에서 새 이슈를 생성할 수 있습니다. 그런 다음 두 이슈를 연관된 이슈로 표시할 수 있습니다.

필수 조건:

프로젝트의 Guest, Planner, Reporter, Developer, Maintainer 또는 Owner 권한이 있어야 합니다.

다른 이슈에서 이슈를 생성하려면:

기존 이슈에서 Issue actions(⋮)를 선택합니다.
New related issue를 선택합니다.
필드를 입력합니다. 새 이슈 양식에는 Relate to issue #123 체크박스가 있으며, 여기서 123은 원본 이슈의 ID 입니다. 이 체크박스를 선택한 상태로 두면 두 이슈가 연결됩니다.
Create issue를 선택합니다.

새로 생성된 이슈가 열립니다.

이슈 보드에서#

이슈 보드에서 새 이슈를 생성할 수 있습니다.

필수 조건:

프로젝트의 Guest, Planner, Reporter, Developer, Maintainer 또는 Owner 권한이 있어야 합니다.

프로젝트 이슈 보드에서 이슈를 생성하려면:

상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
왼쪽 사이드바에서 Plan > Issue boards를 선택합니다.
보드 목록 상단에서 Create new issue([plus-square])를 선택합니다.
이슈 제목을 입력합니다.
Create issue를 선택합니다.

그룹 이슈 보드에서 이슈를 생성하려면:

상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
왼쪽 사이드바에서 Plan > Issue boards를 선택합니다.
보드 목록 상단에서 Create new issue([plus-square])를 선택합니다.
이슈 제목을 입력합니다.
Projects에서 이슈가 속할 그룹 내 프로젝트를 선택합니다.
Create issue를 선택합니다.

이슈가 생성되어 보드 목록에 표시됩니다. 이슈는 그 목록의 속성을 공유하므로, 예를 들어 목록이 Frontend 레이블로 범위가 지정되어 있다면 새 이슈에도 이 레이블이 붙습니다.

이메일 전송으로#

히스토리

GitLab 18.6에서 Email a new issue to this project가 Email issue to this project로 이름이 변경되었습니다.

프로젝트의 Issues 페이지에서 이메일을 보내 프로젝트에 이슈를 생성할 수 있습니다.

필수 조건:

GitLab 인스턴스에 이메일 하위 주소 지정 또는 캐치올 메일박스로 수신 이메일이 구성되어 있어야 합니다.
이슈 목록에 이슈가 하나 이상 있어야 합니다.
프로젝트의 Guest, Planner, Reporter, Developer, Maintainer 또는 Owner 권한이 있어야 합니다.

프로젝트로 이슈를 이메일로 보내려면:

상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
왼쪽 사이드바에서 Plan > Work items를 선택합니다.
오른쪽 위에서 More actions(⋮)를 선택한 다음 Email work item to this project를 선택합니다.
이메일 주소를 복사하려면 Copy([copy-to-clipboard])를 선택합니다.
이메일 클라이언트에서 이 주소로 이메일을 보냅니다. 제목이 새 이슈의 제목이 되고, 이메일 본문이 설명이 됩니다. Markdown과 퀵 액션을 사용할 수 있습니다.

작성자가 본인으로 지정된 새 이슈가 생성됩니다. 이 주소를 이메일 클라이언트의 연락처로 저장해 다시 사용할 수 있습니다.

Warning

표시되는 이메일 주소는 본인 전용으로 생성된 비공개 이메일 주소입니다. 이 주소를 아는 사람은 누구나 본인 이름으로 이슈나 머지 리퀘스트를 생성할 수 있으므로 외부에 공개하지 않습니다. 이 비공개 이메일 주소가 유출된 것으로 의심되면 즉시 토큰을 재설정합니다.

이메일 주소를 재설정하려면:

Issues 페이지에서 Email issue to this project를 선택합니다.
reset this token을 선택합니다.

사전 입력된 값이 있는 URL 사용#

필드가 미리 채워진 새 이슈 페이지로 바로 연결하려면 URL의 쿼리 문자열 파라미터를 사용합니다. 외부 HTML 페이지에 URL을 삽입해 특정 필드가 미리 채워진 이슈를 생성할 수 있습니다.

값이 미리 채워진 이슈를 생성하는 URL은 다음을 조합해 만듭니다:

프로젝트나 그룹의 Issues 페이지 URL 뒤에 /new를 붙입니다. 예를 들면 https://gitlab.com/gitlab-org/gitlab/-/work_items/new 입니다.
파라미터 나열을 시작하는 ?.
URL 파라미터 뒤에 =와 값을 붙입니다. 예를 들면 issue[title]=My%20test%20issue 입니다.
선택 사항. 파라미터를 더 연결하는 &.

필드	URL 매개변수	참고
제목	`issue[title]`	URL 인코딩되어야 합니다.
이슈 유형	`issue[issue_type]`	`incident` 또는 `issue` 중 하나.
설명 템플릿 (이슈, 인시던트, 머지 리퀘스트)	`issuable_template`	URL 인코딩되어야 합니다.
설명 템플릿 (작업, OKR, 이슈, 에픽)	`description_template`	URL 인코딩되어야 합니다. GitLab 17.9에서 도입되었습니다.
설명	`issue[description]`	URL 인코딩되어야 합니다. `issuable_template` 또는 기본 이슈 템플릿과 함께 사용하면 `issue[description]` 값이 템플릿을 덮어씁니다.
기밀	`issue[confidential]`	`true` 이면 이슈가 기밀로 표시됩니다.
다음과 연관…	`add_related_issue`	숫자 이슈 ID. 값이 있으면 이슈 양식에 새 이슈를 지정된 기존 이슈에 선택적으로 연결하는 Relate to 체크박스가 표시됩니다.

GitLab 17.8 이상에서는 이슈 템플릿을 선택하면 사용한 템플릿이 URL에 표시되도록 URL 이 바뀝니다.

다음 예제를 참고해 필드가 미리 채워진 새 이슈 URL을 구성합니다. GitLab 프로젝트에 이슈를 생성하려면:

제목과 설명이 미리 채워진 경우:

https://gitlab.com/gitlab-org/gitlab/-/work_items/new?issue[title]=Whoa%2C%20we%27re%20half-way%20there&issue[description]=Whoa%2C%20livin%27%20in%20a%20URL

제목과 설명 템플릿이 미리 채워진 경우:

https://gitlab.com/gitlab-org/gitlab/-/work_items/new?issue[title]=Validate%20new%20concept&issuable_template=Feature%20Proposal%20-%20basic

제목과 설명이 미리 채워지고 기밀로 표시된 경우:

https://gitlab.com/gitlab-org/gitlab/-/work_items/new?issue[title]=Validate%20new%20concept&issue[description]=Research%20idea&issue[confidential]=true

Service Desk 사용#

이메일 지원을 제공하려면 프로젝트에서 Service Desk를 켭니다.

이렇게 하면 고객이 새 이메일을 보낼 때 적절한 프로젝트에 새 이슈가 생성되고 그곳에서 후속 대응을 할 수 있습니다.

새 이슈 양식의 필드#

새 이슈를 생성할 때 다음 필드를 입력할 수 있습니다:

Title: 제한적인 서식 지원
Project: 현재 프로젝트가 기본값입니다
Type: 이슈(기본값) 또는 인시던트
설명 템플릿: Description 텍스트 상자의 내용을 덮어씁니다
Description: Markdown과 퀵 액션을 사용할 수 있습니다
이슈를 기밀로 지정하는 체크박스
담당자
가중치
상위 항목
날짜
마일스톤
레이블
이터레이션
상태 지표
연락처

이슈 생성

GitLab v19.5

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

원문 보기

번역일: 2026-09-18

요약

이슈를 생성하면 이슈의 필드를 입력하라는 안내가 표시됩니다. 이슈에 지정할 값을 이미 알고 있다면 퀵 액션으로 입력할 수 있습니다.

GitLab에서는 여러 방법으로 이슈를 생성할 수 있습니다:

프로젝트에서
그룹에서
다른 이슈 또는 인시던트에서
이슈 보드에서
이메일 전송으로
사전 입력된 값이 있는 URL 사용
Service Desk 사용

프로젝트에서#

필수 조건:

프로젝트의 Guest, Planner, Reporter, Developer, Maintainer 또는 Owner 권한이 있어야 합니다.

이슈를 생성하려면:

상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
다음 중 하나를 수행합니다:
- 왼쪽 사이드바에서 Plan > Work items를 선택한 다음 오른쪽 위에서 New item을 선택합니다.
- 오른쪽 위에서 더하기 기호(+)를 선택한 다음 In this project에서 New work item을 선택합니다.
Type 드롭다운 목록에서 Issue가 선택되어 있지 않다면 선택합니다.
필드를 입력합니다.
Create issue를 선택합니다.

새로 생성된 이슈가 열립니다.

그룹에서#

이슈는 프로젝트에 속하지만, 그룹에 있을 때는 그룹 내 프로젝트에 속한 이슈에 접근하고 이슈를 생성할 수 있습니다.

필수 조건:

그룹 내 프로젝트의 Guest, Planner, Reporter, Developer, Maintainer 또는 Owner 권한이 있어야 합니다.

그룹에서 이슈를 생성하려면:

상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
왼쪽 사이드바에서 Plan > Work items를 선택합니다.
오른쪽 위에서 Select project to create issue를 선택합니다.
이슈를 생성할 프로젝트를 선택합니다. 이제 버튼에 선택한 프로젝트가 반영됩니다.
**New issue in <project name>**을 선택합니다.
필드를 입력합니다.
Create issue를 선택합니다.

새로 생성된 이슈가 열립니다.

가장 최근에 선택한 프로젝트가 다음 방문 시 기본값이 됩니다. 주로 같은 프로젝트에 이슈를 생성한다면 시간을 크게 줄일 수 있습니다.

다른 이슈 또는 인시던트에서#

기존 이슈에서 새 이슈를 생성할 수 있습니다. 그런 다음 두 이슈를 연관된 이슈로 표시할 수 있습니다.

필수 조건:

프로젝트의 Guest, Planner, Reporter, Developer, Maintainer 또는 Owner 권한이 있어야 합니다.

다른 이슈에서 이슈를 생성하려면:

기존 이슈에서 Issue actions(⋮)를 선택합니다.
New related issue를 선택합니다.
필드를 입력합니다. 새 이슈 양식에는 Relate to issue #123 체크박스가 있으며, 여기서 123은 원본 이슈의 ID 입니다. 이 체크박스를 선택한 상태로 두면 두 이슈가 연결됩니다.
Create issue를 선택합니다.

새로 생성된 이슈가 열립니다.

이슈 보드에서#

이슈 보드에서 새 이슈를 생성할 수 있습니다.

필수 조건:

프로젝트의 Guest, Planner, Reporter, Developer, Maintainer 또는 Owner 권한이 있어야 합니다.

프로젝트 이슈 보드에서 이슈를 생성하려면:

상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
왼쪽 사이드바에서 Plan > Issue boards를 선택합니다.
보드 목록 상단에서 Create new issue([plus-square])를 선택합니다.
이슈 제목을 입력합니다.
Create issue를 선택합니다.

그룹 이슈 보드에서 이슈를 생성하려면:

상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
왼쪽 사이드바에서 Plan > Issue boards를 선택합니다.
보드 목록 상단에서 Create new issue([plus-square])를 선택합니다.
이슈 제목을 입력합니다.
Projects에서 이슈가 속할 그룹 내 프로젝트를 선택합니다.
Create issue를 선택합니다.

이메일 전송으로#

히스토리

GitLab 18.6에서 Email a new issue to this project가 Email issue to this project로 이름이 변경되었습니다.

프로젝트의 Issues 페이지에서 이메일을 보내 프로젝트에 이슈를 생성할 수 있습니다.

필수 조건:

GitLab 인스턴스에 이메일 하위 주소 지정 또는 캐치올 메일박스로 수신 이메일이 구성되어 있어야 합니다.
이슈 목록에 이슈가 하나 이상 있어야 합니다.
프로젝트의 Guest, Planner, Reporter, Developer, Maintainer 또는 Owner 권한이 있어야 합니다.

프로젝트로 이슈를 이메일로 보내려면:

상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
왼쪽 사이드바에서 Plan > Work items를 선택합니다.
오른쪽 위에서 More actions(⋮)를 선택한 다음 Email work item to this project를 선택합니다.
이메일 주소를 복사하려면 Copy([copy-to-clipboard])를 선택합니다.
이메일 클라이언트에서 이 주소로 이메일을 보냅니다. 제목이 새 이슈의 제목이 되고, 이메일 본문이 설명이 됩니다. Markdown과 퀵 액션을 사용할 수 있습니다.

작성자가 본인으로 지정된 새 이슈가 생성됩니다. 이 주소를 이메일 클라이언트의 연락처로 저장해 다시 사용할 수 있습니다.

Warning

이메일 주소를 재설정하려면:

Issues 페이지에서 Email issue to this project를 선택합니다.
reset this token을 선택합니다.

사전 입력된 값이 있는 URL 사용#

값이 미리 채워진 이슈를 생성하는 URL은 다음을 조합해 만듭니다:

프로젝트나 그룹의 Issues 페이지 URL 뒤에 /new를 붙입니다. 예를 들면 https://gitlab.com/gitlab-org/gitlab/-/work_items/new 입니다.
파라미터 나열을 시작하는 ?.
URL 파라미터 뒤에 =와 값을 붙입니다. 예를 들면 issue[title]=My%20test%20issue 입니다.
선택 사항. 파라미터를 더 연결하는 &.

필드	URL 매개변수	참고
제목	`issue[title]`	URL 인코딩되어야 합니다.
이슈 유형	`issue[issue_type]`	`incident` 또는 `issue` 중 하나.
설명 템플릿 (이슈, 인시던트, 머지 리퀘스트)	`issuable_template`	URL 인코딩되어야 합니다.
설명 템플릿 (작업, OKR, 이슈, 에픽)	`description_template`	URL 인코딩되어야 합니다. GitLab 17.9에서 도입되었습니다.
설명	`issue[description]`	URL 인코딩되어야 합니다. `issuable_template` 또는 기본 이슈 템플릿과 함께 사용하면 `issue[description]` 값이 템플릿을 덮어씁니다.
기밀	`issue[confidential]`	`true` 이면 이슈가 기밀로 표시됩니다.
다음과 연관…	`add_related_issue`	숫자 이슈 ID. 값이 있으면 이슈 양식에 새 이슈를 지정된 기존 이슈에 선택적으로 연결하는 Relate to 체크박스가 표시됩니다.

GitLab 17.8 이상에서는 이슈 템플릿을 선택하면 사용한 템플릿이 URL에 표시되도록 URL 이 바뀝니다.

다음 예제를 참고해 필드가 미리 채워진 새 이슈 URL을 구성합니다. GitLab 프로젝트에 이슈를 생성하려면:

제목과 설명이 미리 채워진 경우:

https://gitlab.com/gitlab-org/gitlab/-/work_items/new?issue[title]=Whoa%2C%20we%27re%20half-way%20there&issue[description]=Whoa%2C%20livin%27%20in%20a%20URL

제목과 설명 템플릿이 미리 채워진 경우:

https://gitlab.com/gitlab-org/gitlab/-/work_items/new?issue[title]=Validate%20new%20concept&issuable_template=Feature%20Proposal%20-%20basic

제목과 설명이 미리 채워지고 기밀로 표시된 경우:

https://gitlab.com/gitlab-org/gitlab/-/work_items/new?issue[title]=Validate%20new%20concept&issue[description]=Research%20idea&issue[confidential]=true

Service Desk 사용#

이메일 지원을 제공하려면 프로젝트에서 Service Desk를 켭니다.

이렇게 하면 고객이 새 이메일을 보낼 때 적절한 프로젝트에 새 이슈가 생성되고 그곳에서 후속 대응을 할 수 있습니다.

새 이슈 양식의 필드#

새 이슈를 생성할 때 다음 필드를 입력할 수 있습니다:

Title: 제한적인 서식 지원
Project: 현재 프로젝트가 기본값입니다
Type: 이슈(기본값) 또는 인시던트
설명 템플릿: Description 텍스트 상자의 내용을 덮어씁니다
Description: Markdown과 퀵 액션을 사용할 수 있습니다
이슈를 기밀로 지정하는 체크박스
담당자
가중치
상위 항목
날짜
마일스톤
레이블
이터레이션
상태 지표
연락처