diff --git a/docs/src/__examples__/Box/DEFAULT.tsx b/docs/src/__examples__/Box/DEFAULT.tsx
index acbb160b53..bcfc4751ae 100644
--- a/docs/src/__examples__/Box/DEFAULT.tsx
+++ b/docs/src/__examples__/Box/DEFAULT.tsx
@@ -101,7 +101,15 @@ export default {
{
name: "elevation",
type: "select",
- options: ["action", "fixed", "overlay", "raised", "fixedReverse", "raisedReverse"],
+ options: [
+ "fixed",
+ "fixedReverse",
+ "level1",
+ "level2",
+ "level3",
+ "level3Reverse",
+ "level4",
+ ],
defaultValue: "",
},
{
diff --git a/packages/orbit-components/src/Box/README.md b/packages/orbit-components/src/Box/README.md
index c792a4e7a6..aa52cd2fce 100644
--- a/packages/orbit-components/src/Box/README.md
+++ b/packages/orbit-components/src/Box/README.md
@@ -150,6 +150,23 @@ All this properties - objects have the some own properties and none is required.
| `"level3Reverse"` |
| `"level4"` |
+#### Examples
+
+```jsx
+// Fixed elevation - useful for elements that stay in place
+Fixed elevation box
+
+// Reverse fixed elevation - reversed shadow direction
+Fixed reverse elevation box
+
+// Level 1-4 elevations - increasing shadow depths
+Subtle elevation
+Medium elevation
+Prominent elevation
+Prominent elevation (reversed)
+Highest elevation
+```
+
### spacingObject
| key | value |