Platform docs
Auth, users, webhooks & more
Info:
This is beta documentation for Stream Video React SDK v2. For the latest stable version, see the latest version (v1).

Call Preview and Thumbnail

Depending on your call type settings, our system can occasionally generate a preview image (thumbnail) for your call. You can use this image to show a preview of the call in your app, typically in a lobby, waiting room, etc.

Get the preview thumbnail

import { useCallStateHooks } from "@stream-io/video-react-sdk";

const { useCallThumbnail } = useCallStateHooks();
const thumbnail = useCallThumbnail();

console.log(thumbnail?.image_url);

Show the preview thumbnail

Our React Video SDK provides a built-in component to show the preview image. You can use it like this:

import { CallPreview } from "@stream-io/video-react-sdk";

export const MyComponent = () => {
  return (
    <div className="my-container">
      <CallPreview
        className="my-call-preview-class"
        style={{ width: "240px", height: "135px" }}
      />
    </div>
  );
};

Optionally, it accepts className and style props, so you can style it as you wish.

Add Chat to my app: getstream.io/SKILL.md

The fastest way to build with Stream. Start a new project or improve an existing one. Full CLI and documentation integration out of the box.


Ask your agent:

/stream Build me a Social App with Feeds and Moderation.
/stream Any livestream calls running?
/stream Video React v2: <Your Question>