diff --git a/manual/images/render_shader-nodes_ray-portal-bsdf_gateway-example.jpg b/manual/images/render_shader-nodes_ray-portal-bsdf_gateway-example.jpg
new file mode 100755
index 000000000..ae24b6405
--- /dev/null
+++ b/manual/images/render_shader-nodes_ray-portal-bsdf_gateway-example.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:67524d9c69328441d4f8df9994c758e4b518abcf142c3158ac4d488066601cbb
+size 630290
diff --git a/manual/images/render_shader-nodes_ray-portal-bsdf_portal-to-screen-example.jpg b/manual/images/render_shader-nodes_ray-portal-bsdf_portal-to-screen-example.jpg
new file mode 100755
index 000000000..5f6dff077
--- /dev/null
+++ b/manual/images/render_shader-nodes_ray-portal-bsdf_portal-to-screen-example.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:62c6fb818a12320ce36574ab96e055f3c79962d2f91c4bd7bfba5509ed12fb3b
+size 395976
diff --git a/manual/images/render_shader-nodes_ray-portal-bsdf_portal-to-screen-nodes.jpg b/manual/images/render_shader-nodes_ray-portal-bsdf_portal-to-screen-nodes.jpg
new file mode 100755
index 000000000..f662390fa
--- /dev/null
+++ b/manual/images/render_shader-nodes_ray-portal-bsdf_portal-to-screen-nodes.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:e2ce2bea8464ccb65bdc06a68f8d443e8793d958b53e1bc553cee565e744bd04
+size 125202
diff --git a/manual/images/render_shader-nodes_ray-portal-bsdf_ray-augmentation-nodes.jpg b/manual/images/render_shader-nodes_ray-portal-bsdf_ray-augmentation-nodes.jpg
new file mode 100755
index 000000000..aa93c8798
--- /dev/null
+++ b/manual/images/render_shader-nodes_ray-portal-bsdf_ray-augmentation-nodes.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:81782312cfa7eb1821b1aa3e4f3060d95333ef07b138141c562ae066aba31ffb
+size 131699
diff --git a/manual/images/render_shader-nodes_ray-portal-bsdf_simple-ray-offset-nodes.jpg b/manual/images/render_shader-nodes_ray-portal-bsdf_simple-ray-offset-nodes.jpg
new file mode 100755
index 000000000..a2ab3c8ca
--- /dev/null
+++ b/manual/images/render_shader-nodes_ray-portal-bsdf_simple-ray-offset-nodes.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:571bb66a8461ab3d25d028146c60afa20bf56a242b2b0121846b6130413648fb
+size 34519
diff --git a/manual/render/shader_nodes/shader/ray_portal.rst b/manual/render/shader_nodes/shader/ray_portal.rst
index 21a79bfc4..5c094ae6c 100644
--- a/manual/render/shader_nodes/shader/ray_portal.rst
+++ b/manual/render/shader_nodes/shader/ray_portal.rst
@@ -50,3 +50,50 @@ Outputs
 
 BSDF
    Standard shader output.
+
+Examples
+========
+
+One use case for the *Ray Portal BSDF* is to connect two spaces together to
+create effects like a portal to an alternative dimension, or "impossible spaces"
+where something is bigger or smaller on the inside than expected.
+
+To set up a *Ray Portal BSDF* for a technique like this, augment the
+*Position* and *Incoming* outputs of the
+:doc:`Geometry node </render/shader_nodes/input/geometry>` to set the exit point
+and direction of the ray through the portal. Here are some examples:
+
+Simple Offset
+-------------
+
+.. figure:: /images/render_shader-nodes_ray-portal-bsdf_simple-ray-offset-nodes.jpg
+
+
+   This simple node setup offsets the ray position.
+   In this example, the ray is offset 0 units along the X axis,
+   4 units along the Y axis, and 5 units along the Z axis.
+
+Portal
+------
+
+.. figure:: /images/render_shader-nodes_ray-portal-bsdf_gateway-example.jpg
+
+.. figure:: /images/render_shader-nodes_ray-portal-bsdf_ray-augmentation-nodes.jpg
+
+   In this example, the *Location of Portal Target* and *Rotation of Portal Target*
+   vectors are obtained from a target portal object using
+   :doc:`Drivers </animation/drivers/introduction>`.
+
+Camera Feed
+-----------
+
+Along with augmenting rays, the ray position and ray direction can be replaced,
+for effects like a camera feed on a screen.
+
+.. figure:: /images/render_shader-nodes_ray-portal-bsdf_portal-to-screen-example.jpg
+
+   Using the Ray Portal BSDF to replicate the effect of a camera feed on a screen.
+
+.. figure:: /images/render_shader-nodes_ray-portal-bsdf_portal-to-screen-nodes.jpg
+
+   Node setup for replicating a camera feed like effect on a screen.