El bloque de notas en el editor de WordPress: cómo se usan, controlan e incluso eliminan si no las quieres

El sistema de notas dentro del editor de bloques de WordPress (desde WordPress 6.9) está diseñado para mejorar la colaboración entre autores, editores y clientes.

En este artículo te explicaré lo más detalladamente posible cómo funcionan estas notas, quién pueden usarlas, posibles casos de uso, implicaciones de privacidad, y cómo desactivarlas o gestionarlas de forma segura.

Qué es el sistema de notas del editor

• Se llama Notes (notas), previamente llamadas «block-level comments» o «inline comments» en Gutenberg.
• Permite dejar comentarios contextuales en bloques individuales dentro del editor de bloques.
• Está pensado para la colaboración asíncrona: equipos, editores, autores pueden dejar feedback directamente en el contenido sin salir del editor.
• Las notas no aparecen en el sitio público: son internas del editor y no se muestran al visitante.
• Pueden tener hilos de conversación (respuestas anidadas) y marcarse como resueltas.
• Por defecto solo está disponible en entradas y páginas, pero se pueden añadir a más tipos de contenido mediante hooks.

Quién puede usar las notas

• Usuarios con capacidad edit_post (por defecto todos menos los suscriptores).
• Los administradores y editores ven todas las notas.
• Los usuarios con perfiles de autor o colaborador solo ven notas en contenidos que hayan escrito.
• Los suscriptores no tienen acceso.

Cómo usar las notas

1. En el editor, selecciona un bloque al que quieras añadir una nota.
2. Haz clic en el menú de tres puntos → Añadir nota.
3. Escribe tu nota en los ajustes que se abren en una ventanita emergente en el lado derecho de la pantalla del editor.
4. Otros usuarios pueden responder a esa nota, generando un hilo de conversación.
5. Cuando un punto esté resuelto, puedes marcar la nota como «resuelta», lo que cambia su estado.
6. Todas las notas se pueden ver desde un panel superior del editor, y al hacer clic en una nota, se centra en el bloque correspondiente.

Lo puedes ver en estas capturas…

Cómo están implementadas internamente

• Las notas se guardan como comentarios (wp_comments) en la base de datos, con comment_type = 'note'.
• Se pueden consultar por código mediante las APIs de comentarios habituales, filtrando por type = 'note'.
• Existe también integración con la REST API: se pueden recuperar notas vía petición REST.
• El estado de una nota (abierta, resuelta, eliminada) se representa con el campo comment_status:
  • Abierta: comment_status = 0 (“hold”)
  • Resuelta: comment_status = 1 (“approve”)
  • Si se borra, va a la papelera, como un comentario más, salvo que tengas activa en wp-config.php la constante EMPTY_TRASH_DAYS = 0

Limitaciones y consideraciones técnicas

Algunas cosas a tener en cuenta porque no son perfectas aún.

Limitaciones del sistema

• Notas duplicadas: Una nota puede quedar asociada a más de un bloque. Si duplicas un bloque con nota o lo partes, la nota puede ir a ambos.
• No hay una referencia directa desde la nota al bloque (no hay un campo block ID en la nota). Para saber a qué bloque corresponde una nota, se busca el noteId en los metadatos del bloque.
• No se puede hacer una nota fragmentada dentro de un bloque (por ejemplo, seleccionar unas palabras dentro de un párrafo): de momento la nota se asocia al bloque completo.

Flujo de notificaciones

• Cada nueva nota envía un correo a los autores o responsables según la configuración.
• En proyectos grandes, puede generar spam de notificaciones si no se controla. Conviene revisar ajustes de correo o implementar filtros propios.

Compatibilidad con Gutenberg y editores de bloques

• El sistema de notas depende de la infraestructura de Gutenberg. Si un sitio todavía usa mucho el editor clásico o plugins que reemplazan el editor (tipo Elementor, Divi, WPBakery) las notas no funcionan.
• En entornos mixtos, puede ser confuso porque las notas solo aparecen en el editor de bloques.

Implicaciones de rendimiento

• Cada nota se guarda como comentario. En sitios muy grandes, con cientos o miles de notas, la carga de los hilos en el editor podría afectar ligeramente la velocidad del editor.
• Esto es especialmente relevante si también se usan muchos plugins de auditoría o REST API que consultan comentarios.

Gestión de notas huérfanas

• Si borras un bloque que contiene una nota, la nota queda huérfana.
• Puede ser necesario limpiar notas antiguas o resueltas periódicamente para no acumular basura en la base de datos.

Consideraciones de seguridad y privacidad

• Aunque no se muestran públicamente, las notas son comentarios internos, por lo que cualquier usuario con permisos de edición puede verlas.
• Si trabajas con clientes o colaboradores externos, conviene controlar quién tiene acceso a cada tipo de contenido.
• No existe cifrado adicional ni restricción por tipo de nota; todo se basa en permisos de post.

Limitaciones de la API

• La REST API y los filtros disponibles son suficientes para la mayoría de desarrollos, pero aún no hay soporte completo para:
  • Notas asociadas a fragmentos de bloque (solo bloque completo).
  • Notas con metadatos adicionales complejos sin hacer desarrollos propios.

Privacidad y cumplimiento con la Ley de Protección de Datos (RGPD)

WordPress trata las notas como comentarios internos (comment_type = 'note'). Esto tiene varias implicaciones para la privacidad y la gestión de datos.

Exportación de datos de un usuario

• Cuando un usuario solicita exportar sus datos mediante el sistema nativo de WordPress (Herramientas → Exportar datos personales):
  • El exportador de comentarios (export_personal_data) debería exportar también las notas que haya creado como comentarios, pero no lo hace (adjunto captura)
  • O sea, que actualmente las notas NO están cubiertas por el flujo estándar de exportación de datos personales.

Solicitud de borrado de datos de un usuario

• Al solicitar la eliminación de sus datos, WordPress también procesa los comentarios del usuario.
  • Las notas creadas por ese usuario se pueden marcar para eliminación de la misma forma que cualquier comentario:
    • comment_approved se cambia a trash o se elimina completamente según la política de borrado.
  • Esto significa que, si un usuario pide borrado de sus datos, sus notas también deberían eliminarse, cumpliendo con el RGPD.

Consideraciones prácticas

• Las notas siguen el flujo estándar de comentarios, así que no hay una gestión separada de privacidad pero al menos actualmente no las incluye en el proceso estándar.
• En sitios con muchos colaboradores, conviene documentar internamente que las notas contienen datos personales si pueden identificar al autor, pero lo malo es que de momento no podemos cumplir la legislación.
• Los plugins de auditoría o exportación de datos avanzados esperemos que pronto incluyan el comment_type = 'note' para que los datos de las notas se procesen correctamente.
• Si desactivas las notas mediante alguno de los métodos que explico en este artículo (u otro) los datos existentes en la base de datos no se eliminan automáticamente, solo se desactivan u ocultan las notas a partir de ese momento. Para cumplir el RGPD también habría que eliminarlos manualmente si se solicita.

En resumen:

• NO, las notas no se exportan con el sistema nativo de WordPress si un usuario solicita sus datos.
• Sí, se pueden eliminar cuando un usuario solicita el borrado, siguiendo el mismo flujo que los comentarios normales.

Futuro previsto / mejoras (para próximas versiones)

Según el equipo de desarrollo ya hay ideas para mejorar las notas en versiones futuras (como WP 7.0):

• Notas fragmentadas: poder apuntar a partes más pequeñas de un bloque
• Menciones a usuarios con @: para notificar a personas concretas en las notas
• Mejoras en las notificaciones: por ejemplo, que haya digest en lugar de un correo por nota
• Diseño más adaptado a pantallas grandes, con estructura flotante para las notas
• Notas en plantillas, no solo en el contenido normal
• Colaboración en tiempo real con notas.

Cómo desactivar o limitar las notas

Aunque aún no hay nada documentando, revisando el código de cómo están incluidas en WordPress algo se puede hacer…

Eliminar las notas de todos los tipos de contenido

Con esto las quitas del todo, simplemente no cargan:

add_action( 'init', function() {
foreach ( get_post_types( [ 'public' => true ], 'names' ) as $type ) {
remove_post_type_support( $type, 'notes' );
}
} );

Eliminar las notas por tipo de contenido

Si tienes dudas, con este código las quitas selectivamente, en el ejemplo de entradas y páginas:

add_action( 'init', function() {
remove_post_type_support( 'post', 'notes' );
remove_post_type_support( 'page', 'notes' );
} );

Ocultar la interfaz en el editor (solo visual)

Si quieres algo menos brusco puedes ocultar la interfaz sin desactivar el sistema:

add_action( 'enqueue_block_editor_assets', function() {
wp_add_inline_style(
'wp-block-editor',
'.edit-post-notes-panel, 
.editor-notes-panel, 
.components-notes__button, 
.components-notes__popover, 
.block-editor-block-notes { display:none!important; }'
);
} );

Esto no deja al usuario usar notas desde la interfaz, pero no toca capacidades.

Bloquear notas mediante permisos (si es que cuando me pongo…)

Como las notas necesitan la capacidad de edit_post, de repente caí en que puedes filtrar capacidades para impedir que ciertos perfiles de usuario las utilicen, sin quitar acceso general a la edición:

add_filter( 'user_has_cap', function( $allcaps, $caps, $args, $user ) {
// $args[0] == capability, ej: 'edit_post'
// Si quieres bloquear notas solo a autores/colaboradores
if ( in_array( 'author', $user->roles, true ) || in_array( 'contributor', $user->roles, true ) ) {
$allcaps['edit_post'] = false;
}
return $allcaps;
}, 10, 4 );

add_action( 'enqueue_block_editor_assets', function() {
wp_deregister_script( 'wp-notes' );
wp_deregister_script( 'wp-notes-editor' );
} );

Esto depende de cómo WordPress nombre los bundles y puede romperse en cualquier versión, así que es el método menos recomendado.

¿Cuál recomiendas?

• Si lo que quieres es eliminar de verdad la funcionalidad, el método de desactivación de soporto es el más seguro porque respeta cómo WP registra el soporte nativo.
• Si simplemente quieres que la gente no las use, la opción de ocultar la interfaz con CSS es suficiente, pero menos eficiente en cuanto a rendimiento.

Cómo gestionar las notas en la base de datos

Se pueden borrar las notas de la base de datos sin borrar comentarios, se puede hacer de forma segura porque, como ya he mencionado, las notas son solo comentarios con comment_type = 'note'. Eso significa que no afectan a los comentarios normales (comment_type = '' o comment_type = 'pingback/trackback').

Borrar todas las notas sin borrar los comentarios normales

Aquí tienes un ejemplo de snippet que puedes usar en tu archivo functions.php, en un mu-plugin o como prefieras para borrar todas las notas sin tocar otros comentarios:

add_action( 'init', function() {
global $wpdb;

// Borrar todos los comentarios de tipo 'note'
$wpdb->query( "DELETE FROM {$wpdb->comments} WHERE comment_type = 'note'" );

// Si quieres también vaciar los metadatos asociados
$wpdb->query( "
DELETE cm FROM {$wpdb->commentmeta} cm
LEFT JOIN {$wpdb->comments} c ON c.comment_ID = cm.comment_id
WHERE c.comment_ID IS NULL
" );
} );

Detalles importantes:

• Solo borra las notas, no comentarios normales.
• La segunda consulta limpia cualquier metadato huérfano que pueda haber quedado.
• Se puede ejecutar una sola vez (no hace falta que esté en init permanente), o envolverlo en un comando tipo WP-CLI para mayor seguridad.

Cuidado: esto elimina las notas de forma irreversible, asegúrate de hacer un backup antes.

Borrar solo notas resueltas o huérfanas

Aquí tienes un snippet que borra solo las notas resueltas o huérfanas, dejando intactas las que están activas o pendientes:

add_action( 'init', function() {
global $wpdb;

// Borrar solo notas resueltas (comment_approved = 'approve') o huérfanas (bloques borrados)
$wpdb->query( "
DELETE c FROM {$wpdb->comments} c
LEFT JOIN {$wpdb->posts} p ON p.ID = c.comment_post_ID
WHERE c.comment_type = 'note'
AND (c.comment_approved = 'approve' OR p.ID IS NULL)
" );

// Limpiar metadatos huérfanos asociados a las notes eliminadas
$wpdb->query( "
DELETE cm FROM {$wpdb->commentmeta} cm
LEFT JOIN {$wpdb->comments} c ON c.comment_ID = cm.comment_id
WHERE c.comment_ID IS NULL
" );
} );

Cómo funciona:

1. Filtrado por tipo note: no toca comentarios normales.
2. Notas resueltas: comment_approved = 'approve'.
3. Notas huérfanas: el bloque/post asociado ya no existe (p.ID IS NULL).
4. Limpieza de metadatos: elimina cualquier dato relacionado que quede huérfano.

Esta última opción es segura para sitios colaborativos, ya que no borra notas activas, solo las que ya están cerradas o huérfanas.

Utilidad real y casos de uso

El sistema de notas del editor de WordPress no es solo un extra sino una herramienta que puede mejorar la colaboración y el flujo editorial en diferentes contextos:

Revisión de contenido en equipo

• Los equipos de redactores, editores y correctores pueden dejar comentarios directamente en los bloques de un artículo o página.
• Las notas les permiten centrar el feedback en el lugar exacto del contenido, evitando confusiones sobre a qué párrafo o sección se refiere el comentario.
• Se pueden marcar como resueltas, dejando un historial claro de lo que ya se ha revisado.
• Queda un historial de notas resueltas para un flujo de trabajo más claro.

Aprobación de contenido por clientes

• Si gestionas contenidos para clientes, puedes dejar notas explicativas o sugerencias dentro de la propia página en desarrollo.
• Los clientes también pueden dejar a su vez notas sobre contenido aún en fase de revisión.
• Los clientes solo verán las notas cuando accedan al editor (si tienen permisos), lo que evita emails con comentarios dispersos o documentos separados.

Documentación interna y colaboración remota

• Para sitios grandes o proyectos con varios colaboradores, las notas pueden servir como recordatorios internos, explicando por qué se ha usado cierto bloque, plantilla o diseño.
• Es útil para equipos distribuidos geográficamente: cada miembro puede dejar su comentario y el equipo puede resolverlo de forma asincrónica.

Integración con flujos de trabajo avanzados

• Plugins de gestión de proyectos o automatizaciones pueden aprovechar las notas mediante la REST API para generar informes de feedback, automatizar auditorías, informes de tareas pendientes, listas de revisión de contenido o exportación de notas.
• También se pueden usar para auditorías internas: dejar notas sobre SEO, accesibilidad o revisión de contenidos dentro de los bloques correspondientes.

Conclusión y resumen

Aunque de entrada parezca un detalle menor, las notas son especialmente útiles en sitios con múltiples autores o clientes, donde la comunicación directa dentro del contenido puede ahorrar mucho tiempo y errores. Para sitios personales o blogs individuales probablemente no sean necesarias, y ahí sí tiene sentido desactivarlas.

El sistema de notas introducido en WordPress 6.9 puede ser una herramienta potente para colaboración interna:

• Para blogs personales probablemente no sean necesarias.
• Se pueden desactivar, ocultar o limpiar mediante snippets según necesidades.
• La gestión de privacidad y cumplimiento RGPD NO está cubierta, así que en esto hay que tener cuidado con los datos existentes en la base de datos y encontrar pronto un modo de gestionarlos.

Y, para terminar, por si te ha parecido muy largo el artículo, te lo resumo en una bonita tabla:

¿Te gustó este artículo? ¡Ni te imaginas lo que te estás perdiendo en YouTube!