diff --git a/src/coscine/metadata.py b/src/coscine/metadata.py
index 6858706e5477293267ace7833c07a547dfc65476..6e284dc0bc55ca21b8694ee6eb25e8bf37d101e1 100644
--- a/src/coscine/metadata.py
+++ b/src/coscine/metadata.py
@@ -688,6 +688,13 @@ class QueryResult:
         Computes the union between a list of files, a file (coscine.FileObject)
         property and the property reflected in the SPARQL query result
         identified via the column it appears in.
+
+        Example
+        -------
+        result = resource.query(r"SELECT ?path ?p ?o WHERE { ?path ?p ?o . }")
+        files = resource.files(recursive=True)
+        for f in result.union(files, coscine.FileObject.uri, "path"):
+            print(f.name)
         """
         result = []
         column_index = self.headers.index(column)