WooCommerce 11.0: las clases de envío pasan a privadas

WooCommerce 11.0, que sale el 28 de julio de 2026, registra la taxonomía product_shipping_class como privada (con public=false). Las clases de envío siguen funcionando igual: se crean, se asignan a productos y calculan tarifas. Lo único que cambia es que dejan de ser una taxonomía pública consultable desde el front-end.

product_shipping_class es la taxonomía interna de WooCommerce que agrupa productos para aplicar reglas de tarifas de envío. Desde WooCommerce 11.0 su registro pasa a public=false, así que is_taxonomy_viewable( 'product_shipping_class' ) devuelve false y deja de comportarse como un archivo público tipo categorías o etiquetas. El cambio, hecho en el PR #63146, alinea la taxonomía con su rol real.

WooCommerce es un plugin de código abierto para WordPress desarrollado por Automattic que permite crear tiendas de comercio electrónico en sitios basados en WordPress. Proporciona funcionalidades para gestionar productos, inventario, pagos y envíos.

¿Qué es el cambio de product_shipping_class en WooCommerce 11.0?

Ponele que armaste una tienda con clases de envío tipo «voluminoso», «frágil» o «digital» para separar tarifas. Hasta WooCommerce 10.9, WordPress trataba esa taxonomía como pública sin que nadie lo pidiera. ¿Por qué? Porque el registro original de product_shipping_class nunca declaraba el argumento public, y WordPress, ante la duda, lo asume como true.

Desde WooCommerce 11.0 eso se termina. El registro ahora fija public=false de forma explícita. El efecto concreto es este:

// WooCommerce 11.0 en adelante
is_taxonomy_viewable( 'product_shipping_class' ); // false

Es un cambio de arquitectura, no de funcionalidad. La clase de envío nunca fue pensada para tener su propia página de archivo pública tipo /tienda/clase-envio/fragil/. Que WordPress la tratara así era más un accidente heredado que una decisión. Cubrimos ese tema en detalle en información estructurada de tus productos.

¿Por qué WooCommerce hace privadas las clases de envío en la 11.0?

La razón es simple: las clases de envío son de uso interno. Sirven para agrupar productos y aplicarles reglas de tarifas, nada más. No son categorías ni etiquetas, que sí están hechas para que el cliente las vea y navegue.

Tener una taxonomía interna registrada como «pública» arrastra consecuencias molestas: WordPress le genera reglas de reescritura, la expone en algunas APIs y la hace consultable desde donde no debería. Al ponerla en public=false, el comportamiento queda alineado con lo que la taxonomía siempre fue. Ojo con un detalle técnico: cuando public es false y no se define un publicly_queryable aparte, este último hereda ese false, y is_taxonomy_viewable() devuelve justamente ese valor.

¿Afecta este cambio a la funcionalidad de envíos en mi tienda?

No. Y conviene repetirlo porque es la duda que más va a aparecer.

Las clases de envío se siguen pudiendo crear, asignar a productos, leer desde cada producto y usar en la lógica de cálculo de tarifas. Todo el flujo de envíos queda intacto. Lo confirma el propio anuncio: para la mayoría de las tiendas y extensiones, no hay que hacer nada.

El cambio es de visibilidad y de consulta pública, no de capacidad. Si tu tienda calcula «envío gratis para digitales» y «recargo para voluminosos», eso funciona el 28 de julio exactamente igual que el 27. Tema relacionado: simplificar y optimizar tu tienda.

¿Qué código se rompe con WooCommerce 11.0?

Acá viene lo que sí tenés que mirar. El cambio impacta código que asume que la taxonomía es pública. En concreto:

• Código que espera is_taxonomy_viewable( 'product_shipping_class' ) en true. Ahora devuelve false y cualquier condicional armado sobre eso cambia de rama.
• Extensiones que muestran clases de envío como archivos públicos. Si un plugin generaba una página navegable por clase, esa lógica queda sin efecto.
• Llamadas que dependían de la reescritura pública. URLs tipo archivo de taxonomía para clases de envío dejan de resolverse como antes.
• Consultas front-end que la tratan como taxonomía visible. Plantillas que la listaban de cara al cliente van a dejar de comportarse igual.

La mayoría de las tiendas no cae en ninguno de estos casos. Pero si desarrollás para clientes o mantenés un plugin propio, es media hora de revisión bien invertida.

Antes de 11.0 vs. desde 11.0: qué cambia

Aspecto	Antes de WooCommerce 11.0	Desde WooCommerce 11.0
Argumento public	No declarado (WP defaultea a true)	false explícito
is_taxonomy_viewable()	Devuelve true	Devuelve false
Crear y asignar clases	Funciona	Funciona igual
Cálculo de tarifas de envío	Funciona	Funciona igual
Archivo público navegable	Generado (aunque nadie lo usaba)	No se genera
Acción requerida	Ninguna	Ninguna para la mayoría

¿Cómo reviso si mis extensiones y código están afectados?

Antes de tocar producción, hacé una búsqueda rápida en el código de tu tema hijo y de tus plugins custom. Buscá estas tres cadenas:

• get_terms( 'product_shipping_class' ). Sigue funcionando para leer las clases, pero fijate en qué contexto lo usás.
• is_taxonomy_viewable( 'product_shipping_class' ). Acá está el cambio de valor. Revisá qué decide ese condicional.
• product_shipping_class en plantillas front-end. Si aparece en un template que se renderiza de cara al cliente, mirá qué hace.

Si sos agencia o das soporte a varias tiendas WooCommerce, la jugada limpia es esta: montá una copia de staging con la 11.0, corré tus flujos de envío y revisá el checkout. Subís el sitio, lo probás con la versión nueva, verificás que las tarifas se calculen bien, mirás que ninguna extensión tire un warning raro y recién ahí tocás producción. Si tu WordPress está en un hosting WordPress como el de Donweb, armar ese staging para probar la 11.0 antes del 28 de julio te lleva un rato y te ahorra sustos.

¿Cómo adapto mi código para WooCommerce 11.0?

Dos criterios y listo.

Primero: si tu código bifurca según la visibilidad de la taxonomía, condicioná con is_taxonomy_viewable() y aceptá que ahora da false. No pelees contra el cambio forzando la taxonomía a pública de nuevo, porque estarías yendo en contra del rol para el que existe. Te puede servir nuestra cobertura de mejorar otros aspectos de tu tienda.

Segundo: para trabajar con clases de envío, usá las funciones específicas de WooCommerce en lugar de APIs genéricas de WordPress pensadas para taxonomías públicas. Si necesitabas mostrar algo relacionado a clases de envío en el front, resolvelo con lógica propia de WooCommerce y no dependiendo de que la taxonomía sea «viewable».

Qué está confirmado y qué queda pendiente

• Confirmado: WooCommerce 11.0 sale el 28 de julio de 2026 con product_shipping_class registrada como public=false, según el anuncio oficial de developer.woocommerce.com.
• Confirmado: el cambio se hizo en el PR woocommerce/woocommerce#63146.
• Confirmado: is_taxonomy_viewable( 'product_shipping_class' ) devuelve false a partir de esta versión.
• Confirmado: la creación, asignación y el cálculo de tarifas de envío no cambian.
• Pendiente de tu lado: auditar tus extensiones y tema para ver si alguno trataba la taxonomía como pública. Eso no lo resuelve WooCommerce por vos.

Errores comunes con este cambio

• Creer que se rompen los envíos. No. El cálculo de tarifas y la asignación de clases quedan iguales. Lo que cambia es la visibilidad pública de la taxonomía, no su función.
• Forzar public=true otra vez con un filtro. Es «arreglar» algo que no está roto. Volvés a exponer una taxonomía interna y te comés los problemas que WooCommerce justo vino a sacar.
• Actualizar producción sin staging. Si tenés extensiones que tocan clases de envío, probá primero en una copia. Un checkout con tarifas mal calculadas te lo reporta el cliente, no el log.
• Asumir que get_terms() dejó de funcionar. No dejó. Podés seguir leyendo las clases; lo que cambió es is_taxonomy_viewable(), que es otra cosa.

Preguntas Frecuentes

¿Qué es el cambio de product_shipping_class en WooCommerce 11.0?

Es el paso de la taxonomía product_shipping_class a privada, con public=false explícito en su registro. Alinea las clases de envío con su rol interno de cálculo de tarifas y evita que WordPress las trate como archivos públicos. Llega con WooCommerce 11.0.

¿Cuándo sale WooCommerce 11.0?

El 28 de julio de 2026, según el anuncio oficial de WooCommerce. Ese es el día en que el cambio de la taxonomía de clases de envío entra en vigor para quienes actualicen.

¿Tengo que hacer algo antes de actualizar?

Para la mayoría de las tiendas, no hace falta ninguna acción. Si desarrollás código propio o mantenés extensiones, revisá si alguna usa is_taxonomy_viewable( 'product_shipping_class' ) esperando true o muestra clases de envío como taxonomía pública en el front-end. Sobre eso hablamos en prepararse para los cambios de versión.

Esto se relaciona directamente con cómo configurar las clases de envío en tu tienda.

¿Cómo sé si una extensión está impactada?

Buscá en su código referencias a product_shipping_class combinadas con is_taxonomy_viewable() o con plantillas front-end. Si la extensión solo crea, asigna o calcula tarifas con clases de envío, no se ve afectada. El impacto aparece cuando trata la taxonomía como públicamente visible.

¿Es obligatorio actualizar a WooCommerce 11.0 de inmediato?

No es obligatorio hacerlo el mismo 28 de julio. Conviene revisar tus extensiones y probar en staging antes de subir. Las agencias y hostings que dan soporte a WooCommerce deberían chequear a sus clientes con código custom relacionado a clases de envío.

Conclusión

El cambio de WooCommerce 11.0 con las clases de envío privadas es de esos que suenan más graves de lo que son. La taxonomía product_shipping_class pasa a public=false el 28 de julio de 2026, y lo único que se modifica es que deja de comportarse como archivo público. Los envíos, las tarifas y la asignación de clases quedan intactos.

¿Qué hacer? Si tenés una tienda estándar, nada. Si escribís código o mantenés plugins, buscá is_taxonomy_viewable( 'product_shipping_class' ) y cualquier uso de la taxonomía en plantillas front-end, probá en staging y actualizá tranquilo. Es un cambio de higiene técnica, y la 11.0 lo hace bien.

Fuentes

• Developer WooCommerce – Anuncio oficial: Product shipping class taxonomy will be private in WooCommerce 11.0
• GitHub – PR woocommerce/woocommerce#63146 que fija public=false
• Developer WooCommerce – Documentación de la REST API v3