> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://katalyz.crisp.help/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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

## Related articles
- [Content isn't loading](https://katalyz.crisp.help/en/article/content-isnt-loading-rbb5j7/)