UX writing: como escrever textos de interface que orientam

Design UX e usabilidade · Artigo

UX writing: como escrever textos de interface que orientam

Falar no WhatsApp
Resposta direta

UX writing é a disciplina que planeja e escreve os textos de uma interface, como botões, rótulos, avisos e mensagens de erro, para que a pessoa entenda o que fazer, conclua a tarefa e se sinta segura. Os textos pequenos são chamados de microcopy e fazem parte do design, não de um acabamento posterior.

Imagine uma pessoa no celular, no meio de um cadastro, a poucos toques de concluir um pedido. De repente aparece a frase "Erro 4021: operação inválida". Ela não sabe o que fez, não sabe o que corrigir e não sabe se a cobrança foi feita. O botão diz apenas "OK". Ela fecha a tela, e o pedido se perde por causa de um texto, não de uma falha de programação.

Esse é o território do UX writing: a escrita dos textos que vivem dentro de um produto digital, como rótulos de botões, mensagens de erro, avisos, instruções de formulário e telas vazias. Na Trilion, que desenvolve sites e sistemas desde 1995, vemos que a interface bem desenhada perde força quando o texto confunde, e que um bom texto muitas vezes resolve o que nenhum ajuste visual resolveria.

Neste artigo, você vai entender o que é UX writing e o que é microcopy, ver como escrever mensagens de erro que orientam, aprender regras práticas para botões e formulários e montar um processo simples para revisar os textos do seu projeto. Se quiser conversar sobre a interface do seu produto, o briefing em 3 passos está em /desenvolvimento/orcamento.

UX writing: o que é e onde ele aparece

UX writing é a disciplina que planeja e escreve os textos de uma interface para que a pessoa entenda o que fazer, conclua a tarefa e se sinta segura no caminho.

O que é UX writing, em uma frase

O que é UX writing? É escrever o texto como parte do design, e não como enfeite colocado no fim. O texto de um botão, de um aviso ou de uma tela vazia faz parte da experiência tanto quanto o layout, a cor e o fluxo de navegação. Por isso ele deve ser pensado junto com o design de UX e a usabilidade do produto, desde os primeiros esboços.

O que é microcopy

Microcopy é o nome dado aos textos pequenos da interface: a etiqueta de um campo, a dica abaixo dele, o texto de um botão, a confirmação depois de salvar. São poucas palavras, mas aparecem nos momentos de decisão. Quem escreve microcopy trabalha com economia: cada palavra precisa justificar o espaço que ocupa.

Onde o texto de interface costuma aparecer

Em quase todo ponto de contato. A lista abaixo ajuda a mapear o que existe no seu produto.

  • Botões e links: dizem o que acontece ao clicar.
  • Formulários: rótulos, exemplos de preenchimento e regras de formato.
  • Mensagens de erro: explicam o que falhou e como seguir.
  • Telas vazias: orientam o primeiro passo quando ainda não há dados.
  • Confirmações e avisos: dão segurança antes e depois de uma ação importante.
  • E-mails e notificações do sistema: prolongam a conversa fora da tela.

Faça um teste agora: abra o seu site ou sistema e leia apenas os textos dos botões. Eles contam, sozinhos, o que a pessoa consegue fazer ali?

Princípios de um bom texto de interface

Um bom texto de interface usa as palavras que a pessoa já conhece, diz o que aconteceu, indica o próximo passo e mantém um tom respeitoso do início ao fim.

Fale a língua de quem usa

A segunda heurística de usabilidade do Nielsen Norman Group pede que o sistema use palavras e conceitos que o usuário já conhece, em vez de termos internos da empresa. O texto também deve seguir uma ordem natural e lógica. Na prática, isso significa pesquisar o vocabulário do público antes de batizar menus e botões, porque o que parece óbvio para a equipe nem sempre é óbvio para quem chega.

Clareza antes de criatividade

Um rótulo criativo que exige interpretação custa mais do que ajuda. Prefira o termo direto, com um nome para cada conceito, usado sempre do mesmo jeito. Se a tela diz "carrinho" num lugar e "sacola" em outro, a pessoa pergunta se são coisas diferentes. A consistência reduz esforço e dá confiança.

Voz e tom não são a mesma coisa

A voz é a personalidade da marca e permanece estável. O tom muda conforme o momento: pode ser leve ao dar boas-vindas e deve ser sóbrio ao informar uma falha no pagamento. Humor em mensagens de erro merece cuidado. O Nielsen Norman Group lembra que a graça cansa quando o usuário vê o mesmo aviso várias vezes, e reserva a exceção para falhas raras e totais.

Escreva para ler com pressa

Ninguém lê interface como lê um livro. Frases curtas, verbos no início das ações e a informação mais importante primeiro funcionam melhor. Revise cada texto perguntando se uma pessoa distraída, em movimento e com a tela pequena, entenderia o que fazer em 3 segundos de leitura.

Imagem ilustrativa: reunião com computador

Mensagens de erro que orientam em vez de culpar

Uma boa mensagem de erro descreve o problema com precisão, não culpa a pessoa e mostra como corrigir, preferencialmente ao lado do ponto exato onde a falha aconteceu.

As 3 perguntas que a mensagem precisa responder

A documentação de conteúdo do Atlassian Design indica que uma mensagem de erro informa que um problema já ocorreu, o que ele afeta e o que fazer em seguida. Resumindo em perguntas simples:

  1. O que aconteceu?
  2. O que isso significa para a pessoa?
  3. O que ela pode fazer agora?

Se a equipe não sabe a causa, o mesmo guia recomenda não inventar uma explicação: admita que algo deu errado e ofereça um próximo passo.

Evite palavras que acusam

O Nielsen Norman Group recomenda um tom positivo e sem culpa, evitando termos como "inválido", "ilegal" ou "incorreto". O sistema deve se adaptar, e não transferir a responsabilidade para a pessoa. Em vez de "CPF inválido", escreva "O CPF precisa ter 11 números. Confira se algum dígito ficou faltando". A segunda versão descreve a exigência do campo e indica a correção.

Esconda códigos, mostre caminhos

Códigos de erro servem à equipe técnica, não ao usuário. A heurística 9 do Nielsen Norman Group pede mensagens sem códigos e sem termos técnicos, que indiquem o problema específico e sugiram uma saída. Quando o código for útil para o suporte, ele pode aparecer em letra pequena, depois do texto principal, sem protagonismo.

Mantenha as respostas já digitadas

Entre as diretrizes de eficiência do Nielsen Norman Group está preservar o que a pessoa digitou, mesmo quando há um erro, para que ela edite em vez de recomeçar. Esse é um ponto em que texto e programação andam juntos: de nada adianta a mensagem gentil se o formulário apaga tudo ao falhar. Na Trilion, quem desenha também programa, e esse tipo de detalhe é resolvido na mesma conversa.

Compartilhe com quem cuida do seu site: qual é a pior mensagem de erro que o seu produto exibe hoje?

Botões, rótulos e formulários

Botões devem nomear a ação com um verbo claro, rótulos de campo devem dizer o que digitar, e as dicas devem aparecer antes do erro, não depois dele.

Botões com verbo e resultado

O Atlassian Design orienta usar uma ou duas palavras, com verbo no imperativo que nomeia a ação, como "Salvar" ou "Remover", e evitar rótulos vagos como "OK". O mesmo raciocínio vale para o português. "Enviar pedido" é melhor que "Continuar", e "Excluir conta" é melhor que "Confirmar", porque a pessoa sabe o que vai acontecer antes de tocar.

Rótulos e exemplos nos campos

O rótulo diz o que o campo pede, e o exemplo mostra o formato. Evite usar apenas o texto de dentro do campo como rótulo, porque ele some quando a pessoa começa a digitar. Se o telefone exige DDD, diga isso antes. Orientar antes do erro economiza o erro.

Quando avisar sobre um problema

O Nielsen Norman Group sugere evitar erros prematuros: não marque um campo como problemático só porque a pessoa clicou nele e saiu sem preencher. Em campos propensos a falha, como senhas, uma orientação em tempo real, ao lado do campo, ajuda mais do que uma bronca no final.

Checklist rápido para formulários

  • Cada campo tem um rótulo visível e permanente.
  • Os formatos esperados aparecem antes de o erro acontecer.
  • O erro surge junto ao campo, e não só no topo da página.
  • As respostas digitadas são preservadas.
  • O botão final descreve a ação concreta.
Imagem ilustrativa: profissional com notebook

Telas vazias, confirmações e momentos delicados

Os textos de apoio, como telas vazias, confirmações e avisos de ação irreversível, transformam pontos de dúvida em pontos de segurança.

Telas vazias que ensinam o primeiro passo

Quando o usuário abre um painel sem dados, a tela em branco gera dúvida. Um texto curto que explica o que aparecerá ali e o botão do primeiro passo, como "Cadastrar primeiro cliente", dá direção. A tela vazia é uma das poucas oportunidades de ensinar sem interromper ninguém.

Confirmações que fecham o ciclo

Depois de uma ação, a pessoa quer saber se deu certo. "Pedido enviado. Você receberá a confirmação por e-mail" fecha o ciclo e informa o que vem depois. Uma confirmação vaga deixa a pessoa em dúvida e ela repete a ação, o que cria pedidos duplicados.

Ações que não têm volta

Antes de excluir, cancelar ou enviar algo definitivo, o texto deve dizer o que será perdido e oferecer saída. O guia do Atlassian Design recomenda indicar o que acontece se a pessoa não agir e sugere cuidado com "por favor" e "desculpe": em erros menores, essas palavras podem agravar a percepção do problema, e ficam reservadas para consequências sérias e irreversíveis.

Ajuda no momento certo

A heurística 10 do Nielsen Norman Group diz que o ideal é o sistema dispensar explicações, mas, quando a ajuda é necessária, ela deve ser breve, focada na tarefa e apresentada no contexto. Uma dica ao lado do campo vale mais do que um manual distante.

Como criar um processo de UX writing no projeto

Um processo simples de UX writing envolve mapear os textos, definir um guia de voz, escrever em conjunto com o design e testar com pessoas do público.

Passo a passo para começar

  1. Inventário: liste todos os textos do produto, tela por tela.
  2. Glossário: escolha um termo para cada conceito e use sempre o mesmo.
  3. Guia de voz e tom: defina como o produto fala em situações normais e em falhas.
  4. Escrita no protótipo: substitua textos de preenchimento por textos verdadeiros logo nos primeiros esboços.
  5. Teste: peça a pessoas do público que realizem tarefas e observe onde hesitam.
  6. Revisão contínua: reveja os textos a cada nova funcionalidade.

Escrever junto com o protótipo

Textos de preenchimento em latim escondem problemas. Quando o protótipo e o wireframe já trazem os textos finais, o time percebe se um rótulo é longo demais para a tela, se uma mensagem cabe ao lado do campo e se o fluxo faz sentido lido em voz alta.

Testar o texto com pessoas

Um texto só se prova quando alguém tenta usá-lo. Os métodos de UX research e os testes simples de usabilidade servem também para a escrita. Peça a 5 pessoas do público que cumpram uma tarefa e anote cada pausa e cada pergunta. A dúvida em voz alta indica exatamente onde o texto falhou.

Quem escreve: designer, redator ou programador?

A resposta ideal é uma conversa entre os três. O designer conhece o fluxo, o redator cuida da clareza e o programador sabe o que o sistema consegue informar em cada falha. Na Trilion, o design e o código ficam no mesmo time, e isso encurta o caminho entre identificar uma mensagem ruim e corrigi-la de verdade, como detalhamos em handoff entre design e desenvolvimento sem ruído.

Acessibilidade e consistência no texto

Texto de interface acessível não depende só de cor e de ícones, usa linguagem simples e mantém o mesmo padrão em todas as telas.

Não dependa só da cor

O guia de mensagens de erro do Google para desenvolvedores lembra que muita gente tem deficiência de visão de cores e orienta combinar a cor com outro sinal, como texto em negrito ou um marcador. O Nielsen Norman Group diz o mesmo: nunca use apenas cor ou animação para sinalizar um erro. Um ícone e uma frase clara garantem que a mensagem chegue a todos. O tema aparece com mais detalhe em nosso artigo sobre WCAG e acessibilidade digital.

Quem usa leitor de tela costuma percorrer uma lista de links fora de contexto. Se todos dizem "clique aqui", a lista é inútil. Prefira "Ver condições de entrega" ou "Baixar o guia". O mesmo vale para botões: o texto deve funcionar mesmo sem a imagem ao redor.

Mantenha um padrão entre telas e canais

O padrão de escrita precisa se repetir: mesmas palavras para as mesmas ações, mesma estrutura de mensagem, mesma pontuação. Quando existe um design system, o guia de textos entra nele, ao lado de cores e componentes. Assim cada nova tela nasce com o tom certo.

Conclusão

UX writing é a parte do design que se faz com palavras: dizer o que aconteceu, orientar o próximo passo e tratar a pessoa com respeito. Os textos pequenos da interface, os botões, os campos e as mensagens de erro, pesam nos momentos em que alguém decide continuar ou desistir.

Comece pelo inventário, escolha um termo para cada conceito, reescreva as mensagens de erro com as 3 perguntas e teste com pessoas do público. Se você quer revisar a interface do seu site ou sistema com um time em que design e código trabalham juntos, monte o briefing em /desenvolvimento/orcamento ou comece pela página de design UX e usabilidade. A proposta é escrita depois do briefing, e o valor depende do escopo.

Se a interface envolve conexões com outros sistemas, vale também conhecer nossa frente de integração de sistemas, onde as mensagens de falha entre sistemas também precisam ser pensadas.

Sobre este texto

Este artigo foi escrito pela equipe da Trilion a partir da experiência de desenvolver sites e sistemas desde 1995 e da leitura de documentação e publicações especializadas de design de interface. Os fatos atribuídos a terceiros foram conferidos nas páginas originais. Nenhum número de resultado é prometido: o texto descreve método, não garantia.

Perguntas frequentes

O que é UX writing?

É a escrita dos textos de uma interface digital, como botões, rótulos, avisos e mensagens de erro. O objetivo é que a pessoa entenda o que fazer e conclua a tarefa com segurança. O texto é pensado junto com o design e o fluxo, e não acrescentado no fim do projeto.

O que é microcopy?

Microcopy é o conjunto dos textos pequenos de um produto: etiquetas de campos, dicas, textos de botões e confirmações. Poucas palavras, mas colocadas nos momentos de decisão, em que a pessoa precisa de clareza para continuar.

Como escrever uma boa mensagem de erro?

Descreva o problema com precisão, sem culpar a pessoa e sem códigos técnicos, e diga como corrigir. Coloque a mensagem junto ao campo com problema e preserve o que foi digitado. Se a causa for desconhecida, admita a falha e ofereça um próximo passo.

Qual a diferença entre UX writing e copywriting?

O copywriting persuade e vende, em anúncios e páginas de venda. O UX writing orienta o uso do produto, ajudando a pessoa a realizar tarefas dentro da interface. Os dois podem conviver, mas têm objetivos e tom diferentes.

Quem deve escrever os textos da interface?

O ideal é uma conversa entre design, redação e programação. O designer conhece o fluxo, o redator cuida da clareza e o programador sabe o que o sistema consegue informar em cada falha. Na Trilion, design e código ficam no mesmo time.

Método

Como a Trilion conduz um projeto de UX

Do briefing à operação, em 5 etapas e com tudo por escrito. A proposta vem depois do briefing e o valor depende de escopo, integrações, volume e prazo.

  1. Briefing em 3 passos

    Você conta o que precisa construir; nós devolvemos perguntas e um caminho possível.

  2. Desenho por escrito

    Pesquisa, jornadas, arquitetura de informação e protótipo, antes de qualquer linha de código.

  3. Construção em fatias

    Entregas pequenas e testáveis, com protótipo clicável e validação a cada fatia.

  4. Testes e homologação

    Casos do dia a dia da sua operação, com plano de retorno antes de publicar.

  5. Operação e evolução

    Acompanhamento combinado na proposta e ajustes guiados por indicadores.

Vamos desenhar a experiência do seu produto

Conte o que precisa resolver. A Trilion responde com uma proposta escrita, depois do briefing, e leva o projeto do código à operação.

Falar no WhatsApp
Blog da Trilion · SEO e posicionamento

Continue aprendendo sobre SEO e busca

Artigos do blog da Trilion que aprofundam os temas deste texto. Arraste, use as setas ou o teclado.

WhatsApp
WhatsApp

Converse com a Trilion

Diga-nos o seu nome, e a conversa abre em seguida