---
title: "insights.message"
slug: "ai-insights-message"
updated: 2025-11-06T19:33:30Z
published: 2025-11-06T19:33:30Z
canonical: "docs.doc-know.com/ai-insights-message"
---

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

# insights.message

### ai.insights.message

Toggles a message insight that persists for the lifetime of an app.

### Input Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| **key** | Text | Yes | Unique identifier for insight |
| **on** | Boolean | Yes | Visibility toggle (**true** = show, **false** = hide) |
| **[category]** | Text | No | Category to group insight within |
| **[message]** | Text | No | Insight message |

### Returns

No return value.

### Examples

```
// show a message insight to the user
ai.insights.message("insight1", true, "Testing", "Consider echo.");
```

```
// hide (remove) a message insight
ai.insights.message("insight1", false);
```

### Remarks

Use this function to display message-based **insights** to an attached intelligence experience.

          Tip

          

Dr. Know products support insights using an **Insights Panel**.