.nh
.TH "GT-ISSUE-LOCK" "1" "Nov 2026" "gitea-cli" "gitea-cli Manual"

.SH NAME
gt-issue-lock - Lock the conversation of issues


.SH SYNOPSIS
\fBgt issue lock {<number> | <url>}... [flags]\fP


.SH DESCRIPTION
Lock the conversation of issues or pull requests, so that only people with write access can
comment on them. One that is locked already is reported and keeps its reason.

.PP
Gitea does not check the reason: it offers Too heated, Off-topic, Resolved and Spam by default,
and administrators can change that.

.SS ARGUMENTS
.EX
An issue can be supplied as argument in any of the following formats:
- by number, e.g. "123" or "#123"
- by URL, e.g. "https://gitea.com/OWNER/REPO/issues/123"
- by repository and number, e.g. "OWNER/REPO#123"

Several issues must be in one repository. Next to "OWNER/REPO#123" or a URL, "124" means
OWNER/REPO#124, unless gt targets another repository otherwise, such as the clone's, --repo
or GITEA_CLI_REPO: then the command fails, and the number must be qualified.
.EE

.SS JSON FIELDS
.EX
assignees, author, body, comments, created_at, due_date, id, kind, labels,
milestone, number, ref, state, title, updated_at, url
.EE


.SH OPTIONS
\fB--dry-run\fP[=false]
	Show the write requests gt would send, without sending them

.PP
\fB-h\fP, \fB--help\fP[=false]
	help for lock

.PP
\fB-r\fP, \fB--reason\fP=""
	Reason for locking, shown on the issue, such as "Resolved"


.SH OPTIONS INHERITED FROM PARENT COMMANDS
\fB--csv\fP[=""]
	Output CSV with the specified comma-separated \fBfields\fR, or all fields

.PP
\fB--cwd\fP=""
	Working \fBdirectory\fR for repository discovery

.PP
\fB--debug\fP[=false]
	Log the method, URL, status, and duration of each HTTP request to stderr

.PP
\fB--host\fP=""
	Gitea instance \fBURL\fR, including any base path

.PP
\fB--interactive\fP[=false]
	Allow prompts with machine output

.PP
\fB-q\fP, \fB--jq\fP=""
	Filter JSON output using a jq \fBexpression\fR; implies --json

.PP
\fB--json\fP[=""]
	Output JSON with the specified comma-separated \fBfields\fR, or all fields

.PP
\fB--no-input\fP[=false]
	Disable prompts and implicit editor/browser interactions

.PP
\fB--remote\fP=""
	Git \fBremote\fR used for repository discovery

.PP
\fB-R\fP, \fB--repo\fP=""
	Select a repository as \fBOWNER/REPO\fR or URL

.PP
\fB--sudo\fP=""
	Perform API requests as this \fBuser\fR (requires an administrator account)

.PP
\fB--template\fP=""
	Format JSON output using a Go \fBtemplate\fR; implies --json (see gt help formatting)

.PP
\fB--user\fP=""
	Account \fBname\fR on the selected instance


.SH EXAMPLE
.EX
$ gt issue lock 12
$ gt issue lock 12 13 --reason "Too heated"
.EE


.SH SEE ALSO
\fBgt-issue(1)\fP