Files
docs/docs/usage/issues-prs/prefill-issues-pull-requests.md
T
Jakub VránaandJakub Vrana db9e6f9f48 docs: document pre-filling issues and pull requests from query parameters (#592)
Describe the query parameters of the new issue and pull request pages, including those added in https://github.com/go-gitea/gitea/pull/39804.

---------

Co-authored-by: Jakub Vrana <[email protected]>
Reviewed-on: https://gitea.com/gitea/docs/pulls/592
Reviewed-by: wxiaoguang <[email protected]>
Reviewed-by: bircni <[email protected]>
Co-authored-by: Jakub Vrána <[email protected]>
2026-10-17 21:56:31 +00:00

2.4 KiB

date, slug, sidebar_position
date slug sidebar_position
2026-10-17T00:00:00+00:00 prefill-issues-pull-requests 14

Pre-filling Issues and Pull Requests

Links to the pages for creating issues and pull requests can pre-fill the form with query parameters. This lets you link users from another app, a README or a project board to a form that is already categorized.

  • New issue: /{owner}/{repo}/issues/new?…
  • New pull request: /{owner}/{repo}/compare/{base}...{head}?…

For example, this link opens a new issue with a title, two labels and an assignee:

https://gitea.example.com/owner/repo/issues/new?title=Dashboard+crashes&label=kind/bug,area/dashboard&assignee=alice

Parameters

Parameter Value
title Title
body Description
label Comma-separated label IDs or names
labels Alias of label
milestone Milestone ID or name
project Comma-separated project IDs or titles
assignee Comma-separated user IDs or usernames
template File name of the template to use
field:<id> Value of the field with this id in a YAML template

IDs and names can be mixed and names are matched case-insensitively. Values that don't match anything in the repository are ignored. Labels include the organization's labels, and closed milestones and projects can be selected too. Milestones and projects are only offered to users who can write to issues or pull requests, so for other users these parameters have no effect.

The values from the link take precedence over the title, description, labels and assignees of the template.

When there are several issue templates to choose from, the parameters are passed through to the chosen one. On the compare page, any of these parameters also opens the pull request form directly, as expand=1 does.