Files
2026-07-13 12:20:06 +08:00

1.2 KiB
Raw Permalink Blame History

Common Issues

Quick diagnostics for Zoom Video SDK UI Toolkit (Web).

CSS Not Loading / UI Looks Unstyled

Fix:

  • Ensure you import the toolkit CSS:
    • @zoom/videosdk-ui-toolkit/dist/videosdk-zoom-ui-toolkit.css
  • For bundlers, verify CSS handling is enabled (Vite/Next.js).

SSR / Next.js Errors ("window is not defined")

Fix:

  • Load UI Toolkit only on the client (dynamic import in a client component).

Session Doesn't Join

Common causes:

  • Missing/invalid videoSDKJWT
  • Expired JWT
  • Using Meeting SDK credentials/signature instead of Video SDK credentials/JWT
  • Session name/passcode mismatch

Fix:

  • Generate JWT server-side; keep TTL short; check clock skew.
  • Log the join errors surfaced by the toolkit callbacks.

UI Renders Blank / Cropped

Common cause: The container has no height (common in flex layouts).

Fix:

  • Ensure the container has an explicit height (for example height: 100vh).

"I Need Granular UI Components"

Reality: UI Toolkit is optimized for fast, prebuilt UI. Its not meant to expose every internal tile/control as a first-class primitive.

Fix:

  • If you need fully custom layout, use raw Zoom Video SDK and build your own UI.