421

I'm not sure, but I have a vague memory of creating a github pull request with "Issue 4" or something in the title, and it automatically attached itself to Issue 4 in the project that I was submitting it to. I tried it again recently and it didn't work -- it just created a brand new issue instead. I don't see any options like "Attach to issue" on the new pull request page, nor "Open a new pull request for this issue" on the issue page. Is there any way to do this, to help project owners keep their Issues page clean and avoid duplication?

Edit: To clarify, I know that creating a pull request always creates a new issue. I would like to instead attach the pull request to an existing issue.

7
  • 1
    I believe my answer express the fact that the feature you want ("attach a pull request to an existing issue") might not be there yet.
    – VonC
    Dec 25, 2010 at 1:19
  • It does (and that is in fact confirmed by this tweet), but it also made me realize my question could have been clearer.
    – Tyler
    Dec 25, 2010 at 1:24
  • I hope that feature is high on github priority list, coz the code bears out there would love it!
    – flq
    Jan 3, 2011 at 12:53
  • 2
    The correct answer ought to be changed to masukomi's, now that the "fixes #1" method available. No need to go through the API. Sep 15, 2011 at 18:35
  • I still cannot find a way to attach a pull request to an existing issue. Have I missed something? The answers in this thread seems to suggest this capability does exist, but I cannot find it (it always makes a new issue). Oct 5, 2011 at 22:02

10 Answers 10

258

Adding a pull request to an existing upstream issue is easy assuming you forked using the normal github means.

Simply reference the issue in your commit message using any of the supported keywords:

  • close
  • closes
  • closed
  • fix
  • fixes
  • fixed
  • resolve
  • resolves
  • resolved

For example: "this commit fixes #116"

The text referencing the issue does not need to appear in the subject line of your commit.

Push your commit to your github repo and the pull request will be automatically appended to the issue.

Note: While it is not required, it is strongly recommended that you commit anything that will be part of a pull request to a separate branch specific to that issue, because future commits on that branch will be appended to the pull request (automatically by github). So, if you didn't make a separate branch, left it on master, and then kept developing, then all your unrelated commits to master would get appended to your pull request.

7
  • 35
    "it is strongly recommended that you commit anything that will be part of a pull request to a separate branch specific to that issue, because future commits on that branch will be appended to the pull request" -- very good point. That happened to me once and it was quite surprising.
    – Tyler
    Aug 25, 2011 at 16:46
  • 9
    This does not solve the problem of turning an issue into a pull request unfortunately. Any discussion that was had in the issue does not get transferred to the pull request... which is unfortunate for several use-cases. I wish Github would just give some granular control over how pull-reqs work in the repo settings. Feb 16, 2012 at 15:21
  • 1
    I'm not sure why you need an issue turned into a pull request. Why isn't having the pull-request mentioned in the issue's conversation sufficient? This would happen automatically by referencing the # in the pull req. You have a covo thread. Then you have a thread with the relevant pull req embedded in it. Sounds perfect.
    – masukomi
    Feb 16, 2012 at 18:59
  • 2
    I think you missed my point Rory. If you create a pull request and mention it in the issue (as I suggested), then the two are connected, and you still can click a button to get the changes.
    – masukomi
    Aug 14, 2012 at 3:21
  • 2
    This doesn't help when the pull request is an on going thing. Our workflow is to create issues for ideas, and then pull requests from feature branches once we begin work on those ideas. Closing the issue using a commit in the pull request means we lose the previous discussion that the issue contained, which often includes hashing out whatever feature/fix/refactor the issue addresses. What is really needed is a way to straight up turn an issue in to a pull request once work on the issue has begun. Jul 24, 2014 at 21:35
245

The hub project can do this.

In the repository and branch that you want to send a pull request from:

$ hub pull-request -i 4

This uses the GitHub API, and attaches a pull request for the current branch to the existing issue number 4.


EDIT: Comment by @atomicules: To expand on the answer by @MichaelMior a full example is:

$ hub pull-request -i 4 -b USERNAME_OF_UPSTREAM_OWNER:UPSTREAM_BRANCH -h YOUR_USERNAME:YOUR_BRANCH URL_TO_ISSUE
17
  • 14
    brew install hub to install with homebrew
    – gcamp
    Jul 29, 2012 at 6:01
  • 11
    This doesn't work for me. Says Error creating pull request: Unprocessable Entity (HTTP 422)
    – Rubycut
    Aug 3, 2012 at 9:39
  • 11
    @Rubycut I had the same problem. Instead I did hub pull-request URL_TO_ISSUE, then it worked for me. I wonder if -i ISSUE_NUMBER only works if the issue is in the same repository (i.e., not a fork) Sep 16, 2012 at 4:10
  • 30
    To expand on the answer by @MichaelMior a full example is: hub pull-request -b USERNAME_OF_UPSTREAM_OWNER:UPSTREAM_BRANCH -h YOUR_USERNAME:YOUR_BRANCH URL_TO_ISSUE
    – atomicules
    Nov 21, 2012 at 16:18
  • 4
    Note this only works on issues you created: github.com/defunkt/hub/issues/189#issuecomment-6353354
    – Zach
    Jan 11, 2013 at 8:17
144

You can create a Pull Request from an existing Issue with the Pull Request API:

$ curl --user "smparkes" \
       --request POST \
       --data '{"issue": 15, "head": "smparkes:synchrony", "base": "master"}' \
       https://api.github.com/repos/technoweenie/faraday/pulls

This creates a pull request:

  • ask technoweenie at project faraday (https://api.github.com/repos/technoweenie/faraday/pulls)
  • to pull from the synchrony branch in smparkes' fork ("head": "smparkes:synchrony")
  • to the master branch in technoweenie's fork ("base": "master")
  • and attach the pull request to issue 15 ("issue": 15)
  • with the pull request author smparkes (--user "smparkes")
  • you will be prompted for your GitHub password
12
  • 1
    I copied in some of the sample code from that link. Hope you don't mind, and please let me know if I mistranslated it!
    – Tyler
    Dec 25, 2010 at 7:14
  • 3
    You also need authentication, add this to command above: -u "login:password"
    – morgoth
    Feb 23, 2011 at 14:00
  • 2
    I'd just like to add that this method still works, but it may have the side effect of listing your commit twice on the discussion page, if GitHub had already picked it up implicitly from the issue # in its message (example). The commit only comes through once on the official pull request, though. Aug 27, 2011 at 22:13
  • 3
    Can this be updated to the v3 API? GitHub just turned off the v2 API. Jun 13, 2012 at 20:38
  • 1
    @rsanchezsaez As I say in my answer, change --user "smparkes:password" to --user "smparkes" to be prompted for your password interactively. Jul 5, 2013 at 7:05
17

Another possible tool is the Issue2Pr website which turns your issues into Pull Requests.

It's very simple and effective!

enter image description here

Resources:

10

This other answer explains how to use cURL (curl) to create a Pull Request from an Issue through the GitHub API. Here’s how to do it using HTTPie (http), which produces an easier-to-read and easier-to-edit command:

$ http --auth "<your-GitHub-username>" \
       POST \
       https://api.github.com/repos/<issue-repo-owner>/<issue-repo-name>/pulls \
       issue=<issue-number> head=<your-GitHub-username>:<your-fork-branch-name> base=<issue-repo-branch-name>

Then type your GitHub password when prompted.

Explained example

You have logged into GitHub with username smparkes and password hunter2. You saw technoweenie’s repo faraday, thought of something that should be changed, and made an Issue on that repo for it, Issue #15. Later, you find that nobody else has made your proposed change, and you also have some time to do it yourself. You fork faraday to your own account, then write your changes and push them to your fork under a branch named synchrony. You think technoweenie should pull those changes to the master branch of his repo. This is the command you would write to convert your previous Issue into a Pull Request for this situation:

$ http --auth "smparkes" \
       POST \
       https://api.github.com/repos/technoweenie/faraday/pulls \
       issue=15 head=smparkes:synchrony base=master
http: password for [email protected]: hunter2

Now Issue #15 is a Pull Request.

5

Instead of doing that on the client side (with hub, as in Christian Oudard answer), you now (February 2020) can do it on the server side (github.com)

See "View and link issues and pull requests from the sidebar "

You can now link issues and pull requests via the sidebar in their respective pages. Connections made here will automatically close issues once a linked pull request is merged.

Documentation: https://help.github.com/assets/images/help/pull_requests/link-issue-drop-down.png

And there is a search API with that feature.

Find all the open issues in a repository that have closing pull requests references with the linked:pr search qualifier.
Similarly, locate all the pull requests in a repository that are missing a supporting issue with -linked:issue.


Ismoh refers in the comments to the discussion:

"GitHub Action: Pull request 'development' object/data, aka linked issues"

And Ismosh's Marketplace action for finding the linked issues of a pull request.

    - name: Find linked issues
      id: find-linked-issues
      uses: Ismoh-Games/[email protected]
      with:
        token: ${{ secrets.GITHUB_TOKEN }}
        repository: ${{ github.repository }} # optional
        pull-request-number: ${{ github.event.pull_request.number }} # optional
        copy-issues-labels: true # optional
2
3

in case you use 2-factor-auth with github you'll need to provide the authtoken as header in the request:

curl -u "<your_username>:<your_pw>" \
     --header 'X-GitHub-OTP: <your_authtoken>' \
     --request POST \
     --data '{"issue":"<issue_nr>", "head":"<your_username>:<your_forks_branchname>", "base":"<upstream_branch>"}' \
     https://api.github.com/repos/<upstream_user>/<upstream_repo>/pulls
1
  • 1
    Yes, 2FA prevents many of the answers here from working. In my case, I created a personal access token and use it rather than my password, which works.
    – berto
    Oct 21, 2016 at 13:22
1

You may also use Gub to submit pull requests for your issue.

It also helps you use a proper fork/pull-request style.

Edit: 10/5/2013

To get Gub to submit pull-request for issue #123, you need to run the following:

$ gub start 123

This will create a new branch issue-123. Once you're done working on the issue, execute:

$ gub finish

Voila!

Note: I am the author of Gub gem.

0
0

Using the git-hub tool, you could do this with:

$> git hub pull attach 123

This would convert issue #123 into pull request #123, thus maintaining all discussion about the issue in a single location.

0

If you have 2FA enabled, you can use pass the token with HTTPie:

http POST \
    https://api.github.com/repos/<repo-owner>/<repo-name>/pulls \
    issue=2 head=issue_2 base=master
    "Authorization:token PUTAUTHTOKENHERE"

This will use the branch issue_2 to convert issue #2 into a pull request.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.