Filtro por atributo do WooCommerce vazio: global x personalizado

Você abriu o produto, foi na aba Atributos, digitou Cor com o valor Azul, salvou — e o bloco Filtrar por atributo não lista Cor em canto nenhum. Não é bug do tema: o WooCommerce só filtra por atributo global, aquele criado em Produtos > Atributos, que vira a taxonomia pa_cor. O digitado na ficha do produto é só texto na meta _product_attributes.

Descubra em qual dos dois está o seu

O atributo personalizado aparece na meta com is_taxonomy igual a 0 e a chave sem prefixo. O global aparece com is_taxonomy igual a 1 e a chave começando em pa_. Dois comandos matam a dúvida:

cd /var/www/sualoja/html
sudo -u www-data wp post meta get 1234 _product_attributes --format=json
sudo -u www-data wp taxonomy list --field=name | grep '^pa_'

Migrar e regerar a tabela de lookup

Crie o atributo global, os termos, e só então reatribua no produto. Falta ainda o passo que quase todo mundo pula: a contagem do filtro sai da tabela wc_product_attributes_lookup — com o prefixo da instalação na frente, wp_ por padrão — e enquanto ela não for regerada o bloco continua vazio ou com número errado.

sudo -u www-data wp wc product_attribute create 
  --name="Cor" --slug="cor" --type=select --user=1

sudo -u www-data wp term create pa_cor "Azul" --slug=azul

sudo -u www-data wp wc tool run regenerate_product_attributes_lookup_table --user=1

O --slug="cor" é sem prefixo mesmo: o WooCommerce acrescenta o pa_ ao registrar a taxonomia. A regeração roda em lote pelo Action Scheduler nas lojas grandes, então dê um tempo antes de conferir a vitrine.

A armadilha de sobrar os dois

Depois de migrar, o atributo antigo continua vivo em _product_attributes. A aba Informações adicionais passa a mostrar Cor duas vezes, uma clicável e outra não. Apague a linha antiga na ficha do produto antes de salvar a nova.

Se travou nisso e precisa de ajuda, me chama aqui.