Creating a pull request

Create a pull request to propose and collaborate on changes to a repository. These changes are proposed in a branch, which ensures that the default branch only contains finished and approved work.

Anyone with read permissions to a repository can create a pull request, but you must have write permissions to create a branch. If you want to create a new branch for your pull request and don't have write permissions to the repository, you can fork the repository first. For more information, see "Creating a pull request from a fork" and "About forks."

You can specify which branch you'd like to merge your changes into when you create your pull request. Pull requests can only be opened between two branches that are different.

Nota: Para abrir una solicitud de extracción en un repositorio público, debes tener acceso de escritura en el encabezado de la rama origen o, para los repositorios que pertenecen a una organización, debes ser miembro de la organización propietaria del mismo para hacerlo.

Puedes vincular una solicitud de extracción a un informe de problemas para mostrar que se está trabajando en una solución y para cerrar automáticamente el informe de problemas cuando alguien fusione la solicitud de extracción. Para obtener más información, consulta la sección "Vincular una solicitud de extracción a un informe de problemas".

Changing the branch range and destination repository

By default, pull requests are based on the parent repository's default branch. For more information, see "About branches."

If the default parent repository isn't correct, you can change both the parent repository and the branch with the drop-down lists. You can also swap your head and base branches with the drop-down lists to establish diffs between reference points. References here must be branch names in your GitHub repository.

Pull Request editing branches

When thinking about branches, remember that the base branch is where changes should be applied, the head branch contains what you would like to be applied.

When you change the base repository, you also change notifications for the pull request. Everyone that can push to the base repository will receive an email notification and see the new pull request in their dashboard the next time they sign in.

When you change any of the information in the branch range, the Commit and Files changed preview areas will update to show your new range.

Tips:

  • Using the compare view, you can set up comparisons across any timeframe. For more information, see "Comparing commits."
  • Project maintainers can add a pull request template for a repository. Templates include prompts for information in the body of a pull request. For more information, see "About issue and pull request templates."

Creating the pull request

  1. En GitHub, visita la página principal del repositorio.

  2. In the "Branch" menu, choose the branch that contains your commits. Branch dropdown menu

  3. Above the list of files, click Pull request. Enlace de "Solicitud de extracción" sobre la lsita de archivos

  4. Use the base branch dropdown menu to select the branch you'd like to merge your changes into, then use the compare branch drop-down menu to choose the topic branch you made your changes in. Drop-down menus for choosing the base and compare branches

  5. Escribe un título y una descripción para tu solicitud de extracción. Título y campos de descripción de la solicitud de extracción

  6. Para crear una solicitud de extracción que está lista para revisión, haz clic en Create Pull Request (Crear solicitud de extracción). Para crear un borrador de solicitud de extracción, utiliza el menú desplegable y selecciona Crear Borrador de Solicitud de Extracción, y posteriormente da clic en Borrador de Solicitud de Extracción. Para obtener más información acerca de las solicitudes de extracción en borrador "Acerca de las solicitudes de extracción".Botón Create pull request (Crear una solicitud de extracción)

Tip: Después de que crees una solicitud de extracción, puedes pedir a alguien en específico que revise tus cambios propuestos. Para obtener más información, consulta "Solicitar la revisión de una solicitud de extracción".

After your pull request has been reviewed, it can be merged into the repository.

To learn more about CLI de GitHub, see "About CLI de GitHub."

To create a pull request, use the gh pr create subcommand.

gh pr create

To assign a pull request to an individual, use the --assignee or -a flags. You can use @me to self-assign the pull request.

gh pr create --assignee "@octocat"

To specify the branch into which you want the pull request merged, use the --base or -B flags. To specify the branch that contains commits for your pull request, use the --head or -H flags.

gh pr create --base my-base-branch --head my-changed-branch

To include a title and body for the new pull request, use the --title and --body flags.

gh pr create --title "The bug is fixed" --body "Everything works again"

To mark a pull request as a draft, use the --draft flag.

gh pr create --draft

To add a labels or milestones to the new pull request, use the --label and --milestone flags.

gh pr create --label "bug,help wanted" --milestone octocat-milestone

To add the new pull request to a specific project, use the --project flag.

gh pr create --project octocat-project

To assign an individual or team as reviewers, use the --reviewer flag.

gh pr create --reviewer monalisa,hubot  --reviewer myorg/team-name

To create the pull request in your default web browser, use the --web flag.

gh pr create --web
  1. Switch to the branch that you want to create a pull request for. For more information, see "Switching between branches."
  2. Click Create Pull Request. GitHub Desktop will open your default browser to take you to GitHub. The Create Pull Request button
  3. On GitHub, confirm that the branch in the base: drop-down menu is the branch where you want to merge your changes. Confirm that the branch in the compare: drop-down menu is the topic branch where you made your changes. Drop-down menus for choosing the base and compare branches
  4. Escribe un título y una descripción para tu solicitud de extracción. Título y campos de descripción de la solicitud de extracción
  5. Para crear una solicitud de extracción que está lista para revisión, haz clic en Create Pull Request (Crear solicitud de extracción). Para crear un borrador de solicitud de extracción, utiliza el menú desplegable y selecciona Crear Borrador de Solicitud de Extracción, y posteriormente da clic en Borrador de Solicitud de Extracción. Para obtener más información acerca de las solicitudes de extracción en borrador "Acerca de las solicitudes de extracción".Botón Create pull request (Crear una solicitud de extracción)
  1. Switch to the branch that you want to create a pull request for. For more information, see "Switching between branches."
  2. Click Create Pull Request. GitHub Desktop will open your default browser to take you to GitHub. The Create Pull Request button
  3. On GitHub, confirm that the branch in the base: drop-down menu is the branch where you want to merge your changes. Confirm that the branch in the compare: drop-down menu is the topic branch where you made your changes. Drop-down menus for choosing the base and compare branches
  4. Escribe un título y una descripción para tu solicitud de extracción. Título y campos de descripción de la solicitud de extracción
  5. Para crear una solicitud de extracción que está lista para revisión, haz clic en Create Pull Request (Crear solicitud de extracción). Para crear un borrador de solicitud de extracción, utiliza el menú desplegable y selecciona Crear Borrador de Solicitud de Extracción, y posteriormente da clic en Borrador de Solicitud de Extracción. Para obtener más información acerca de las solicitudes de extracción en borrador "Acerca de las solicitudes de extracción".Botón Create pull request (Crear una solicitud de extracción)
  1. Once you've committed changes to your local copy of the repository, click the Create Pull Request icon. Source control side bar with staging button highlighted
  2. Check that the local branch and repository you're merging from, and the remote branch and repository you're merging into, are correct. Then give the pull request a title and a description. Source control side bar with staging button highlighted
  3. Click Create.

For more information on creating pull requests in Codespaces, see "Using Codespaces for pull requests."

Further reading

Did this doc help you?Privacy policy

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

O, learn how to contribute.