diff --git a/querydsl-docs/src/main/docbook/en-US/content/tutorials/sql.xml b/querydsl-docs/src/main/docbook/en-US/content/tutorials/sql.xml
index 6ca439afb..498164d37 100644
--- a/querydsl-docs/src/main/docbook/en-US/content/tutorials/sql.xml
+++ b/querydsl-docs/src/main/docbook/en-US/content/tutorials/sql.xml
@@ -346,6 +346,42 @@
 
     <para>Imports can be used to add cross-schema foreign keys support.</para>
 
+    <para>Schemas, tables and columns can also be renamed using the plugin. Here are some examples:</para>
+    <para>Renaming a schema:</para>
+    <programlisting language="xml"><![CDATA[
+<renameMappings>
+  <renameMapping>
+    <fromSchema>PROD</fromSchema>
+    <toSchema>TEST</toSchema>
+  </renameMapping>
+</renameMappings>
+]]></programlisting>
+
+    <para>Renaming a table:</para>
+    <programlisting language="xml"><![CDATA[
+<renameMappings>
+  <renameMapping>
+    <fromSchema>PROD</fromSchema>
+    <fromTable>CUSTOMER</fromTable>
+    <toTable>CSTMR</toTable>
+  </renameMapping>
+</renameMappings>
+]]></programlisting>
+
+    <para>Renaming a column:</para>
+    <programlisting language="xml"><![CDATA[
+<renameMappings>
+  <renameMapping>
+    <fromSchema>PROD</fromSchema>
+    <fromTable>CUSTOMER</fromTable>
+    <fromColumn>ID</fromColumn>
+    <toColumn>IDX</toTable>
+  </renameMapping>
+</renameMappings>
+]]></programlisting>
+
+    <para>Note: fromSchema can be omitted when renaming tables and columns.</para>
+
     <para>Compared to APT based code generation certain functionality is not available such as QueryDelegate annotation handling.</para>
 
   </sect2>