diff --git a/lib/Catmandu/Fix/rename.pm b/lib/Catmandu/Fix/rename.pm
index b8035495a..aa322bad8 100644
--- a/lib/Catmandu/Fix/rename.pm
+++ b/lib/Catmandu/Fix/rename.pm
@@ -56,6 +56,12 @@ __END__
 
 Catmandu::Fix::rename - rename fields with a regex
 
+=head1 SYNOPSIS
+
+   # ns => {'ns.foo' => 'val', list => {'ns.bar' => 'val'}}
+   rename(ns, '\.', '')
+   # ns => {'foo' => 'val', list => {'bar' => 'val'}}
+
 =head1 SEE ALSO
 
 L<Catmandu::Fix>