# Suggestion

> A single suggested prompt presented to the user.

## Overview [#overview]

`Suggestion` represents one suggested prompt shown to the user (typically as a clickable pill). Suggestions are produced from a [`SuggestionsConfig`](/reference/core/types/SuggestionsConfig) and surfaced through [`CopilotKitCoreSubscriber.onSuggestionsChanged`](/reference/core/types/CopilotKitCoreSubscriber).

## Import [#import]

```ts
import type { Suggestion } from "@copilotkit/core";
```

## Definition [#definition]

```ts
type Suggestion = {
  title: string;
  message: string;
  isLoading: boolean;
  className?: string;
};
```

## Properties [#properties]

<PropertyReference name="title" type="string" required>
  Short label displayed on the suggestion pill.
</PropertyReference>

<PropertyReference name="message" type="string" required>
  The message sent to the agent when the suggestion is selected.
</PropertyReference>

<PropertyReference name="isLoading" type="boolean" required>
  Indicates whether this suggestion is still being generated.
</PropertyReference>

<PropertyReference name="className" type="string">
  Optional CSS class name applied to the suggestion pill.
</PropertyReference>

## Usage [#usage]

```ts
import type { Suggestion } from "@copilotkit/core";

const suggestion: Suggestion = {
  title: "Summarize",
  message: "Summarize the current document",
  isLoading: false,
};
```
