ClickTerm Docs — Clickwrap Consent Management

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

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

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

HTTP status codes and response format for the REST API.

SDK error reference