diff --git a/include/zenoh_commons.h b/include/zenoh_commons.h
index 3fa477cd3..53c80c75c 100644
--- a/include/zenoh_commons.h
+++ b/include/zenoh_commons.h
@@ -863,6 +863,12 @@ typedef struct zc_owned_liveliness_get_options_t {
  * functions, then the operation will fail (but the passed value will still be consumed).
  */
 typedef struct z_owned_buffer_t zc_owned_payload_t;
+/**
+ * An owned sample.
+ *
+ * This is a read only type that can only be constructed by cloning a `z_sample_t`.
+ * Like all owned types, its memory must be freed by passing a mutable reference to it to `zc_sample_drop`.
+ */
 typedef struct zc_owned_sample_t {
   struct z_owned_keyexpr_t _0;
   struct z_owned_buffer_t _1;
diff --git a/src/commons.rs b/src/commons.rs
index 085a0df5a..555a380be 100644
--- a/src/commons.rs
+++ b/src/commons.rs
@@ -242,6 +242,10 @@ pub extern "C" fn z_sample_attachment(sample: &z_sample_t) -> z_attachment_t {
     }
 }
 
+/// An owned sample.
+///
+/// This is a read only type that can only be constructed by cloning a `z_sample_t`.
+/// Like all owned types, its memory must be freed by passing a mutable reference to it to `zc_sample_drop`.
 #[repr(C)]
 pub struct zc_owned_sample_t {
     _0: z_owned_keyexpr_t,