AI template generation
Turn a pasted questionnaire into a draft template, or add AI-drafted steps in the builder. Covers plan limits, AI credit packs, and the errors you may see.
AI template generation drafts the steps and fields of a template from plain text. You can use it in two places:
- New template builds a whole template from a questionnaire you paste.
- AI Generate in the template builder adds drafted steps to a template you already have.
Only owners and admins can create or edit templates, so only they can use either one. Members see "Only admins can create templates." on New template and "Only admins can edit templates." in the template builder.
Portico sends the text you type and the industry you choose to an outside AI service to draft the template. Paste your questions, not your clients' answers.
Create a template from a questionnaire
- Go to Templates and click New template. The Paste your questionnaire tab opens first.
- Paste your questions into Your questionnaire. Text from a Google Doc, an email, or any other document works.
- Optionally, choose an industry under Industry (optional). The AI uses it as context, and Portico saves it as the template's industry.
- Click Generate template. The button shows Generating... while the AI works.
- Review the steps and fields Portico shows. Each row shows the field label, its type, and an asterisk when the field is required.
- If a payment field has no amount, an Amount box appears beside it. Enter the price in USD. Portico never guesses a price. If a signature field has no agreement text, an Agreement text box appears beside it. Paste the document the client signs.
- Enter a Template name.
- Click Create template. Portico saves the template and opens it in the template builder.
Create template stays disabled until you enter a name and fix every marked problem, such as a missing amount or agreement text. To try again, click Regenerate. Your pasted text stays in the box, so you can edit it and click Generate template again. Each new attempt counts as one generation.
To build without AI, click the Start blank tab instead.
Add steps inside the builder
- Open a template and select a step.
- Click AI Generate next to Add field. The Generate with AI dialog opens.
- Describe the form under Describe what you need. For example: "New client intake for a digital marketing agency".
- Optionally, choose an industry under Industry (optional). Here the industry only guides the AI. Portico does not save it on the template.
- Click Generate.
- Review the summary and the list of drafted steps and fields.
- Click Add to template, or click Regenerate to go back to your description.
Portico adds the drafted steps after your existing steps and selects the first new one. Your existing steps stay as they are. The builder then saves the template as it does for any other edit.
If a drafted payment field has no amount, or a drafted signature field has no agreement text, the builder marks it "Needs a fix before it can save". The template does not save until you enter the amount or the Agreement text in that field's settings.
The AI Generate button appears when your plan includes AI generation or your team has AI credits. It does not appear on lifetime and AppSumo plans until the Owner buys an AI credit pack.
Text length
| Limit | Value |
|---|---|
| Shortest text | 5 characters. The generate button stays disabled until you type that much. |
| Longest text | 10,000 characters. Longer text shows "Some details were not accepted. Check what you entered, then try again." |
Portico ignores spaces at the start and end of your text when it counts characters.
Monthly allowance
Each click of Generate template or Generate that reaches the AI service counts as one generation against your plan's monthly allowance.
| Plan | AI generations per month |
|---|---|
| Free | 25 |
| Starter | 200 |
| Pro and the Pro trial | 1,000 |
| Business | Unlimited |
| Lifetime and AppSumo plans | None. Use AI credits. |
When a Pro trial ends without a paid plan, the account moves to Free and its allowance becomes 25.
The allowance resets on the 1st of each month, in UTC. Settings > Billing > Usage this month shows AI generations used so far when your plan includes AI generation.
Portico counts a generation just before it sends your text to the AI service. The count stays even when the AI then fails or returns a result Portico cannot use. A request refused before that point does not count. That covers text that is too short or too long, a reached limit, and too many requests in one minute.
Portico accepts 5 generation requests per minute from one IP address.
AI credits on lifetime plans
Lifetime and AppSumo plans do not include AI generation. The Owner can buy an AI credit pack in Settings > Billing under Credit packs.
- One pack adds 1,000 AI generation credits for a one-time $29 USD base price. Local prices, discounts and taxes can change the checkout total.
- Each generation uses one credit.
- Credits never expire and never renew.
- Credit packs shows your balance as a count of AI generation credits.
Credits are used only after any monthly allowance runs out. See Billing and plans for plan prices and other credit packs.
What a generated template contains
The AI drafts steps and fields from your text. Portico checks the result before it shows you anything:
- The AI is asked for one to five steps of two to eight fields each. A result with more than 10 steps fails with "Portico could not finish this right now. Try again in a minute, or email support@portico.run if it keeps failing."
- Fields use the 18 builder field types. Portico drops any field with a type it does not recognize, and any step whose fields were all dropped. If the AI returns a step with no fields at all, the attempt fails with "Portico could not finish this right now…" and counts as one generation.
- A field is required unless the AI marks it optional.
- Choice fields can come with options. File uploads, addresses, info text and repeater groups can come with their settings filled in.
- The AI is told to leave out payment and signature fields unless your text asks for them.
- A blank field label gets the builder's default label for that type. Info text fields keep a blank label.
- A blank step title becomes "Step" plus its number. Repeater columns with no name are removed.
Generated steps are never optional and carry no conditional logic.
Review before you send
A generated template is a draft. Check it in the builder before you send it to a client:
- Compare the labels and field types with your original questionnaire.
- Check which fields are required. A generated field is required unless the AI marked it optional.
- Check the options on every Dropdown, Multi-select, and Radio buttons field.
- Check the limits on every File upload field.
- Check every Signature field's Agreement text. It is the document your client signs, so paste your own engagement letter or consent text.
- Check every Payment field's Amount and Payment type. A payment needs Stripe connected before clients can pay. See Stripe payments.
- Add help text, optional steps, conditional logic, and translations where you need them.
- Click Preview to walk through the form as a client would.
Error messages
Errors show a sentence in your language. The table explains each one.
| What you see | What it means | What to do |
|---|---|---|
| "Your plan does not include AI field suggestions. Upgrade in Settings > Billing to turn it on." | Your plan does not include AI generation, and your team has no AI credits. | The Owner can buy an AI credit pack. You can also start from the template gallery or click Start blank. |
| "You have used this month's AI generations…" | Your team used its monthly allowance. | Wait for the reset on the 1st, or move to a plan with a higher allowance. |
| "Your AI credits are used up…" | Your team used all its AI credits. | The Owner can buy another AI credit pack, or you can add the fields yourself. |
| "Too many attempts in a short time…" | More than 5 generation requests came from your IP address in one minute. | Wait the number of seconds shown, then try again. |
| "Some details were not accepted. Check what you entered, then try again." | Your text is longer than 10,000 characters. | Shorten the text, or split it and generate in parts. |
| "Portico could not finish this right now…" | The AI service failed, timed out, or returned a result Portico could not use. Portico may also have failed to read your plan first. | Try again. If the AI answered, the attempt counts as one generation. Plain lists of questions work best. |
| "A Portico setting needs attention before this can work…" | AI generation is switched off on the server. | Email support@portico.run. |
| "Your device could not reach the server…" | Your browser lost the connection, or the answer did not arrive. | Check your connection and try again. |
| "Could not create the template. Try again, or email support@portico.run if it continues." | Portico could not save the generated steps and fields. | Click Create template again. |
| "Your session ended. Sign in again, then try again." | Your session ended. | Sign in again, then retry. |
These messages read the same on New template and in the builder's Generate with AI dialog.
Frequently asked questions
- How many AI generations does my plan include?
- Free includes 25 a month, Starter 200, and Pro and the Pro trial 1,000. Business has no limit. Lifetime and AppSumo plans include none. Counts reset on the 1st of each month, in UTC.
- Does a failed generation count toward my limit?
- Yes. Portico counts a generation just before it sends your text to the AI service, even when the result then fails. A request refused before that point does not count.
- Can I use AI generation on a lifetime plan?
- Yes, with an AI credit pack. The Owner buys 1,000 AI credits in Settings > Billing under Credit packs. Each generation uses one credit, and credits never expire.