NuevoBlack Friday: 50 % de descuento en tu primer pago
Volver al blog

WooCommerce 11.1 y 11.2: novedades y qué puede fallar

WooCommerce 11.1 añade desistimiento en la UE y reembolsos en la API REST; 11.2 cambia hooks de producto. Qué revisar antes de actualizar tu tienda.

WooCommerce 11.1 y 11.2: novedades y qué puede fallar

WooCommerce publica una nueva versión menor aproximadamente cada mes, y en este momento hay dos lanzamientos en el radar: la versión 11.1, que añade varias funciones realmente útiles para comerciantes y desarrolladores de API, y la versión 11.2, que se perfila como una actualización de rendimiento que cambia discretamente la forma en que se disparan algunos de los hooks más utilizados del plugin. Si gestionas una tienda WooCommerce o mantienes código personalizado para una, conviene entender ambas antes de que lleguen a tu sitio en producción.

Esta guía repasa lo que está confirmado para WooCommerce 11.1, lo que WooCommerce ya ha adelantado sobre los cambios en los hooks de producto de la versión 11.2 y cómo preparar cualquiera de las dos actualizaciones sin romper el pago, tus plugins personalizados o tu catálogo de productos.

Resumen (TL;DR)

  • WooCommerce 11.1 (en beta en el momento de redactar este artículo, con lanzamiento final previsto para el 1 de septiembre de 2026) añade un flujo de desistimiento de pedidos para la UE, mejoras de reembolsos en la API REST, verificación del total en el pago y varias correcciones de rendimiento y errores para productos variables y la importación/exportación CSV.
  • WooCommerce 11.2 aún no ha publicado sus notas de versión completas, pero el blog para desarrolladores de WooCommerce ya ha advertido de un cambio importante (breaking change): al guardar y reordenar productos se omitirán algunas llamadas a hooks que antes se ejecutaban en cada petición, como optimización de rendimiento.
  • Si algún plugin o código personalizado de tu sitio se engancha a set_object_terms, woocommerce_after_single_product_ordering o woocommerce_after_product_ordering, debe revisarse antes de actualizar a la versión 11.2.
  • Haz una copia de seguridad de tu tienda y prueba ambas actualizaciones en una copia de staging antes de tocar producción, especialmente si ejecutas código personalizado en torno a productos o al proceso de pago.

Novedades de WooCommerce 11.1

A finales de agosto de 2026, WooCommerce 11.1 se encuentra en fase beta, con un lanzamiento final estable previsto por WooCommerce para el 1 de septiembre de 2026. Los números de versión beta y las fechas exactas pueden variar, así que consulta el changelog de WooCommerce para comprobar el estado actual antes de planificar una actualización. Las funciones siguientes son las que WooCommerce ha documentado hasta ahora para esta versión.

Soporte de desistimiento de pedidos en la UE

WooCommerce 11.1 introduce un flujo integrado de desistimiento de pedidos, pensado para comerciantes que necesitan cumplir con la normativa de la UE sobre el derecho de desistimiento en compras online. Los propietarios de tiendas pueden activarlo en WooCommerce → Ajustes → Avanzado → Funciones. Una vez habilitado, los clientes disponen de una nueva página en su cuenta en /my-account/withdraw-order/ desde la que pueden enviar una solicitud de desistimiento para un pedido elegible. Las solicitudes que coincidan con un pedido existente por correo electrónico y número de pedido se vinculan automáticamente a ese pedido, y el comerciante recibe una notificación además de un aviso en la bandeja de entrada de WooCommerce.

Es una pieza útil, pero no una solución integral de cumplimiento normativo. Te ofrece una forma estructurada de recibir y hacer seguimiento de las solicitudes de desistimiento, pero confirmar si tu política de devoluciones, plazos y gestión de reembolsos cumplen con la legislación de protección al consumidor de la UE sigue siendo algo que debes validar con tu propio asesor legal, no algo que la actualización de un plugin pueda garantizar por sí sola.

Mejoras en los reembolsos de la API REST

Los desarrolladores que trabajan con la API REST de WooCommerce reciben dos mejoras para los reembolsos de pedidos. El endpoint de reembolso existente (POST /wc/v3/orders/{id}/refunds) ahora acepta el parámetro compute_totals para que el servidor pueda recalcular los importes del reembolso en lugar de obligar al cliente a hacer ese cálculo. También incorpora un nuevo endpoint de vista previa, POST /wc/v3/orders/{id}/refunds/preview, que permite validar un reembolso antes de aplicarlo realmente — conviene confirmarlo en el changelog definitivo cuando salga la versión 11.1, ya que las rutas exactas en funciones beta pueden cambiar antes del lanzamiento. Si has creado herramientas de reembolso a medida, un panel de soporte o una integración de marketplace sobre la API de WooCommerce, esto elimina lógica de cálculo duplicada y reduce el riesgo de que una solicitud de reembolso falle después de haber indicado al cliente que se realizó con éxito.

Verificación del total en el pago

El endpoint de pago de la Store API incorpora un campo opcional expected_total. Si el cliente envía un total esperado que no coincide con lo que WooCommerce calcula en el servidor, la petición se rechaza con un error en lugar de completarse silenciosamente con un precio distinto. Esto cierra toda una clase de fallos de discrepancia de precios que pueden surgir en flujos de pago personalizados, tiendas headless o extensiones de pago de terceros cuando los totales del cliente y del servidor pierden sincronización, por ejemplo tras cambiar un cupón, una regla de impuestos o un método de envío a mitad de sesión.

Correcciones de rendimiento y fiabilidad

Varias correcciones se centran en áreas que afectan a tiendas con catálogos más grandes:

  • La importación y exportación CSV de productos reciben correcciones para conservar los términos al volver a subir archivos, evitar el borrado no deseado de imágenes y mejorar el manejo de divisas, además de una mejor gestión al crear variaciones durante la importación.
  • Los productos variables obtienen múltiples reducciones en el número de consultas (correcciones «N+1») en la carga de variaciones, las búsquedas de atributos y el almacenamiento en caché de precios, tanto en el editor de productos como en la tienda pública.
  • El registro de bloques ahora se omite en peticiones cron, AJAX y REST cuando no es necesario, reduciendo la sobrecarga en ese tipo de peticiones y manteniendo disponible el registro bajo demanda donde realmente hace falta.

Ninguna de estas mejoras es una función llamativa de portada, pero son el tipo de cambio que más se nota conforme crece tu catálogo de productos, y merece la pena probarlas si gestionas una tienda con muchos productos variables o dependes de importaciones CSV frecuentes.

Otros cambios orientados a desarrolladores

Hay varios cambios menores que conviene conocer si mantienes código personalizado o extensiones:

  • is_rest_api_request() ahora detecta correctamente las peticiones que usan el parámetro de consulta ?rest_route=, no solo las URL REST con enlaces permanentes bonitos.
  • ProductGalleryUtils::get_product_gallery_image_count() queda obsoleta (deprecated).
  • Se ha reordenado el marcado HTML del selector de cantidad para mejorar la accesibilidad con lectores de pantalla y navegación por teclado (cumplimiento WCAG).
  • Se han actualizado los símbolos de moneda para MOP y ZMW.
  • Los proveedores de contenido incrustable del editor de correos electrónicos se han ampliado para incluir YouTube, Vimeo, VideoPress, TikTok y Dailymotion, y los callbacks de etiquetas de personalización ahora reciben un parámetro con el tipo de contenido de destino para que las etiquetas se escapen correctamente en correos HTML frente a correos de texto plano.

También forman parte del lanzamiento dos funciones experimentales opcionales: un enfoque unificado de carga de recursos para el editor de bloques — que según WooCommerce reduce de forma significativa la cantidad de recursos del editor y peticiones de red en sus propias pruebas — y un marco inicial de almacenamiento, activado mediante feature flag, para vídeos en la galería de productos. Ambas son opcionales dentro de Funciones experimentales y no necesitas tocarlas para aprovechar el resto de mejoras de la versión 11.1.

WooCommerce 11.2: lo que ya se ha comunicado

WooCommerce aún no ha publicado las notas de versión completas de la 11.2, por lo que en el momento de escribir estas líneas no hay una fecha de lanzamiento confirmada. Lo que sí se ha publicado es un aviso para desarrolladores sobre un cambio importante (breaking change) que llegará a la forma en que el guardado y la reordenación de productos disparan sus hooks. WooCommerce publica estos avisos antes de un lanzamiento precisamente porque el cambio puede romper silenciosamente plugins y código personalizado, así que conviene planificarlo ahora en lugar de esperar a las notas de versión completas.

Al guardar productos se omitirán algunas llamadas a hooks

El proceso de guardado de productos de WooCommerce llama actualmente a wp_set_object_terms() y delete_post_meta() incluso cuando los valores que se guardan ya coinciden con los almacenados. En la versión 11.2, esas llamadas se omitirán cuando nada haya cambiado realmente, lo que según WooCommerce puede reducir las consultas SQL por guardado hasta en un 45 % en tiendas con muchos productos.

El efecto práctico: el hook set_object_terms se disparará con menos frecuencia que hoy, porque solo se ejecutará cuando cambie realmente la asignación de un término. Si tú (o un plugin del que dependes) tienes código como:

php
add_action( 'set_object_terms', 'my_custom_sync_function', 10, 6 );

y ese código asume que el hook se dispara en cada guardado de producto independientemente de si cambiaron categorías, etiquetas o atributos, puede dejar de ejecutarse en situaciones en las que antes sí lo hacía. La recomendación de WooCommerce es comprobar si tu callback necesita realmente un evento de cambio de término o si en realidad intenta reaccionar a cualquier guardado de producto; en este último caso, hooks como woocommerce_update_product o save_post_product son la opción más fiable de cara al futuro.

La reordenación de productos estrena algoritmo

WooCommerce también está reemplazando el algoritmo subyacente que se utiliza al reordenar productos mediante arrastrar y soltar en la vista del catálogo del administrador. El enfoque actual reindexa todo el catálogo en cada reordenación; el nuevo utiliza posicionamiento por rangos para modificar únicamente los productos que realmente se movieron, algo muy importante en tiendas con catálogos grandes donde reindexar por completo resulta costoso.

Quedan obsoletos (deprecated) dos hooks relacionados:

  • woocommerce_after_single_product_ordering
  • woocommerce_after_product_ordering

Se sustituyen por dos hooks más específicos:

  • woocommerce_product_ordering_process_reindexed_products, que se dispara tras una reindexación completa del catálogo
  • woocommerce_product_ordering_process_moved_products, que se dispara tras reposicionar productos concretos

clean_post_cache sigue disparándose como antes y no se ve afectado. Si tu código sigue enganchado a las acciones de ordenación obsoletas, seguirá funcionando, pero WooCommerce advierte de que usarlas provoca un retroceso (fallback) al antiguo algoritmo de reordenación sin optimizar, por lo que renunciarías a la mejora de rendimiento en lugar de recibir un error.

A quién afecta realmente esto

Si no ejecutas plugins personalizados, mu-plugins ni código en el tema que se enganche al guardado o a la reordenación de productos, este cambio es prácticamente invisible; el núcleo de WooCommerce y sus funciones integradas ya lo contemplan. Importa sobre todo a agencias y desarrolladores que mantienen herramientas personalizadas de sincronización de catálogos, plugins multivendedor o de marketplace, integraciones de inventario o ERP de terceros y cualquier herramienta de administración que reaccione cuando se reordenan o reetiquetan productos. Si esa es tu situación, merece la pena buscar ahora en tu base de código los nombres de hooks anteriores para no tener que depurar un fallo silencioso la semana en que salga la versión 11.2.

¿Conviene actualizar ahora? Lista de comprobación práctica

Ninguna de las dos versiones es un parche de seguridad de emergencia, así que no hay necesidad de precipitar ninguna actualización en una tienda en vivo el mismo día en que esté disponible. Un proceso breve y metódico te ahorrará más tiempo del que cuesta:

  1. Haz una copia de seguridad reciente antes de tocar nada. MagicWP incluye copias de seguridad bajo demanda que puedes lanzar justo antes de actualizar un plugin o el núcleo, además de las copias automáticas diarias, para tener siempre un punto de restauración limpio si algo sale mal.
  2. Clona tu sitio a un entorno de staging. Prueba ahí la actualización primero, nunca en producción. Ahí es también donde detectarás un desajuste en el total del pago, una importación CSV rota o un plugin personalizado que dejó de sincronizar términos de producto en silencio.
  3. Busca en tu código los nombres de hooks anteriores. Una simple búsqueda global de set_object_terms, woocommerce_after_single_product_ordering y woocommerce_after_product_ordering te dirá en unos minutos si la versión 11.2 requiere algún cambio en tu código.
  4. Revisa los changelogs de tus extensiones activas de WooCommerce en busca de notas explícitas de compatibilidad con 11.1 o 11.2 antes de actualizar producción, especialmente en pasarelas de pago, plugins de suscripciones e integraciones de inventario.
  5. Actualiza producción en horas de poco tráfico y vigila de cerca los registros de errores y el flujo de pedidos durante las primeras horas posteriores.
  6. Si dependes de la API REST o de la Store API de WooCommerce, prueba específicamente la creación de reembolsos y el envío del pago en la actualización de staging, ya que ambos cambian de comportamiento en la versión 11.1.

Preguntas frecuentes

¿Cuándo se lanza oficialmente WooCommerce 11.1? A finales de agosto de 2026, WooCommerce 11.1 está en fase beta con un lanzamiento final previsto para el 1 de septiembre de 2026. Los plazos de las betas pueden cambiar, así que confirma el estado actual en el changelog oficial de WooCommerce antes de contar con una fecha concreta.

¿Está disponible ya WooCommerce 11.2? No. Por ahora solo se ha publicado un aviso para desarrolladores sobre los próximos cambios en los hooks de producto; en el momento de redactar este artículo todavía no se han anunciado las notas de versión completas ni la fecha de lanzamiento de la 11.2.

¿WooCommerce 11.1 romperá mi sitio? Para la mayoría de las tiendas, no. Los cambios son aditivos (nuevos endpoints, una nueva opción opcional en ajustes y correcciones de rendimiento). El riesgo principal recae en flujos de pago personalizados o integraciones de API que aún no contemplen la nueva verificación expected_total, ya que un total que no coincida ahora será rechazado en lugar de aceptarse en silencio.

¿Qué es la función de desistimiento de pedidos para la UE en WooCommerce 11.1? Es un flujo integrado y opcional que permite a los clientes enviar una solicitud de desistimiento para un pedido desde la página de su cuenta y notifica al comerciante cuando lo hacen. Es una herramienta para ayudar a gestionar las solicitudes de desistimiento, no una garantía de que tu tienda cumpla los requisitos de protección al consumidor de un país concreto.

¿Necesito actualizar código personalizado antes de WooCommerce 11.2? Solo si tu código se engancha a set_object_terms esperando que se dispare en cada guardado de producto, o a las acciones ahora obsoletas woocommerce_after_single_product_ordering / woocommerce_after_product_ordering. Si ninguno de tus plugins ni tu código personalizado utilizan esos hooks, no hace falta hacer cambios.

¿Cómo pruebo una actualización de WooCommerce de forma segura? Clona tu sitio en vivo a un entorno de staging, aplica primero allí la actualización y recorre tus flujos habituales de pago, reembolsos y gestión de productos antes de actualizar producción. Una herramienta de staging en un clic hace que esto sea lo bastante rápido como para hacerlo en cada actualización, no solo en las versiones principales.

¿Qué ocurre si sigo usando los hooks obsoletos de reordenación de productos? Seguirán disparándose, pero WooCommerce indica que usarlos hace que la tienda vuelva al algoritmo de reordenación antiguo y sin optimizar en lugar del nuevo algoritmo basado en rangos, por lo que conservas la funcionalidad pero pierdes la mejora de rendimiento.

¿Debería actualizar a WooCommerce 11.1 en cuanto se publique? No hace falta precipitarse el mismo día. Deja pasar unos días por si surgen avisos tempranos de errores, pruébalo primero en staging y luego actualiza producción en una franja horaria de poco tráfico.

Conclusión

WooCommerce 11.1 es un lanzamiento sólido y práctico: una función realmente útil orientada al cumplimiento con el desistimiento de pedidos, mejoras reales en la API de reembolsos para quien desarrolla sobre WooCommerce, una salvaguarda en el pago que cierra una brecha real de integridad de precios y un lote de correcciones de rendimiento que suman en catálogos grandes. WooCommerce 11.2, incluso antes de publicar sus notas de versión completas, ya ha anticipado el cambio de mayor calado para los desarrolladores: los hooks de guardado y reordenación de productos se están optimizando de formas que pueden dejar de dispararse en silencio en código que daba por hecho el comportamiento anterior. Ninguna actualización es motivo de alarma, pero ambas recompensan un poco de preparación: una búsqueda de nombres de hooks en tu código, una prueba en staging y una copia de seguridad antes de tocar producción.

Si estás valorando un alojamiento que convierta ese tipo de pruebas seguras en rutina en lugar de una molestia, el alojamiento gestionado para WooCommerce de MagicWP incluye staging en un clic y copias de seguridad bajo demanda, de modo que probar una nueva versión de WooCommerce te lleve unos minutos en lugar de una tarde llena de riesgos.

A
Alex
MagicWP
Writing about WordPress, performance, and the infrastructure that makes sites fast.

Recibe lo mejor de MagicWP en tu bandeja de entrada.

Notas técnicas mensuales, novedades del producto y consejos sobre el rendimiento de WordPress. Sin spam, puedes cancelar la suscripción en cualquier momento.

Notas técnicas y novedades del producto cada mes.