fern-api · devalog · Jul 30, 2026 · Jul 30, 2026
@@ -89,6 +89,13 @@ You can also combine `roles` with `products` and `versions` props.
 
 On a docs [preview link](/learn/docs/preview-publish/preview-changes#preview-links), a role selector lets you view the site as a specific viewer to verify role-based visibility before publishing. Pick one or more roles to see the site as a user with those roles, or select anonymous to see the public view. The docs re-render with that viewer's visibility applied, including nav pruning, `<If />` blocks, and role-gated tabs and products. With no selection, the preview shows all content regardless of role.
 
+<Frame>
+  <img
+    src="assets/rbac-preview.png"
+    alt="Role selector on a docs preview link"
+  />
+</Frame>
+
 ## Example
 
 Fern's RBAC demo site defines the following roles:

@@ -5,14 +5,7 @@
 You can now create and edit `<Tooltip>` components in the Fern Editor. Select existing text to wrap it in a tooltip, or use the `/tooltips` slash command to insert a new one.
 
 <Frame>
-  <video
-    src="./assets/tooltips.mp4"
-    autoPlay
-    loop
-    playsInline
-    muted
->
-</video>
-  </Frame>
+  <img src="./assets/tooltips.png" alt="Creating a tooltip in the Fern Editor" />
+</Frame>
 
 <Button intent="none" outlined rightIcon="arrow-right" href="/learn/docs/writing-content/fern-editor#supported-components">Read the docs</Button>
@@ -5,13 +5,7 @@
 Teams can now preview a role-gated docs site as a specific viewer to validate their gating before publishing. On a preview link, a role selector lets you pick one or more roles (or anonymous) and re-renders the site with that viewer's role-based visibility applied, including nav pruning, `<If />` blocks, and role-gated tabs and products. With no selection, the preview continues to show all content.
 
 <Frame>
-    <video
-      autoPlay
-      muted
-      loop
-    >
-      <source src="./assets/rbac-preview.mp4" type="video/mp4" />
-    </video>
+    <img src="./assets/rbac-preview.png" alt="Role selector on a docs preview link" />
 </Frame>
 
 <Button intent="none" outlined rightIcon="arrow-right" href="/learn/docs/authentication/features/rbac#preview-as-a-role">Read the docs</Button>