Articles on: Troubleshooting & FAQ

A widget is showing an error

A widget (CTA, Meeting, Video, Document, etc.) is displaying an error state instead of its expected content. Here's how to fix common widget errors.


Generic fixes first


Before diagnosing per-widget:


  • Refresh the page
  • Try incognito to rule out browser extensions
  • Check the browser console — sometimes an error message there points right at the cause


By widget type


Video widget

"Video can't be loaded"

  • The hosted source (YouTube, Loom, Vimeo) may be down or the video was removed
  • Check the original URL in edit mode; confirm it's still valid
  • If the video is private, make sure share permissions allow embedding


"Failed to play"

  • User's browser may block autoplay; click the play button manually
  • Try a different browser


Meeting widget


The Meeting widget attaches an existing calendar meeting (past or upcoming); it isn't a booking widget.


"Meeting details unavailable"

  • The attached meeting was deleted or cancelled in the calendar — reopen the picker and choose another one
  • Calendar integration may have disconnected — go to Profile → Connected emails and reconnect


"Couldn't load calendar" (when picking a meeting)

  • The Google / Microsoft OAuth token expired
  • Reconnect in Profile → Connected emails


"Recording / summary not yet available"

  • The meeting just happened — the transcription / AI pipeline usually finishes within ~30 min
  • If the meeting hasn't happened yet, the block will populate after


Document widget

"Document preview unavailable"

  • File format may not support preview (some .doc, .xls legacy files don't)
  • Try downloading and opening locally
  • Re-upload as PDF for reliable preview


"File not found"

  • Original upload was deleted
  • Edit the widget and re-upload


Recording widget

"Recording not yet available"

  • Transcription pipeline may still be processing (usually completes within 30 minutes of meeting end)
  • Check back later


"Recording failed"

  • Meeting was too short (< 2 minutes) or bot couldn't join
  • Contact support if recurring


Signature widget

"Envelope failed to load"

  • Check your credit balance (if empty, signatures can't be sent)
  • Ensure Signature module is enabled
  • Check the envelope status in Signatures page — it may be in a processing or failed state


Field widget (CRM-synced)

"Can't fetch value"

  • CRM integration may have disconnected
  • Go to Settings → Integrations and reconnect HubSpot / Salesforce
  • Verify the underlying field still exists in CRM


CTA widget

"Button doesn't work" / Link 404

  • Check the target URL in edit mode
  • Ensure the destination is still live


For buyers reporting widget errors


If a buyer reports a widget error:


  1. Open the room yourself (in Present mode or directly) — does the widget work for you?
  2. If yes — it's buyer-side (browser, network). Offer workarounds.
  3. If no — there's a real issue. Fix the widget, then refresh the buyer's experience.


Permanent workaround


If a widget keeps failing and you can't resolve:


  • Delete the widget and use a simpler alternative (text with a link instead of an embedded widget)
  • Contact support for the specific widget issue


Still stuck?


Contact contact@katalyz.co with:

  • Room URL
  • Which widget is failing
  • Screenshot with the error message
  • What you've already tried


Updated on: 18/06/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!