# Xero (/docs/features/integrations/xero-integration)



Xero lets you bring customer, business, and project details into supported Tradie Forms fields without retyping them on site.

Read the overview on the [Xero integration page](/integrations/xero).

## Requirements [#requirements]

* Solo or Team subscription
* Xero account with access to the organisation you want to link
* A supported template and field

## Connect Xero [#connect-xero]

1. In Tradie Forms, open [**Connections**](https://tradieforms.com.au/app/integrations) and choose **Xero**.
2. Select **Connect with Xero** and sign in to Xero.
3. Approve read-only access for contacts, organisation settings, and projects.
4. If your login has more than one Xero organisation, pick which one to link.

On a **team workspace**, only a team admin can connect Xero for the crew.

## OAuth scopes [#oauth-scopes]

Tradie Forms requests only the Xero access needed for import and optional PDF attach:

| Scope                        | What it is used for                                                          |
| ---------------------------- | ---------------------------------------------------------------------------- |
| `openid`, `profile`, `email` | Sign in and identify your Xero user during connect                           |
| `offline_access`             | Keep the connection active without signing in every 30 minutes               |
| `accounting.contacts.read`   | Search contacts and import customer names, phones, and addresses             |
| `accounting.settings.read`   | Import your business name, ABN, and contact lines from organisation settings |
| `projects.read`              | Import project names and references when Projects is enabled in Xero         |
| `accounting.attachments`     | Attach completed PDFs to the linked Xero contact when upload is on           |

We do not request write access to invoices, bills, bank transactions, or payroll.

## Import into a form [#import-into-a-form]

### Per-field import [#per-field-import]

1. Open a supported form while signed in on Solo or Team.
2. Select the link icon beside a supported field.
3. Search or pick a Xero contact or project.
4. Choose the field value to import.
5. Check the result before download - contact addresses are often billing addresses.

### Connect import mode [#connect-import-mode]

On the Xero integration page, enable **Connect import** to map form fields once, then import a whole contact or project in one go.

1. Open a supported form with Connect import enabled.
2. Follow the banner to pick a sample contact or project.
3. Map each form field to the matching Xero value.
4. Save the mapping for that template.
5. On future jobs, pick a contact or project and import all mapped fields together.

When Connect import is off, use the link icon beside each field instead.

## Attach PDFs to Xero contacts [#attach-pdfs-to-xero-contacts]

Turn on **Upload PDFs to Xero contacts** on the Xero integration page in Connections.

You can attach PDFs in two ways:

* From the **Your PDF is ready** sheet after download, when you imported at least one Xero field during that session
* From **Completed**, using **Send to Xero**

If a stored PDF is available (Solo stored copies or Team audit trail), the stored copy can be used. Otherwise Tradie Forms regenerates the PDF from saved form data.

PDFs attach to the **linked Xero contact**. If you imported from a project, Tradie Forms uses that project's contact.

## Disconnect [#disconnect]

Open the Xero integration page in [**Connections**](https://tradieforms.com.au/app/integrations) and select **Disconnect**. For team workspaces, only a team admin can disconnect the shared connection.

You can also revoke Tradie Forms from your Xero connected apps list. Disconnect removes stored credentials, field mappings, and cached import data from Tradie Forms.

## Troubleshooting [#troubleshooting]

| Issue                      | What to do                                                                                   |
| -------------------------- | -------------------------------------------------------------------------------------------- |
| **Solo required**          | Upgrade, then connect again from Connections                                                 |
| **Team admin required**    | Ask a team admin to connect Xero for your business workspace                                 |
| **Connection expired**     | Open Connections, then reconnect Xero                                                        |
| **Wrong address imported** | Contact addresses are often billing addresses. Confirm the site line on site before download |
| **Import icon missing**    | Confirm you are on Solo or Team, Xero is connected, and the form field supports import       |

Xero suits tradies who already invoice in Xero and want customer, business, and project details in forms. Contact addresses are often billing addresses, so confirm the site line on site before download.