Title: Write better report instructions | OneForm > Tell OneFormAI what to write, test it on a real response, and rate drafts so every report for the form gets better. Source: https://oneform.si/help/reports/write-a-better-report-prompt/ --- 1. [Help Center](https://oneform.si/help/) 2. [Reports](https://oneform.si/help/reports/) 3. Write better report instructions [View as Markdown](https://oneform.si/help/reports/write-a-better-report-prompt.md) # Write better report instructions Tell OneFormAI what to write, test it on a real response, and rate drafts so every report for the form gets better. Admins and ownersUpdated October 22, 2026 · 3 min read [Open your forms ↗](https://app.oneform.si/forms?help=write-a-better-report-prompt) The instructions on a form's **Report** tab tell OneFormAI who it's writing as, what the report is for and how it should read. Good instructions mean fewer edits in review. Ratings from your team then teach OneFormAI what your firm likes. ## Write the instructions 1. Open the form and click the **Report** tab. 2. Under **Instructions and a sample report**, describe the report in a sentence, for example "a one-page plan recommending which of our packages fits them". 3. Click **Write with OneFormAI**. It writes full instructions that refer to your form's actual questions. 4. Read them in the box below and change anything you like. They save automatically. To change them later, type what should change ("make it shorter and friendlier") and click **Rewrite with OneFormAI**. You can also write the instructions yourself from scratch. ### Insert details about the client Under the instructions, click a chip to insert a placeholder that's filled in for each report: **First name**, **Full name**, **Firm name**, **Form title**, **Report title**, **Booking link** and **Today**. ## Try them on a real response 1. On the right, pick a response from the list, or **Sample answers**. 2. Click **Write a sample report**. 3. Read the result, including the **Email summary** above it. 4. Adjust the instructions and click **Try again** until it's right. Nothing is saved or sent when you write a sample. Some samples each month are free; the line under the button shows how many you have left. After that, each sample uses OneAI Tokens, and OneForm asks before writing the first paid one. ## What makes instructions work - **Give OneFormAI a role.** "You are a tax advisor at `{{firm_name}}` writing to a small-business owner." - **Say what the report is for.** "Help them see which three changes would save them the most this year." - **Explain how to read key answers.** "If they're self-employed and earn over a certain amount, discuss an S corporation election." - **Set the sections and length.** "Use these headings: Summary, Your opportunities, Next steps. Keep it to one page." - **Set the tone and limits.** "Plain English, no jargon, no promises about exact savings." - **Say how to end.** "Close by inviting them to book a call." You don't need to ask for formatting, or paste the answers in: OneForm adds both. ## Rate drafts so OneFormAI learns Every rating teaches OneFormAI something about this form's reports. Reviewers can rate drafts too. 1. Open a draft from **Review**. 2. On the right, click the **OneFormAI draft** tab. 3. Under **How good was this draft?**, click from one to five stars. 4. Click any tags that fit, such as **Too long** or **Wrong tone**, and add a note if you like. ![The OneFormAI draft tab, with the star rating](https://app.oneform.si/media/858f9447-c3f5-5b12-8af3-aa32226389dd) After a few new ratings, or one low rating with a note, OneFormAI updates the rules it follows for this form. It also learns from what reviewers change in drafts before sending them. Learning from ratings doesn't use OneAI Tokens. ### See and edit what it learned The rules are on the form's **Report** tab, under **Gets better as you rate**, in **What OneFormAI has learned**. You can edit them and click **Save**, or click **Learn from latest ratings** to update them now. The rules are about how to write, never about a particular client. ## Why is Write with OneFormAI greyed out? - **The box above it is empty.** Type a short description first. - **OneFormAI isn't available right now.** The tab says so. You can still write the instructions yourself. ## Why is Write a sample report greyed out? - **There are no instructions yet.** Write some first. - **Free samples and OneAI Tokens are used up for this month.** Click **Add tokens or upgrade**, or wait until your tokens reset. See [OneAI Tokens and reports](https://oneform.si/help/reports/oneai-tokens-and-reports/). Was this article helpful? [← PreviousSet up a report on a form](https://oneform.si/help/reports/set-up-a-report/)[Next →Brand your reports, sign-off and disclaimer](https://oneform.si/help/reports/report-branding-sign-off-and-disclaimer/) ## Related articles [Set up a report on a formTurn on reports for a form, choose an advice report or a document, and set its title, look and instructions.](https://oneform.si/help/reports/set-up-a-report/)[How AI reports workFrom a client's answers to a finished report: what OneFormAI reads, what it writes, and how your team stays in control.](https://oneform.si/help/reports/how-ai-reports-work/)[Review and edit a draft reportOpen a draft from Review, edit the report and its email, check the answers, re-draft it with a note, and rate it.](https://oneform.si/help/reports/review-and-edit-a-draft/)[OneAI Tokens and reportsWhat a report draft uses in OneAI Tokens, what's free, and what happens to new reports when your tokens run out.](https://oneform.si/help/reports/oneai-tokens-and-reports/) Still stuck? A person on the OneForm team reads every request. Mon–Fri, 9am–6pm ET. First reply within 1 business day. [Open a support case](https://oneform.si/contact/?topic=support)[Report a bug in the app](https://app.oneform.si/ideas?view=feedback)[hello@oneform.si](mailto:hello@oneform.si?subject=OneForm%20support) [Overview](https://oneform.si/help/) Topics - [Getting started](https://oneform.si/help/getting-started/) - [Forms](https://oneform.si/help/forms/) - [Sharing and embeds](https://oneform.si/help/share/) - [Responses and leads](https://oneform.si/help/responses-and-leads/) - [Reports](https://oneform.si/help/reports/) - [How AI reports work](https://oneform.si/help/reports/how-ai-reports-work/) - [Set up a report on a form](https://oneform.si/help/reports/set-up-a-report/) - [Write better report instructions](https://oneform.si/help/reports/write-a-better-report-prompt/) - [Brand your reports, sign-off and disclaimer](https://oneform.si/help/reports/report-branding-sign-off-and-disclaimer/) - [Taxpayer privacy notice and consent (IRC §7216)](https://oneform.si/help/reports/taxpayer-consent-for-ai-section-7216/) - [Review and edit a draft report](https://oneform.si/help/reports/review-and-edit-a-draft/) - [Approve and send a report](https://oneform.si/help/reports/approve-and-send-a-report/) - [Send reports automatically](https://oneform.si/help/reports/send-reports-automatically/) - [Schedule a report and send reminders](https://oneform.si/help/reports/schedule-a-report-and-reminders/) - [What your client receives](https://oneform.si/help/reports/what-your-client-receives/) - [OneAI Tokens and reports](https://oneform.si/help/reports/oneai-tokens-and-reports/) - [Payments](https://oneform.si/help/payments/) - [Bookings](https://oneform.si/help/bookings/) - [Workflows](https://oneform.si/help/workflows/) - [Integrations](https://oneform.si/help/integrations/) - [Emails and notifications](https://oneform.si/help/emails-and-notifications/) - [Team and account](https://oneform.si/help/team-and-account/) - [Plans and billing](https://oneform.si/help/billing/) - [Privacy and security](https://oneform.si/help/privacy-and-security/) - [Troubleshooting](https://oneform.si/help/troubleshooting/) For your clients - [For your clients](https://oneform.si/help/for-clients/) [Glossary](https://oneform.si/help/glossary/)[FAQ](https://oneform.si/help/faq/)[Developer docs](https://oneform.si/developers/)[Contact support](https://oneform.si/contact/?topic=support)