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

# AI Comment Assist: Write a Report Comment From a Few Words

> Type a few words and Hive Comment Assist drafts the comment name and description in your company's voice. Works in the Web Editor, the template editor and the mobile app.

## What Comment Assist does

Comment Assist writes a report comment from a short note. Type a few words, such as "leaky faucet under kitchen sink", pick how long the description should be, and click **Generate**. Hive fills in the comment name and description. For a defect it also fills in the category and the service type. Nothing goes into the report or template until you check the draft and click **Create Comment**.

Hive uses the section and subsection you are adding the comment to, and writes in the style set by your company's prompt. Inspectors report saving about 20 minutes per inspection with Comment Assist.

You can use it in three places:

* **Web Editor:** the **Add Comment** dialog in any subsection of a report.
* **Template editor:** the **New Comment** dialog in any subsection of a template.
* **Mobile app:** the **Add Comment** screen in any subsection, the sparkle button when you edit a comment's description, and inside [Smart Add](https://docs.hiveinspect.com/how-tos/smart-add.md) (**Create new comment with Hive Comment Assist**).

Comment Assist is part of Hive AI. In the dashboard it is listed as **Hive Comment Copilot** under **Business Tools → Hive AI**.

## How to write a comment with Comment Assist

### 1. Set your company's wording once

![The Hive Comment Copilot card under Business Tools, Hive AI, showing the Comment Copilot Prompt box, a 772/1500 character count and the Example Prompt with Copy and Use This buttons](https://mintcdn.com/hiveinspect-43c85ed1/TOEGD-OTvLV5bPLk/images/how-tos/comment-assist-1.png?fit=max\&auto=format\&n=TOEGD-OTvLV5bPLk\&q=85\&s=2ee39ba5be99c5f5e9973a9a46aeba09)

* Go to **Business Tools → Hive AI**. The **Hive Comment Copilot** card shows **Enabled**.
* Write how your comments should read in the **Comment Copilot Prompt** box, up to 1,500 characters. Include any liability wording you always use.
* To start from Hive's example, click **Use This** under **Example Prompt**, then change it to match how you inspect.
* Click **Save**. The prompt applies to everyone in your company, on the web and in the mobile app.

### 2. Open Add Comment in the report

![The Add New Comment dialog in the Hive Inspect Web Editor for the Plumbing Leaks subsection, with the blue Hive Comment Assist button above the empty Comment Name and Description fields](https://mintcdn.com/hiveinspect-43c85ed1/xWrRXssc5jj60rgI/images/how-tos/comment-assist-2.png?fit=max\&auto=format\&n=xWrRXssc5jj60rgI\&q=85\&s=3a28d95084644a5196dc9caac723fe13)

* Open the report in the [Web Editor](https://docs.hiveinspect.com/inspections-and-reports/web-editor.md) and go to the subsection where the comment belongs, for example **Plumbing → Plumbing Leaks**.
* Click **Add Comment** next to **Defects/ Deficiencies**, **Information** or **Limitations**.
* Click the blue **Hive Comment Assist** button at the top of the dialog. The panel opens below it.

### 3. Pick a length and describe the issue

![The Hive Comment Assist panel in light blue with Text Length set to Medium (3-5 sentences), 'leaky faucet under kitchen sink' typed in Describe the issue, and the blue Generate button](https://mintcdn.com/hiveinspect-43c85ed1/xWrRXssc5jj60rgI/images/how-tos/comment-assist-3.png?fit=max\&auto=format\&n=xWrRXssc5jj60rgI\&q=85\&s=89a6fcb55913aebf2cd42bdc09ef7c6e)

* Under **Text Length**, choose **Small (1-2 sentences)**, **Medium (3-5 sentences)** or **Large (6-10 sentences)**.
* Type what you found in **Describe the issue**. A few words are enough.
* Click **Generate**. It takes a few seconds.

### 4. Check the draft

![The Add Defect/ Deficiency form after generating: the Hive Comment Assist button, Comment Name 'Kitchen Sink Faucet – Leak' and a description with OBSERVATION, EVALUATION and RECOMMENDATION paragraphs](https://mintcdn.com/hiveinspect-43c85ed1/xWrRXssc5jj60rgI/images/how-tos/comment-assist-4.png?fit=max\&auto=format\&n=xWrRXssc5jj60rgI\&q=85\&s=b0cd9dcc693ce57474baada606d5ac78)

* Hive fills in **Comment Name** and **Description**, written in the style of your company prompt.
* Edit any of the text. It is a normal comment form.
* Not happy with it? Open **Hive Comment Assist** again and click **Generate** for a new draft.

### 5. Confirm the category and service, then create

![The Category set to Recommendations and the Service Type set to Plumbing Contractor in the Add New Comment dialog](https://mintcdn.com/hiveinspect-43c85ed1/TOEGD-OTvLV5bPLk/images/how-tos/comment-assist-5.png?fit=max\&auto=format\&n=TOEGD-OTvLV5bPLk\&q=85\&s=eb0c0d7e494de43a7365108a045e9fb7)

* For a defect, Hive also sets **Category** and **Service Type**. Check both and change them if they don't fit.
* Add location tags, an estimated cost or media if you like.
* Click **Create Comment**. The comment is added to the subsection and selected in the report.

## Rewrite the description of an existing comment

### 1. Open the comment

![An expanded defect comment in the Web Editor with the category, Recommendation Service, Location Tags and the Field Description box with the Generate description button](https://mintcdn.com/hiveinspect-43c85ed1/TOEGD-OTvLV5bPLk/images/how-tos/comment-assist-6.png?fit=max\&auto=format\&n=TOEGD-OTvLV5bPLk\&q=85\&s=afd6fb7eb67f12bd8765f19a148850ee)

* In the Web Editor, click the arrow at the right end of the comment's row to expand it.

### 2. Click Generate description

* Click **Generate description** above **Field Description**.
* Hive writes a new description from the comment name, using your company prompt and the Medium length. It doesn't read the current description.
* The new text replaces the old text, and changes in the Web Editor save automatically. Copy the old text first if you might want it back.

## Use Comment Assist in the mobile app

### 1. Open Add Comment in the subsection

* Open the inspection in the Hive app and go to the subsection where the comment belongs.
* Tap **Add Comment** at the bottom of **Information**, **Limitations** or **Defects/ Deficiencies**.

### 2. Generate the comment

* Tap the blue **Hive Comment Assist** button at the top of the form.
* Under **Text Length**, pick **Small**, **Medium** or **Large**.
* Type what you found in **Describe the issue**, or tap the microphone and say it.
* Tap **Generate**. Hive fills in the comment name and description, and for a defect the category and service.
* Check the draft, change anything you like, then tap **Create Comment**.

### 3. Rewrite the description of an existing comment

* Tap the comment's description to open the editor.
* Tap the sparkle button at the top right. Hive writes a new description from the comment name, at Medium length.
* The new text replaces the old text in the editor. Tap **Save** to keep it, or close the editor to keep the old text.

To have the app find a matching comment first, and write a new one only when nothing fits, use [Smart Add](https://docs.hiveinspect.com/how-tos/smart-add.md).

## Use Comment Assist in a template

### 1. Add a new template comment

![The Configure Comment Details dialog in the Hive template editor with Comment Type Defect/ Deficiency, the blue Hive Comment Assist button, a generated Comment Name 'Radon Level Above 4 pCi/L' and its description](https://mintcdn.com/hiveinspect-43c85ed1/xWrRXssc5jj60rgI/images/how-tos/comment-assist-7.png?fit=max\&auto=format\&n=xWrRXssc5jj60rgI\&q=85\&s=ed8726cbc0b691134dcb09b32de33a4c)

* Go to **Templates**, open the template, then the section and subsection.
* Click **New Comment** next to **Information**, **Limitations** or **Defects/ Deficiencies**.
* Click **Hive Comment Assist**, pick a length, describe the issue and click **Generate**, the same as in a report.
* Click **Create Comment**, then **Save Changes** in the bar at the bottom of the template editor.

### 2. Rewrite an existing template comment

* Click the pencil (**Edit component**) on the comment, then **Generate description**.
* Read the new description. Click **Save Changes** in the dialog to keep it, or **Cancel** to keep the old text.
* Click **Save Changes** in the bottom bar to save the template.

***

> [!TIP]
>
> **Tip:** Give the comment a clear name before you click **Generate description**, such as "Radon Fan - Not Running". The button stays greyed out until the comment has a name, and the name is all Hive writes from.

## Worth knowing

* **You approve everything.** Generating fills in the form. Nothing is added until you click **Create Comment** or save.
* **Needs an internet connection**, like the other Hive AI tools. The rest of the app works offline and syncs when you're back online.
* **Included on every plan**, with no usage cap.
* **On by default for every company**, like the other Hive AI tools. If you don't see **Hive Comment Assist**, check that **Hive Comment Copilot** shows **Enabled** under **Business Tools → Hive AI**, or ask support through the chat bubble.

## FAQ

> [accordion] Can I control how the comments are worded?
>
> Yes. The **Comment Copilot Prompt** under **Business Tools → Hive AI** sets the wording for every comment Hive drafts for your company, including any liability language you use.

> [accordion] Does Comment Assist add anything to the report on its own?
>
> No. It fills in the comment form. The comment is only added when you click **Create Comment**.

> [accordion] Does it work offline?
>
> No. Comment Assist needs an internet connection. The rest of the Hive app works offline and syncs the report when you're back online.

See the [Comment Assist feature page](https://www.hiveinspect.com/features/ai-comment-assist) for a video walkthrough.

Next step

Smart Add
Describe a finding on your phone and let AI find the comment or write a new one

2:35

[Open](https://docs.hiveinspect.com/how-tos/smart-add.md)

Related

Comment Merge
Combine up to three related defect comments into one

5 steps

[Open](https://docs.hiveinspect.com/how-tos/comment-merge.md)

Save a comment to a template
Reuse a comment you wrote on site on every future report

2:31

[Open](https://docs.hiveinspect.com/how-tos/saving-comments-to-template.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.