Gerador de schema Organization

Dizer às máquinas quem você é

Quem chega à sua página inicial sabe quem você é em poucos segundos. O logo está no canto, o endereço no rodapé, os ícones sociais levam às suas contas. Um buscador precisa deduzir tudo isso pelo layout e pelo texto, e às vezes erra. Pode tomar o logo de um parceiro pelo seu, ou associar ao seu nome o perfil de um homônimo.

Os dados estruturados poupam esse chute. Você adiciona à página um pequeno script, que os visitantes nunca veem, listando os fatos em campos com rótulo. Os rótulos vêm do schema.org, um vocabulário comum mantido por Google, Microsoft, Yahoo e Yandex. O formato é JSON-LD, que é JSON comum com duas chaves reservadas. @context indica o vocabulário e @type diz que tipo de coisa você está descrevendo.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "@id": "https://www.example.org/#organization",
  "name": "Riverside Community Center",
  "url": "https://www.example.org/",
  "logo": "https://www.example.org/logo.png",
  "sameAs": ["https://www.linkedin.com/company/riverside-cc"]
}
</script>

O que cada parte do formulário gera

Tipo de organização

Vira @type. A lista traz 7 tipos de organização, 14 tipos de LocalBusiness e 2 locais. Ao escolher um tipo de negócio ou um local, você também ganha a seção de horário de funcionamento, e o logo é copiado em image, que os resultados locais esperam. Museus e templos são escritos com dois tipos, por exemplo ["Museum", "Organization"], para que campos como legalName continuem válidos.

Nomes

name é o nome que as pessoas usam, legalName o nome registrado, alternateName uma sigla ou um nome antigo.

URL da página inicial

Preenche url e também monta @id, um identificador permanente (o seu endereço seguido de #organization) ao qual outros dados estruturados do seu site podem apontar.

Perfis

Cada linha vai para sameAs. É assim que você diz a um buscador que esta página do Facebook, esta página do LinkedIn ou este artigo da Wikipédia falam de você.

Endereço

Um objeto PostalAddress. Só é escrito quando há uma rua, uma cidade ou um código postal.

Telefone

Gravado no formato internacional. Com US ou CA como país, dez dígitos viram +1-503-555-0123. Um número digitado com + e código de país é mantido, com hifens entre os grupos.

Horários

Dias com os mesmos horários são reunidos em um único OpeningHoursSpecification. Duas faixas de horário no mesmo dia descrevem um fechamento no meio do dia.

Número fiscal ou de entidade beneficente

Escrito como taxID.

Os campos que você deixa vazios ficam fora do bloco.

A lista de revisão abaixo do código

A falta de nome é a única coisa que conta como erro. Todo o resto é um aviso ou uma observação.

• URL e logo. Os dois devem ser endereços https:// completos. Um endereço de logo que não termina em extensão de imagem recebe uma observação. Um logo hospedado em rede social ou em serviço de compartilhamento de arquivos recebe um aviso, porque esses links expiram ou barram os robôs.
• Campos de negócio local. Para os tipos de negócio e de local, a falta de rua ou cidade e a falta de telefone são avisos. A falta de horários só gera uma observação. Um dia marcado sem horários é um aviso.
• Formatos. Um ZIP code dos EUA precisa ter cinco dígitos ou o formato ZIP+4. A data de fundação precisa ser um ano ou YYYY-MM-DD. Cada linha de perfil precisa ser uma URL completa. Um telefone que não pode ser convertido é mantido exatamente como você digitou.

Quando o último aviso some, a etiqueta ao lado do código mostra “Pronto para colar”.

Onde o bloco vai

Cole o bloco uma vez, na página inicial, em qualquer lugar do <head> ou do <body>. Os buscadores leem JSON-LD nos dois lugares.

• Sites escritos à mão ou estáticos: cole no template da página inicial, antes de </head>.
• WordPress: olhe primeiro o seu plugin de SEO. Yoast SEO, Rank Math e SEOPress já geram um bloco Organization a partir das configurações deles, e dois blocos concorrentes confundem mais do que ajudam. Use os campos do plugin, ou desative a saída dele e adicione o seu com um plugin de código no cabeçalho ou um bloco HTML personalizado.
• Shopify, Squarespace, Wix, Webflow: cada um tem uma opção de “código personalizado” ou “injeção de código” para o head da página inicial.

Depois teste a página no ar com os dois validadores indicados abaixo do código. O Teste de pesquisa aprimorada mostra o que o Google conseguiu interpretar. O validador do schema.org verifica o próprio vocabulário.

O bloco não se atualiza sozinho. Quando o horário ou o telefone mudar, volte aqui, edite o rascunho e cole a nova versão por cima da antiga.