> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clickterm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SDK error reference

> Error codes and solutions for the ClickTerm Web and Android SDKs.

For REST API error codes (`400`, `401`, `404`, etc.), see the [API Error Reference](/api-reference/errors).

## Web SDK

| Error               | Cause                                            | Solution                                                            |
| ------------------- | ------------------------------------------------ | ------------------------------------------------------------------- |
| SDK not initialized | `ClicktermClient.initialize()` was not called    | Call `initialize()` with your App ID before using `ClicktermDialog` |
| Template not found  | Template is disabled or has no effective version | Enable the template and ensure a version is effective               |
| Network error       | Cannot reach the ClickTerm API                   | Check the user's network connection                                 |

### Inline mode (v2.2.0+)

| Error                          | Cause                                                  | Solution                                                                      |
| ------------------------------ | ------------------------------------------------------ | ----------------------------------------------------------------------------- |
| Container element not found    | No element with that `id` in the DOM                   | Ensure the container element exists before calling `renderInline()`           |
| Already rendered for container | `renderInline()` called twice for the same container   | Call `handle.destroy()` first, or use a different container                   |
| Missing inline content         | Backend returned content without `inlineContent` field | Check template configuration — ensure inline content is set in the dashboard  |
| Finalize failed                | Network or server error during `finalize()`            | Does not throw — returns `status: 'ERROR'` and unlocks the checkbox for retry |

## Android SDK

| Error               | Cause                                         | Solution                                                      |
| ------------------- | --------------------------------------------- | ------------------------------------------------------------- |
| SDK not initialized | `ClicktermClient.initialize()` was not called | Call `initialize()` in your Application class or MainActivity |
| Invalid template ID | Template ID format is incorrect               | Use the UUID from the ClickTerm dashboard                     |

## Related

<CardGroup cols={2}>
  <Card title="API error codes" icon="server" iconType="light" href="/api-reference/errors">
    HTTP status codes and response format for the REST API.
  </Card>

  <Card title="Troubleshooting" icon="wrench" iconType="light" href="/dev/resources/troubleshooting">
    Common integration issues and step-by-step fixes.
  </Card>
</CardGroup>