Skip to main content

Alterar seu nome de usuário do GitHub

Você poderá alterar o nome de usuário da sua conta no GitHub.com.

Sobre alterações no nome de usuário

Você pode alterar seu nome de usuário para outro nome de usuário que não esteja em uso no momento. Se o nome de usuário desejado não estiver disponível, considere outros nomes ou variações exclusivas. Usar um número, hífen ou uma ortografia alternativa pode ajudar você a encontrar um nome de usuário semelhante que ainda está disponível.

Se você for o proprietário de uma marca do nome de usuário, encontre mais informações sobre como fazer uma reclamação de marca em nossa página Política de marca.

Se você não tiver uma marca registrada para o nome, você poderá escolher outro nome de usuário ou manter seu nome de usuário atual. O Suporte do GitHub não pode liberar o nome de usuário indisponível para você. Para obter mais informações, confira "Como alterar seu nome de usuário".

Depois de alterar seu nome de usuário, o nome antigo será disponibilizado para reivindicação por qualquer pessoa. A maioria das referências aos seus repositórios sob o nome de usuário antigo muda automaticamente para o novo nome de usuário. No entanto, alguns links para seu perfil não são redirecionados automaticamente.

O GitHub não pode configurar redirecionamentos para:

  • @mentions usando seu nome de usuário antigo
  • Links para gists que incluem seu nome de usuário antigo

Se você for membro de um empresa com usuários gerenciados, não poderá fazer alterações no seu nome de usuário. Para obter mais informações, confira "Tipos de contas do GitHub".

Se o namespace da conta inclui repositórios públicos que contêm uma ação listada no GitHub Marketplace ou que tinham mais de 100 clones ou mais de 100 usos do GitHub Actions na semana anterior à renomeação da sua conta, o GitHub desativa permanentemente a combinação antiga de nome do proprietário e do repositório (OLD-OWNER/REPOSITORY-NAME) quando você renomeia a sua conta. Ao tentar criar um repositório com uma combinação de nome de proprietário e nome de repositório desativados, você verá o erro: "O repositório <REPOSITORY_NAME> foi desativado e não pode ser reutilizado".

Se o namespace da conta incluir pacotes ou imagens de contêiner armazenados em um registro do GitHub Packages, o GitHub transferirá os pacotes e as imagens de contêiner para o novo namespace. Ao renomear a conta, você poderá interromper projetos que dependem desses pacotes. Se o namespace incluir imagens de contêiner que são públicas e têm mais de 5 mil downloads, o nome completo dessas imagens de contêiner (OLD-NAMESPACE/IMAGE-NAME) será desativado permanentemente quando você renomear a conta, para garantir que o nome da imagem de contêiner não possa ser reutilizado no futuro.

Referências de repositório

Após alteração do nome de usuário, o GitHub redirecionará automaticamente as referências para os repositórios.

  • Os links da web para repositórios existentes continuarão funcionando. Esse processo pode demorar alguns minutos para ser concluído após a alteração.
  • A linha de comando que faz push dos clones do repositório local para as URLs de controle do remote continuarão funcionando.

Se o novo proprietário do seu antigo nome de usuário criar um repositório com o mesmo nome do seu repositório, isso substituirá a entrada de redirecionamento e o seu redirecionamento para de funcionar. Por conta dessa possibilidade, é recomendável atualizar todas as URLs existentes do repositório remote após alteração do seu nome de usuário. Para obter mais informações, confira "Gerenciar repositórios remote".

Depois que você alterar seu nome de usuário, os links para sua página de perfil anterior, como https:///previoususername, retornarão um erro 404. Recomendamos atualizar todos os links para a sua conta no GitHub.com por meio de outro local, como o seu perfil do LinkedIn ou do Twitter.

Seus commits no Git

Se os commits do Git estiverem associadas a outro endereço de email que você adicionou à conta do GitHub, eles continuarão a ser atribuídos a você e aparecerão no grafo de contribuições após a alteração do nome de usuário. Para saber mais sobre como definir o endereço de email, confira "Configurar o endereço de e-mail do commit" e "Adicionar endereço de e-mail à sua conta do GitHub."

Se você estiver usando um endereço de email de commit privado fornecido pelo GitHub, a retenção do histórico de commits após uma renomeação de conta dependerá do formato do endereço de email. Os commits do Git associados ao endereço de email noreply fornecido pelo GitHub não serão atribuídos ao novo nome de usuário e não aparecerão no grafo do contribuições, a menos que o endereço de email noreply esteja no formato ID+USERNAME@users.noreply.github.com. As versões mais antigas do endereço de email noreply que não contêm uma ID numérica não serão associadas à conta do GitHub após a alteração do nome de usuário.

Avisos:

  • Após uma alteração de nome de usuário, os commits verificados assinados usando o endereço de email noreply anterior fornecido pelo GitHub perderão o status "Verificado".
  • Ao verificar uma assinatura, o GitHub verifica se o endereço de email do autor do commit ou da tag corresponde exatamente a um dos endereços de email associados às identidades da chave GPG. Além disso, o GitHub confirma se o endereço de email foi verificado e se ele está vinculado à conta do usuário. Isso garante que a chave pertence a você e que você é o criador do commit ou da tag. Como o nome de usuário do endereço de email noreply muda, esses commits não podem mais ser verificados.

Seus gists

Depois que você alterar seu nome de usuário, as URLs para qualquer gist público ou secreto também serão alteradas e os links anteriores para eles retornarão um erro 404. Recomendamos atualizar os links para esses gists em qualquer lugar em que você possa tê-los compartilhado.

Arquivos CODEOWNERS

Depois de alterar seu nome de usuário, os arquivos CODEOWNERS que incluem seu nome de usuário antigo precisarão ser atualizados manualmente. Ao exibir os arquivos CODEOWNERS em GitHub.com, uma mensagem de erro será exibida se o arquivo contiver usuários desconhecidos ou usuários sem acesso de gravação. Recomendamos atualizar todos os arquivos CODEOWNERS relevantes com seu novo nome de usuário. Para obter mais informações, confira "Sobre os proprietários de código".

Alterar nome de usuário

  1. No canto superior direito de qualquer página, clique na foto do seu perfil e em Configurações.

    Screenshot of a user's account menu on GitHub. The menu item "Settings" is outlined in dark orange.

  2. Na barra lateral esquerda, clique em Conta.

  3. Na seção "Alterar nome de usuário", clique em Alterar nome de usuário.

  4. Leia os avisos sobre a mudança de seu nome de usuário. Se você ainda quiser alterar seu nome de usuário, clique em Entendi. Vamos alterar meu nome de usuário.

  5. Digite um novo nome de usuário.

  6. Se o nome de usuário escolhido estiver disponível, clique em Alterar meu nome de usuário. Se o nome que você escolheu estiver indisponível, tente um nome de usuário diferente ou uma das sugestões que aparecem.

Leitura adicional