---
name: "gt-repo-edit"
section: "1"
platform: "linux"
package: "gitea-cli"
version: "1.0.0-1"
release: "Arch Linux 2026-11-07"
platforms: ["linux"]
url: "https://carta.tech/man/gt-repo-edit"
---

# gt-repo-edit(1)

Edit repository settings

## NAME

gt-repo-edit - Edit repository settings

## SYNOPSIS

**gt repo edit \[\<repository\>\] \[flags\]**

## DESCRIPTION

Edit the settings of a repository. Only the flags you pass change; on/off settings such as --enable-wiki take =false to turn them off.

### ARGUMENTS

```
A repository can be supplied as NAME (one of yours), OWNER/NAME, HOST/OWNER/NAME or a URL.
Without an argument, the repository of the current Git clone is used.
```

### JSON FIELDS

```
actions_enabled, archived, clone_url, default_branch, description, empty,
fork, forks_count, full_name, id, mirror, mirror_interval, name,
open_issues_count, open_pr_count, original_url, parent, private, ssh_url,
stars_count, template, topics, updated_at, url, website
```

## OPTIONS

**--actions**\[=false\]\
 	Enable Actions

**--add-topic**=\[\]\
 	Add topics (repeatable or comma-separated)

**--allow-manual-merge**\[=false\]\
 	Allow marking pull requests merged outside Gitea as merged

**--allow-merge-commit**\[=false\]\
 	Allow merging pull requests with a merge commit

**--allow-rebase**\[=false\]\
 	Allow rebase merging pull requests

**--allow-squash**\[=false\]\
 	Allow squash merging pull requests

**--as-template**\[=false\]\
 	Make the repository a template

**--autodetect-manual-merge**\[=false\]\
 	Mark pull requests as merged when their commits reach the base branch outside Gitea

**--default-branch**=""\
 	Default branch; it must exist

**--default-merge-style**=""\
 	Default merge style for pull requests {merge\|rebase\|rebase-merge\|squash\|fast-forward-only}

**--delete-branch-on-merge**\[=false\]\
 	Delete head branches after merging pull requests

**-d**, **--description**=""\
 	Repository description

**--enable-issues**\[=false\]\
 	Enable issues

**--enable-projects**\[=false\]\
 	Enable projects

**--enable-pull-requests**\[=false\]\
 	Enable pull requests

**--enable-wiki**\[=false\]\
 	Enable the wiki

**-h**, **--help**\[=false\]\
 	help for edit

**--private**\[=false\]\
 	Make the repository private (=false makes it public)

**--remove-topic**=\[\]\
 	Remove topics (repeatable or comma-separated)

**--visibility**=""\
 	Repository visibility {public\|private}

**--website**=""\
 	Repository website (empty clears it)

## OPTIONS INHERITED FROM PARENT COMMANDS

**--csv**\[=""\]\
 	Output CSV with the specified comma-separated **fields**, or all fields

**--cwd**=""\
 	Working **directory** for repository discovery

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

**--host**=""\
 	Gitea instance **URL**, including any base path

**--interactive**\[=false\]\
 	Allow prompts with machine output

**-q**, **--jq**=""\
 	Filter JSON output using a jq **expression**; implies --json

**--json**\[=""\]\
 	Output JSON with the specified comma-separated **fields**, or all fields

**--no-input**\[=false\]\
 	Disable prompts and implicit editor/browser interactions

**--remote**=""\
 	Git **remote** used for repository discovery

**-R**, **--repo**=""\
 	Select a repository as **OWNER/REPO** or URL

**--sudo**=""\
 	Perform API requests as this **user** (requires an administrator account)

**--user**=""\
 	Account **name** on the selected instance

## EXAMPLE

```
# Change the description and the website
$ gt repo edit --description "Command line tool" --website https://example.com
# Make a repository private and disable its wiki
$ gt repo edit alice/project --visibility private --enable-wiki=false
# Squash pull requests by default and tag the repository
$ gt repo edit --default-merge-style squash --add-topic cli --add-topic go
# Let pull requests merged outside Gitea be marked as merged
$ gt repo edit --allow-manual-merge
```

## SEE ALSO

**[gt-repo(1)](/man/gt-repo/1.md)**