> ## 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 and the template editor.
## 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 Field**.
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:** inside [Smart Add](/how-tos/smart-add), when you tap **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
* 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.
* Open the report in the [Web Editor](/inspections-and-reports/web-editor) 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 **Generate using Hive Comment Assist** at the top of the dialog.
* 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.
* 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 **Generate using Hive Comment Assist** again and click **Generate** for a new draft.
* 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 Field**. The comment is added to the subsection and selected in the report.
## Rewrite the description of an existing comment
* In the Web Editor, click the arrow at the right end of the comment's row to expand it.
* 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 a template
* Go to **Templates**, open the template, then the section and subsection.
* Click **New Comment** next to **Information**, **Limitations** or **Defects/ Deficiencies**.
* Click **Generate using Hive Comment Assist**, pick a length, describe the issue and click **Generate**, the same as in a report.
* Click **Create Field**, then **Save Changes** in the bar at the bottom of the template editor.
* 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:** 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 Field** 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.
* **Enabled for your company by Hive.** If you don't see **Generate using Hive Comment Assist**, check that **Hive Comment Copilot** shows **Enabled** under **Business Tools → Hive AI**, or ask support through the chat bubble.
## FAQ
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.
No. It fills in the comment form. The comment is only added when you click **Create Field**.
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
Related
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.