| Keyword | What it does |
|---|---|
| #LABOUR / #MATERIALS | Your own tags: put related lines into separate groups. |
| #SINGLELINE | Combine the invoice detail into one group. |
| #IGNORE | Keep this line outside a #SINGLELINE group. |
| #GENERATE | Create the polished PDF and attach it to the Xero invoice. |
Where do I type keywords?
Type keywords into line-item descriptions in your Xero invoice. They tell InvoicePolish how to present the invoice.
- Use uppercase letters: #IGNORE works; #ignore does not.
- Separate a keyword from other words with a space or a line break. Leave punctuation off the keyword itself.
- After saving in Xero, use Automate Groups in InvoicePolish to apply grouping. Add #GENERATE if you want the PDF generated and attached automatically.
What you should see: Your original amounts and accounting lines stay in Xero. Grouping changes their presentation in InvoicePolish.
Good to know. #KEYWORDS is the name of this help page, not a command. Tags such as #LABOUR are words you choose; #SINGLELINE, #IGNORE and #GENERATE have special jobs.
#SINGLELINE — make one summary group
Combine the invoice's detail lines, including existing groups, into one editable group named SINGLE LINE.
- Add one description-only line item in Xero. Leave its account code and price unallocated, with no dollar or tax amount.
- In that ONE description field, type the summary you want the client to read and include #SINGLELINE once. The example below is one description field, not three separate invoice items.
- Save in Xero, then choose Automate Groups. The other text in that field becomes the group description, keeping its line breaks and spacing.
Cinebot MINI and crew
As per fee proposal #RF10037A
#SINGLELINEWhat you should see: The eligible detail becomes one group with your chosen description. You can expand it, reorder its members or move a line back out.
Good to know. Use only one #SINGLELINE instruction line per invoice. It takes priority over ordinary grouping tags. Unlike ordinary tags, this instruction only needs to appear once.
#IGNORE — keep a line separate
Use this with #SINGLELINE when one or more items should remain visible as ordinary lines.
- Add #IGNORE anywhere in the description of each line you want to keep separate. Keep that line's normal account code, quantity, price and tax settings.
- Use it on as many lines as needed. It also works on a descriptive note with no value.
- Run Automate Groups, or let #GENERATE run. The other eligible lines form the single group; the ignored lines stay outside it.
Insurance & Software Licensing #IGNOREWhat you should see: Ten detail lines with two marked #IGNORE become one group containing eight lines, plus two ordinary lines.
Good to know. #IGNORE is for the keyword-driven #SINGLELINE workflow. It does not stop you manually grouping a line, and it does not stop #GENERATE from producing the PDF. Leave at least one eligible line to form the single group.
#GENERATE — create and attach the PDF
Ask InvoicePolish to apply the keywords, generate the polished PDF and attach it to the original Xero sales invoice.
- Put #GENERATE on a description-only invoice line. Leave the account code and tax code unallocated; price, line amount and tax amount must be zero or blank.
- It can share that description with other text and #SINGLELINE. It does not need its own line. Use the combined example below inside ONE description field.
- Save the invoice in Xero. Allow background processing to finish, then check its PDF attachment. A completed generation also updates an open InvoicePolish editor and shows a message.
Cinebot MINI and crew
As per fee proposal #RF10037A
#SINGLELINE #GENERATEWhat you should see: #SINGLELINE grouping runs first, leaving #IGNORE lines separate. InvoicePolish then generates and attaches the finished PDF. It does not email your client.
Good to know. New users do not need to turn a toggle on first: the first qualifying #GENERATE detection enables generation automatically. Email verification, a real Xero connection and trial/plan allowances still apply. If you deliberately switched generation off in Settings, keywords will not turn it back on; re-enable it there.
What will the client see?
Review the preview and PDF before sending the invoice to your client.
- Turn Hide Grouping Word on to hide recognised grouping tags and #SINGLELINE, #IGNORE and #GENERATE. Turn it off to show them again. A one-off reference such as #RF10037A stays visible.
- A whole-invoice SINGLE LINE group hides Quantity and Price. If an ordinary line remains outside that group, those columns return according to your saved settings; the group's cells are blank.
- If any group contains different tax codes, the Tax column is hidden across the invoice. Total tax still appears in the totals. Separate groups or ordinary lines with different tax codes do not by themselves hide Tax.
What you should see: You control the descriptions and visibility while the invoice's accounting amounts remain unchanged.
Good to know. Manual mixed-tax grouping asks for approval. #SINGLELINE plus #GENERATE approves that presentation automatically. Restore removes grouping and returns to your saved column settings.
Try it here
Four detailed lines. Two clear groups.
Edit a tag and watch the summary change. This example covers repeated ordinary tags and never connects to Xero. The #KEYWORDS guide explains #SINGLELINE and #IGNORE.
Your detailed descriptions
Try changing one #LABOUR to #labour, or moving it into the middle of the description.
Illustrative client-facing summary
The example illustrates grouping only. Your actual template, tax and visibility settings determine the final PDF.
Common questions
Do I need #GENERATE to use Automate Groups?
No. Use Automate Groups to apply the grouping keywords, then download or attach the PDF manually. Add #GENERATE only when you want background generation and attachment after a qualifying Xero update.
Will every save attach another copy?
Unchanged output is skipped. For a new upload, InvoicePolish uses a clean name such as Invoice RF260652.pdf unless that exact name already exists; later versions receive a Melbourne date and time suffix. Existing attachments stay in Xero.
Can I copy this setup to the next invoice?
Yes. Copy the prepared invoice in Xero, update the details and keep the keywords you want. Check the new invoice and its PDF. Automatic generation can rebuild groups, so update the keywords if you want a manual grouping change to carry through.
Does #GENERATE work on quotes or supplier bills?
No. This automatic workflow is for Xero sales invoices. Use the manual quote workflow for quotes.
Your next step
Still need a hand? Contact InvoicePolish support.
