diff --git a/docs/src/pages/components/PaginationNav.svx b/docs/src/pages/components/PaginationNav.svx
index 079c5f3c..7ae8dd1d 100644
--- a/docs/src/pages/components/PaginationNav.svx
+++ b/docs/src/pages/components/PaginationNav.svx
@@ -5,8 +5,35 @@
 
 ## Default
 
+`PaginationNav` renders `10` items and does not loop by default.
+
 <PaginationNav />
 
+## Total
+
+Use the `total` prop to specify the number of pages.
+
+<PaginationNav total={3} />
+
 ## Loopable
 
+Set `loop` to `true` for navigation to be looped.
+
 <PaginationNav total={3} loop />
+
+## Shown
+
+If `total` is greater than `10`, the number of items shown will be truncated to `10`.
+
+Use `shown` to override the number of items shown.
+
+<PaginationNav total={100} shown={5}  />
+
+## Custom button text
+
+Use the `forwardText` and `backwardText` props to customize the button text.
+
+<PaginationNav
+  forwardText="Next"
+  backwardText="Previous"
+/>
\ No newline at end of file