summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorVictor Wu <victor@gitlab.com>2018-10-08 11:51:23 +0000
committerAchilleas Pipinellis <axil@gitlab.com>2018-10-08 11:51:23 +0000
commitf769e4383b4280002a6ee62fc328d49d4449cc16 (patch)
treef0c71e92aa913a2a6fec27aac1912d381ada1558 /doc
parent01166e828ae5c61890bfff940a147a610483d0fe (diff)
downloadgitlab-ce-f769e4383b4280002a6ee62fc328d49d4449cc16.tar.gz
Docs - Prefilled fields for new issue link
Diffstat (limited to 'doc')
-rw-r--r--doc/user/project/issues/create_new_issue.md18
1 files changed, 18 insertions, 0 deletions
diff --git a/doc/user/project/issues/create_new_issue.md b/doc/user/project/issues/create_new_issue.md
index 1688edc1ee2..c33d1365001 100644
--- a/doc/user/project/issues/create_new_issue.md
+++ b/doc/user/project/issues/create_new_issue.md
@@ -58,3 +58,21 @@ body becomes the issue description. [Markdown] and [quick actions] are
supported.
![Bottom of a project issues page](img/new_issue_from_email.png)
+
+## New issue via URL with prefilled fields
+
+You can link directly to the new issue page for a given project, with prefilled
+field values using query string parameters in a URL. This is useful for embedding
+a URL in an external HTML page, and also certain scenarios where you want the user to
+create an issue with certain fields prefilled.
+
+The title, description, and description template fields can be prefilled using
+this method. The description and description template fields cannot be pre-entered
+in the same URL (since a description template just populates the description field).
+
+Follow these examples to form your new issue URL with prefilled fields.
+
+- For a new issue in the GitLab Community Edition project with a pre-entered title
+and a pre-entered description, the URL would be `https://gitlab.com/gitlab-org/gitlab-ce/issues/new?issue[title]=Validate%20new%20concept&issue[description]=Research%20idea`
+- For a new issue in the GitLab Community Edition project with a pre-entered title
+and a pre-entered description template, the URL would be `https://gitlab.com/gitlab-org/gitlab-ce/issues/new?issue[title]=Validate%20new%20concept&issuable_template=Research%20proposal`