Automation · 5 minute guide

#KEYWORDS: a simple guide

What #GENERATE, #SINGLELINE and #IGNORE do, how to group lines with tags such as #LABOUR, and the simple rules for using them in Xero.

Keywords at a glance
KeywordWhat it does
#LABOUR / #MATERIALSYour own tags: put related lines into separate groups.
#SINGLELINECombine the invoice detail into one group.
#IGNOREKeep this line outside a #SINGLELINE group.
#GENERATECreate the polished PDF and attach it to the Xero invoice.
1

Where do I type keywords?

Type keywords into line-item descriptions in your Xero invoice. They tell InvoicePolish how to present the invoice.

  1. Use uppercase letters: #IGNORE works; #ignore does not.
  2. Separate a keyword from other words with a space or a line break. Leave punctuation off the keyword itself.
  3. 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.

2

#LABOUR and other tags — make separate groups

Use the same tag on related lines. Choose names that make sense for your business.

  1. Put the tag at the start or end of each description, as in the two example invoice lines below.
  2. Use the exact same tag on at least two different invoice lines. Use another tag, such as #MATERIALS, for another group.
  3. Save in Xero, then choose Automate Groups. Lines without matching tags remain separate.
#LABOUR Site preparation
#LABOUR Filming

What you should see: These two lines form one Labour group. A tag used only once, such as #RF10037A, stays ordinary text and is not hidden.

Good to know. Optional: the first zero-value line with the same tag can supply the group's description. It counts towards the two-line minimum. If both ends have tags, the leading tag takes priority.

3

#SINGLELINE — make one summary group

Combine the invoice's detail lines, including existing groups, into one editable group named SINGLE LINE.

  1. Add one description-only line item in Xero. Leave its account code and price unallocated, with no dollar or tax amount.
  2. 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.
  3. 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
#SINGLELINE

What 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.

4

#IGNORE — keep a line separate

Use this with #SINGLELINE when one or more items should remain visible as ordinary lines.

  1. 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.
  2. Use it on as many lines as needed. It also works on a descriptive note with no value.
  3. Run Automate Groups, or let #GENERATE run. The other eligible lines form the single group; the ignored lines stay outside it.
Insurance & Software Licensing #IGNORE

What 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.

5

#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.

  1. 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.
  2. 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.
  3. 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 #GENERATE

What 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.

6

What will the client see?

Review the preview and PDF before sending the invoice to your client.

  1. 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.
  2. 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.
  3. 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.

Xero

Your detailed descriptions

$200.00
$300.00
$150.00
$50.00

Try changing one #LABOUR to #labour, or moving it into the middle of the description.

Illustrative client-facing summary

DESCRIPTIONAMOUNT
Labour$500.00
Materials$200.00
Total$700.00

The example illustrates grouping only. Your actual template, tax and visibility settings determine the final PDF.

The total stays $700. Your underlying Xero entries remain intact.

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.

InvoicePolish

© 2026 InvoicePolish.