# Payroll Connections: Gusto

***

### How to Connect Gusto

{% hint style="info" %}
New Gusto connections use our new Gusto connector automatically. No upgrade or cutover is required.
{% endhint %}

1. From the left navigation menu, click **Connections**.
2. Click the **Payroll** tab.
3. Find **Gusto** and click **Connect**.
4. In the pop-up window, log in using your **Gusto admin** credentials.
5. Back in Digits, go to the **Manage Connections** settings for Gusto.
6. Choose an **import start date** to decide how far back you want to pull payroll history.
   * If you don’t pick a date, Digits will import **all available** Gusto history.
7. ✨ Digits will automatically confirm and map your payroll categories.
8. Review the settings and click to confirm to finish setup.

***

### Upgrade an Existing Gusto Connection (*optional*)

If you already have Gusto connected to Digits, you can switch to the **new Gusto connector** to unlock:

* Department-level payroll data from Gusto
* More detailed benefits (like health, dental, and vision)

#### How to Upgrade

1. Go to **Connections** and select your existing Gusto connection.
2. Click **Upgrade Gusto** and complete the authorization flow.
3. In **Manage**, set a **Cutover date** — the first date you want the new connector to own.
   * *Example:* Set **Oct 1** to have the new connector record transactions from Oct 1 forward (the prior connector ends on Sep 30).
4. Click **Save.** Digits will handle the switch automatically.

{% hint style="info" %}
**Note:** Transactions on/after your Cutover date are recorded by the new connector and replace entries from the prior connector for that period.
{% endhint %}

***

### What Happens After You Connect

Digits will:

* Import historical payroll transactions from Gusto
* Begin syncing new payroll activity automatically based on your set preferences
* Starts a frequent sync to keep everything up to date

{% hint style="info" %}
**Note:** Import time varies depending on the volume of Gusto data.
{% endhint %}

{% hint style="warning" %}
**Important:** Digits currently does **not** support off-cycle payrolls. These must be entered manually in Digits.
{% endhint %}

***

### Category Guide for Gusto Transaction Imports

Understanding how Gusto payroll shows up in your **bank account** makes it easier to review and categorize these entries in Digits.

Here’s how Gusto typically behaves:

#### Primary Payroll Debits

Gusto processes three core debits from your bank account, executed **three business days prior to payday**:

* **Employee Pay** – Direct deposit salaries
* **Employee Reimbursements** – Out-of-pocket expenses paid back to employees
* **Payroll Taxes** – Federal, state, and local tax payments

Gusto makes sure these funds reach your employees and the tax authorities on time. Digits then imports those debits and maps them to the correct payroll categories.

#### Additional Debits You May See

Depending on how you’ve set up Gusto, you may also see:

* Contractor Payments
* Gusto Monthly Invoices
* Historical Tax Payments

These will appear as separate line items in the **Ledger** and may need a quick review to ensure they’re categorized where you want them in your books.

***

### Bank Codes Reference

To make it easier to review your bank feed, Gusto tags each payroll-related transaction with a **short code** in the bank description. For example:

* `PAY` for Employee Pay
* `TAX` for Payroll Taxes

These codes help you quickly recognize what each transaction is when you’re looking at your bank feed in Digits.

You can use the full reference table from Gusto (and in your Digits help docs) to match each code to its meaning. For more details, see [**Gusto’s Help Center**](https://support.gusto.com/).

<table><thead><tr><th width="266.93817138671875">Transaction Type</th><th width="109.4041748046875">Code</th><th width="256.61865234375">Transaction Type</th><th>Code</th></tr></thead><tbody><tr><td>Bank Verification Credit</td><td>BVC</td><td>Credit Payroll Fee - Invoice Refund</td><td>INV</td></tr><tr><td>Bank Verification Debit</td><td>BBV</td><td>Credit Tax</td><td>TXP</td></tr><tr><td>Credit Child Support Garnishment</td><td>CSC</td><td>Credit Tax Liability Refund</td><td>TLR</td></tr><tr><td>Credit Contractor Pay</td><td>CON</td><td>Credit Tax Penalty</td><td>TPI</td></tr><tr><td>Credit Contractor Payment Refund</td><td>CRF</td><td>Credit Tax Refund</td><td>TRC</td></tr><tr><td>Credit Donation</td><td>DCR</td><td>Credit Wages Refund</td><td>PAR</td></tr><tr><td>Credit Employee Pay</td><td>PAY</td><td>Debit Child Support Garnishment</td><td>CSD</td></tr><tr><td>Credit Employee Savings</td><td>SAV</td><td>Debit Contractor Pay</td><td>CND</td></tr><tr><td>Credit Flex Pay Fee (Modern Bank)</td><td>FPF</td><td>Debit Donation</td><td>DDR</td></tr><tr><td>Credit Flex Pay Principal (Modern Bank)</td><td>FPP</td><td>Debit Employee Wages</td><td>PDR</td></tr><tr><td>Credit Flex Pay Repayment (Modern Bank)</td><td>FRP</td><td>Debit Historical Payroll Taxes</td><td>HPT</td></tr><tr><td>Credit Internal Error Expense (Concessions)</td><td>IEE</td><td>Debit Net Pay</td><td>NET</td></tr><tr><td>Credit Internal Transfer Child Support Garnishment</td><td>ITG</td><td>Debit Overpayment</td><td>DOV</td></tr><tr><td>Credit Internal Transfer Contractor Pay</td><td>ITC</td><td>Debit Payroll Fee</td><td>FEE</td></tr><tr><td>Credit Internal Transfer Employee Pay</td><td>ITE</td><td>Debit Refund</td><td>RFD</td></tr><tr><td>Credit Internal Transfer Fees and Penalties</td><td>ITF</td><td>Debit Reimbursement</td><td>REM</td></tr><tr><td>Credit Internal Transfer Invoices</td><td>ITI</td><td>Debit Tax</td><td>TAX</td></tr><tr><td>Credit Internal Transfer Other</td><td>ITO</td><td>Debit Tax Correction</td><td>TCD</td></tr><tr><td>Credit Internal Transfer Overpayment</td><td>ITP</td><td>Electronic Bank Verification - Credit Test Transaction</td><td>EBV</td></tr><tr><td>Credit Internal Transfer Tax Payment</td><td>ITT</td><td>Flex Pay Debit (Modern Bank)</td><td>FPD</td></tr><tr><td>Credit Transfer Verification</td><td>ITV</td><td>International Contractor Pay</td><td>ICD</td></tr><tr><td>Credit Overpayment</td><td>COV</td><td>Tax Department Payment</td><td>TAX DEP</td></tr><tr><td>Credit Partner Revenue Share</td><td>PRS</td><td>Wire Payment Fee</td><td>WPF</td></tr></tbody></table>

***

{% hint style="info" %}
**Tip:** Want a quick snapshot of headcount or payroll trends?

You can add a **Gusto-powered widget** to your Digits home dashboard:

1. Go to **Home → Edit**.
2. Search for the **Gusto** widget.
3. Drag it onto your dashboard layout.

See: [Customize Your Dashboard](https://app.gitbook.com/s/cg3Hd7KOuZysMhKLg9xS/customize-dashboards "mention")
{% endhint %}

***

### Frequently Asked Questions

<details>

<summary>Does Digits support off-cycle payrolls from Gusto?</summary>

Not yet. Off-cycle payrolls aren’t supported through the Gusto connection and must be entered manually in the Ledger.

</details>

<details>

<summary>Do I need to review mapping settings?</summary>

Yes. While Digits handles initial category and party mappings, it’s a good idea to review and update mappings regularly to ensure accuracy over time.

</details>

<details>

<summary>Will upgrading duplicate journal entries?</summary>

No. The Cutover date controls ownership. Transactions on/after that date are recorded by the new connector and replace the prior connector’s entries for that period.

</details>

<details>

<summary>How far back can the new connector import?</summary>

It can import back to your Gusto account’s inception.

</details>

<details>

<summary>If I'm upgrading, do I need to disconnect my current Gusto connection first?</summary>

No. Keep it connected—click **Upgrade Gusto**, set your Cutover date, and save.

</details>

<details>

<summary>Can I see payroll details broken out by type directly in Digits?</summary>

When you're viewing a report, you can hover over Gusto data to see payroll details broken down by type — such as Payroll Taxes, Employee Pay, and Gross Salary — right inside Digits. There's no need to log into Gusto separately. This makes it easy to review and analyze payroll activity as part of your regular monthly close without switching between tools.

</details>

<details>

<summary>Can I set a custom import date for Gusto payroll imports?</summary>

Yes. You can set a start date for your Gusto connection:

1. Go to **Connections → My Connections**
2. Click **Manage** next to **Gusto**
3. Turn off **Historical transaction import**
4. Set the **Start date** for the account

Digits will import Gusto transactions starting from that date.

</details>

***

{% columns %}
{% column width="66.66666666666666%" valign="middle" %}
Got a question or feedback? Our team is all ears—come say hello!
{% endcolumn %}

{% column width="33.33333333333334%" valign="middle" %}

<p align="center"><a href="https://app.gitbook.com/s/x8QKZsFt122QPdcslRDC/contact-us" class="button primary" data-icon="envelope-open-text">Contact Digits Support</a></p>
{% endcolumn %}
{% endcolumns %}

***