Branching and remote heads in Mercurial

In addition to pushing the job of merging to someone else, remote heads are also bad since they can cause confusion. People who make a new clone wont know which head to start from if there are several. To make things worse: a new clone will be updated to the newest head on the default branch, and this head changes from one moment to another when people push changes to the different heads.

Using named branches or separate clones help here: a new clone will always update to the head of the default branch and people can then update to another branch as needed.


Remote heads are bad because you’re basically pushing the effort of merging onto another person. This message is there to prevent people from accidentally introducing remote heads, telling them to merge first before pushing.

In this case though, you have created a named branch, meaning you intentionally introduce and share a new head, and you can discard the warning as informational. Use hg push --new-branch to force it (or -f before version 1.6).