> For the complete documentation index, see [llms.txt](https://help.dollarlabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/credit/set-up-credit-limits.md).

# Set up credit limits

Set credit limits on companies, locations and customers, set a default for every buyer on terms, put an account on hold, and adjust a balance by hand.

{% hint style="info" %}
**Plan:** Credit limits & net terms are available on the Founding plan.
{% endhint %}

A credit limit is the most a buyer can owe you at once on unpaid orders. Open **Dollarlabs B2B → Credit → Limits**.

## The four levels

You can set a limit at four levels. Use one, or combine them.

| Level              | Tab           | Applies to                                                 |
| ------------------ | ------------- | ---------------------------------------------------------- |
| **Global default** | **Global**    | Each buyer on terms who has no limit of their own          |
| **Company**        | **Companies** | Everything the company's contacts owe together             |
| **Location**       | **Locations** | Everything owed by orders placed for that company location |
| **Customer**       | **Customers** | One customer (for company buyers, the contact)             |

The **Companies** and **Locations** tabs appear once your store has a Shopify B2B company. Without companies, you see only **Global** and **Customers**.

### The tightest limit wins

**An order must fit under every limit that applies.** A contact at a company location is checked against their own limit (or the default), the location's limit and the company's limit. Whichever leaves the least room stops them.

So a customer limit higher than their location's or company's limit has no effect. The Limits table marks this with **capped by** and the parent's name, and a banner warns you: "{name}'s limit is higher than the one above them".

```mermaid
flowchart LR
    contact["Ana's own limit<br/>$8,000"] --> location["HQ location<br/>$6,000"]
    location --> company["Harbor Print Co.<br/>$10,000"]
    location -.->|"Tightest — this is<br/>what Ana can spend"| result["Ana can owe<br/>up to $6,000"]
```

Raising Ana's limit changes nothing here. To give her more room, raise the HQ limit.

{% hint style="info" %}
**Company orders count three times — once at each level.** An order by Ana at HQ adds the full order total to Ana's balance, to HQ's balance and to Harbor Print Co.'s balance. Each limit is then checked against its own balance. The Overview's **Outstanding** total counts each order once.
{% endhint %}

### Who the global default applies to

On the **Global** tab, **Default limit per buyer (USD)** (or **Global default limit (USD)** on stores without companies) caps each **buyer on terms** who has no limit of their own:

* customers who carry one of your [net-term tags](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/credit/net-terms.md), and
* contacts at a company location that has payment terms in Shopify.

A buyer with their own limit uses that instead. The default never applies to companies or locations, and it never applies to ordinary retail customers. Leave the field empty for **Unlimited**.

{% hint style="warning" %}
**Unlimited means unlimited.** With no default and no limit of their own, a buyer on terms can keep ordering on credit. Nothing stops them unless their company or location has a limit.
{% endhint %}

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-6ebb2d4a66cbfe3cad788c4d694d5e017efb0737%2Fcredit-limits-global-annotated.png?alt=media" alt="Limits page, Global tab: Default limit per buyer (USD) set to 2000.00, and three boxes for the buyer, location and company limits."><figcaption><p>The global default, and the three levels that apply to a company contact.</p></figcaption></figure>

## The default: over limit means no checkout

{% hint style="danger" %}
**A buyer whose order would take them over any limit can't check out at all — by any payment method, card included.** Only an [over-limit rule](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/credit/over-limit-rules.md) with **Let these orders through even when over the limit** ticked changes that.
{% endhint %}

The check happens at checkout, against the order total with shipping and tax. Adding to cart is never blocked.

**Worked example.** Ana orders for Harbor Print Co.'s HQ location.

|                                                    | Amount                      |
| -------------------------------------------------- | --------------------------- |
| HQ location limit                                  | $6,000                      |
| HQ already owes                                    | $4,200                      |
| Room left                                          | $1,800                      |
| Ana's cart at checkout (shipping and tax included) | $2,500                      |
| HQ would owe                                       | **$6,700 — over the limit** |

Ana's checkout is refused with: "This order exceeds the location credit limit. Available 1800.00 USD, order total 2500.00 USD." Switching to a card doesn't help.

To let her order, do one of these:

* She removes $700 from the cart, or pays down the balance.
* You raise the HQ limit.
* You add the **Require payment upfront when over limit** rule, so she can check out by paying in full. See [Over-limit rules](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/credit/over-limit-rules.md#templates).

The same check caps the size of a single order. A customer with a $1,500 limit who owes nothing can't place a $1,800 order, even by card.

While at least one limit exists and you have no active **Block orders** rule and no active pay-upfront rule that lets orders through, the Limits page shows a reminder: **Buyers over their limit are blocked from checking out, including by card**, with a link to that template.

## Set a limit

{% stepper %}
{% step %}

### Pick a tab

Select **Companies**, **Locations** or **Customers**. Each tab shows how many limits it holds.
{% endstep %}

{% step %}

### Add the account

Select **Add company** (or **Add location**, **Add customer**) and pick from Shopify's list. The picker shows the first 250 customers or companies, and up to 20 locations per company. For more, [import a CSV](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/credit/import-and-export.md#limits-csv).
{% endstep %}

{% step %}

### Type the limit

Type an amount in **Limit (USD)**. Limits are in your store's currency. `0` is a valid limit: it refuses every order from that account, card included, unless a rule lets it through.
{% endstep %}

{% step %}

### Save

Select **Save** in the bar at the top. You see "Limits saved".
{% endstep %}
{% endstepper %}

To remove a limit, clear the field ("Removes this limit on save") and save. To change many at once, tick the rows and use **Bulk amount**.

### The Limits table

| Column              | What it shows                                                                                                                                        |
| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**            | The account. Select it to open its account page. Badges: **New**, **On hold**, **Hidden from buyers**                                                |
| **Limit (USD)**     | The limit you set at this level                                                                                                                      |
| **Effective limit** | What actually stops them, and why: **no cap set**, **buyer default**, **their own limit**, or **capped by** a parent. Amber when a parent is tighter |
| **Outstanding**     | What they owe now. "$X in credit" when they've overpaid                                                                                              |
| **Available**       | Room left. "—" when nothing caps them                                                                                                                |
| **Utilization**     | **N% used** (amber from 80%) or **Over limit**                                                                                                       |
| **Actions**         | **History** (the account page) and **Hold** / **Release**                                                                                            |

An account also appears here without a limit when it owes money or is on hold.

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-bf2f0fe2e965dd44f4c7432452906522e0940774%2Fcredit-limits-customers-annotated.png?alt=media" alt="Limits page, Customers tab: Ana Lopez with an 8000.00 limit capped by HQ at $6,000, Cleo Marsh over limit on the buyer default, and the warning that Ana Lopez’s limit is higher than the one above them."><figcaption><p>Effective limit shows what a buyer can really spend: here the HQ location caps Ana at $6,000.</p></figcaption></figure>

### Hide a company or location limit from buyers

Company and location limits show on the buyer's **Credit & statements** page by default. To hide them, tick the rows on the **Companies** or **Locations** tab and select **Hide from buyers**. It applies at once; the row shows **Hidden from buyers**. **Show to buyers** reverses it.

Hiding changes only what contacts read. The limit still applies at checkout, and a hold still shows. A customer's own limit is always visible to that customer.

## Put an account on hold

A hold stops an account from ordering — **every order, even by card** — until you release it. It needs no limit, and it outranks every limit and rule. Existing orders and balances stay as they are.

1. On the Limits table, select **Hold** on the row (or tick rows and select **Put on hold**). You can also use **Put on hold** on the account page.
2. Type a **Reason**, for example "Two invoices 45+ days overdue, awaiting finance call". It's kept with the hold so your team can see why.
3. Select **Put on hold**.

Holding a company stops all its contacts. Holding a location stops orders for that location.

At checkout the buyer reads "Your account is on hold. Please contact us to place orders." Change that under **Change what buyers read while on hold** (see [What buyers see](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/credit/what-buyers-see.md#what-buyers-read)). The buyer also gets the **Account on hold** email, and **Hold released** when you select **Release**.

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-ab04864f1e619b4913ba7664cae763216a0fb725%2Fcredit-hold-modal-annotated.png?alt=media" alt="Put HQ on hold dialog saying no order can be placed for this location, even by card, with a Reason field and the Put on hold button." width="682"><figcaption><p>A reason is required, so anyone can see why the hold was set.</p></figcaption></figure>

## The account page

Select an account's name (or **History**) to open its page.

* **Limit**, **Used** and **Available**, with a line naming the tightest limit, for example "Tightest limit: location HQ."
* **Ledger history** — every order, payment, refund, cancellation and adjustment, with the due date and the running balance.
* **Sent emails** — the credit emails sent about this account, with **Resend**.
* Actions: **Adjust balance**, **Put on hold** / **Release hold**, **Export ledger**, **View in Shopify**.

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-55899cbee7556422789bddb62935a14f4eb80874%2Fcredit-account-page-annotated.png?alt=media" alt="Account page for the HQ location: Limit $6,000, Used $4,900, Available $1,100, and a ledger with a payment received and three orders due Dec 3, 2026."><figcaption><p>The account page shows the tightest limit and every entry behind the balance.</p></figcaption></figure>

### Adjust balance

Use **Adjust balance** for money that didn't go through a Shopify order: a bank transfer, a write-off, an old invoice, a fee.

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-b6d4f938de20f468c2b584ddfeb06ec1044259a7%2Fcredit-adjust-balance-annotated.png?alt=media" alt="Adjust balance dialog for the HQ location with Type Credit — payment or write-off, Amount, Reference (optional), Reason, and Post adjustment." width="682"><figcaption><p>A credit lowers what the account owes; a debit adds an invoice with a due date.</p></figcaption></figure>

| Field                    | What to enter                                                                                 |
| ------------------------ | --------------------------------------------------------------------------------------------- |
| **Type**                 | **Credit — payment or write-off** lowers the balance. **Debit — invoice or charge** raises it |
| **Amount (USD)**         | Above 0, in your store's currency                                                             |
| **Due date**             | Debits only. Overdue rules and reminders count from this date                                 |
| **Reference (optional)** | For example "Bank ref 4471"                                                                   |
| **Reason**               | Required. **The buyer sees it in their statement**                                            |

Select **Post adjustment**. A balance can go below zero; the buyer is then "in credit".

{% hint style="warning" %}
**An adjustment posts to one account only.** On a company or location, it doesn't reach the contacts. If the balance should show at each level, post the same adjustment on the contact, the location and the company — or [import balances](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/credit/import-and-export.md#balances-csv) with three rows.
{% endhint %}

## Next

* [Over-limit rules](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/credit/over-limit-rules.md) — warn instead of refuse, or ask for payment upfront
* [Net terms](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/credit/net-terms.md) — who buys on terms
* [Import & export](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/credit/import-and-export.md) — set many limits at once
