---
title: "Widget Errors"
canonical_url: "https://apidocs.sportradar.com/resources/widgets/docs/tutorials/troubleshooting/widget-errors"
markdown_url: "https://apidocs.sportradar.com/resources/widgets/docs/tutorials/troubleshooting/widget-errors.md"
last_updated: "2026-03-23T13:02:35Z"
---

# Widget Errors

This guide helps you diagnose and resolve common errors that may occur when integrating widgets.

> **Info**
>
> Most errors can be resolved by:
>
> - Reviewing the [Getting Started Guide](https://apidocs.sportradar.com/resources/widgets/docs/tutorials.md)
> - Checking browser developer tools ([Chrome](https://developer.chrome.com/docs/devtools/open/#console), [Firefox](https://developer.mozilla.org/en-US/docs/Tools))
> - Contacting our [Support Team](https://apidocs.sportradar.com/resources/widgets/docs/tutorials/troubleshooting/support.md) if issues persist

***

## Common Issues

### Widget Not Visible

If the widget doesn't appear on the page at all, check for these common causes:

**Widgetloader Script Missing**

The widget framework script isn't loaded on the page.

**Solution:** Ensure the widgetloader script is included before any widget initialization code. See the [Getting Started Guide](https://apidocs.sportradar.com/resources/widgets/docs/tutorials.md) for proper script setup.

**Incorrect Client ID**

The Client ID in your configuration doesn't match your license.

**Solution:** Verify your Client ID is correct, or contact [Support](https://apidocs.sportradar.com/resources/widgets/docs/tutorials/troubleshooting/support.md).

**Wrong Widget Container**

The DOM element selector doesn't exist or is incorrect.

**Solution:** Ensure the container element exists in your HTML before the widget initialization script runs.

**Unrecognized Widget Name**

The widget name is misspelled or doesn't exist.

**Solution:** Check the widget name against the documentation.

***

## Error Handling

### Silent Mode

The [`silent`](https://apidocs.sportradar.com/resources/widgets/docs/tutorials/SIR.md#addWidget) property suppresses error displays, preventing end users from seeing error messages.

> **Warning**
>
> Use `silent: false` during development and testing to see error details. Only enable `silent: true` in production after thorough testing.

**View Silent Mode Example**

```js
SIR('addWidget', '<widget-container>', '<widget-name>', {
    ...widgetProps,
    silent: true
});
```

### Custom Error Handling

For advanced scenarios like conditional tab display, use the `onTrack` property to monitor widget events and handle errors programmatically.

> **Tip**
>
> The `onTrack` callback receives a `data_change` event when errors occur. See the [onTrack documentation](https://apidocs.sportradar.com/resources/widgets/docs/tutorials/tracking-guide.md).
>
> See these code examples:
>
> - [Adding Loading Indicators to Widgets](https://apidocs.sportradar.com/resources/widgets/docs/tutorials/examples/example-widget-loading.md)
> - [Conditional Widget Display with Error Handling](https://apidocs.sportradar.com/resources/widgets/docs/tutorials/examples/example-widget-ontrack-error.md)

***

## Visual Error Types

When a widget encounters an issue after loading, it displays an error icon with a message:

### No Config

![No matches](https://apidocs.sportradar.com/resources/widgets/static/img/errors/no.config.svg)

**Error:** "Something went wrong..."

**Cause:** Missing or incorrect required parameters like `matchId`, `seasonId`, or `tournamentId`.

**Solution:** Check browser console for specific details and verify all required widget parameters are provided correctly.

### No Statistics

![No statistics](https://apidocs.sportradar.com/resources/widgets/static/img/errors/no.statistics.svg)

**Error:** "No statistics available" or "No data available"

**Cause:** Match hasn't started yet or data is temporarily unavailable.

**Solution:** This is expected for pre-match widgets. Data will appear once the match begins or when data becomes available.

### No License

![No license](https://apidocs.sportradar.com/resources/widgets/static/img/errors/no.license.svg)

**Error:** License-related message

**Cause:** Widget, tournament, sport, or domain not covered by your license.

**Solution:** Review the [Licensing Guide](https://apidocs.sportradar.com/resources/widgets/docs/tutorials/troubleshooting/licensing-errors.md) for detailed troubleshooting steps.

### Error

![No error](https://apidocs.sportradar.com/resources/widgets/static/img/errors/no.error.svg)

**Error:** Unexpected error

**Cause:** Internal widget or API error.

**Solution:** Contact [Support](https://apidocs.sportradar.com/resources/widgets/docs/tutorials/troubleshooting/support.md) with details about the error, including widget name, configuration, and browser console output.