diff --git a/docs/src/index.md b/docs/src/index.md
index 7a9e7bc4..50a45308 100644
--- a/docs/src/index.md
+++ b/docs/src/index.md
@@ -102,6 +102,18 @@ julia> mod(1hr+3minute+5s, 24s)
 17 s
 ```
 
+You can also parse units from a string
+```jldoctest
+julia> unit_str = "kg/m^2"
+"kg/m^2"
+
+julia> units = uparse(unit_str)
+kg m^-2
+
+julia> 100 * units
+100 kg m^-2
+```
+
 One useful interactive function is being able to convert to preferred (in this case SI) units. 
 
 ```jldoctest