Skip to main content

Managing branches

You can create a branch off of a repository's default branch so you can safely experiment with changes.

About managing branches

You can use branches to safely experiment with changes to your project. Branches isolate your development work from other branches in the repository. For example, you could use a branch to develop a new feature or fix a bug.

You always create a branch from an existing branch. Typically, you might create a branch from the default branch of your repository. You can then work on this new branch in isolation from changes that other people are making to the repository.

You can also create a branch starting from a previous commit in a branch's history. This can be helpful if you need to return to an earlier view of the repository to investigate a bug, or to create a hot fix on top of your latest release.

Once you're satisfied with your work, you can create a pull request to merge your changes in the current branch into another branch. For more information, see "Creating an issue or pull request" and "About pull requests."

You can always create a branch in GitHub Desktop if you have read access to a repository, but you can only push the branch to GitHub if you have write access to the repository.

Los administradores de un repositorio pueden activar las protecciones en una rama. Si estás trabajando en una rama que está protegida, no podrás eliminar ni hacer un empuje forzado a la rama. Los administradores de repositorio pueden habilitar otras configuraciones de la rama protegida para requerir ciertos flujos de trabajo antes de que la rama se pueda fusionar. Para obtener más información, consulta"Acerca de las ramas protegidas".

Creating a branch

Tip: The first new branch you create will be based on the default branch. If you have more than one branch, you can choose to base the new branch on the currently checked out branch or the default branch.

  1. En la parte superior de la app, da clic en Rama Actual y luego, en la lista de ramas, da clic en aquella que quieras sea la base de tu nueva rama. Drop-down menu to switch your current branch
  2. Haz clic en New Branch (Nueva rama). New Branch option in the Branch menu
  3. Dentro de Name (Nombre), escribe el nombre de la nueva rama. Field for creating a name for the new branch
  4. Utiliza el menú desplegable para elegir una rama base para tu rama nueva. Base branch options
  5. Haz clic en Create Branch (Crear rama). Create Branch button
  1. En la parte superior de la app, da clic en Rama Actual y luego, en la lista de ramas, da clic en aquella que quieras sea la base de tu nueva rama. Drop-down menu to switch your current branch
  2. Haz clic en New Branch (Nueva rama). New Branch option in the Branch menu
  3. Dentro de Name (Nombre), escribe el nombre de la nueva rama. Field for creating a name for the new branch
  4. Utiliza el menú desplegable para elegir una rama base para tu rama nueva. Base branch options
  5. Haz clic en Create Branch (Crear rama). Create branch button

Creating a branch from a previous commit

  1. Haz clic en History (Historial). La pestaña de historial seleccionada en la barra lateral
  2. Right-click on the commit you would like to create a new branch from and select Create Branch from Commit. Create branch from commit context menu
  3. Dentro de Name (Nombre), escribe el nombre de la nueva rama.
  4. Haz clic en Create Branch (Crear rama). Create branch from commit

Publishing a branch

If you create a branch on GitHub, you'll need to publish the branch to make it available for collaboration on GitHub.

  1. At the top of the app, click Current Branch, then click the branch that you want to publish. Drop-down menu to select which branch to publish
  2. Click Publish branch. The Publish branch button

Switching between branches

You can view and make commits to any of your repository's branches. If you have uncommitted, saved changes, you'll need to decide what to do with your changes before you can switch branches. You can commit your changes on the current branch, stash your changes to temporarily save them on the current branch, or bring the changes to your new branch. If you want to commit your changes before switching branches, see "Committing and reviewing changes to your project."

Tip: You can set a default behavior for switching branches in the Advanced settings. For more information, see "Configuring basic settings."

  1. En GitHub Desktop, da clic en Rama Actual. Menú desplegable de la rama actual
  2. Dentro de la lista de ramas, haz clic en la rama a la que deseas cambiar para continuar. List of branches in the repository
  3. If you have saved, uncommitted changes, choose Leave my changes or Bring my changes, then click Switch Branch. Switch branch with changes options

Deleting a branch

You can't delete a branch if it's currently associated with an open pull request. You cannot undo deleting a branch.

  1. En la parte superior de la app, da clic en Rama Actual y luego en la rama que quieres borrar. Drop-down menu to select which branch to delete
  2. En tu barra de menú, da clic en Rama y luego en Borrar.... También puedes presionar Shift+Command+D. Delete... option in the Branch menu
  1. En la parte superior de la app, da clic en Rama Actual y luego en la rama que quieres borrar. Drop-down menu to select which branch to delete
  2. En tu barra de menú, da clic en Rama y luego en Borrar.... También puedes presionar Ctrl+Shift+D. Delete... option in the Branch menu

Further reading