> For the complete documentation index, see [llms.txt](https://orbit-b2b.gitbook.io/orbit-b2b-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://orbit-b2b.gitbook.io/orbit-b2b-docs/companies/assign-tier.md).

# Assign a pricing tier

In the Company editor → **Customer group** tab → pick a Customer Group from the dropdown.

What happens:

* Every contact of this company gets the group's tag immediately (e.g. `wholesale-gold`)
* New contacts added later also get the tag automatically
* Existing wholesale/volume pricing rules that target "Customer Group → Gold tier" apply at checkout — no rule changes needed

***

## Example

```
Customer Group "Gold tier"        tag: wholesale-gold
  ↓
Wholesale Pricing rule
  "Gold tier — 20% off"
  Eligibility: Customer Group → Gold tier
        ↓
Company "Acme Distributors"
  Assigned to: Gold tier
  Contacts: Jane, Tom, Priya
        ↓
Result: Jane / Tom / Priya all see 20% off at checkout
```

***

## Changing the tier

Switch the dropdown to a different group → all contacts of this company get re-tagged:

1. Old tag removed (unless a contact is also linked to another company that uses the old tag)
2. New tag applied

Switch back to **No group assigned** → all contacts lose the tag.

***

## What if a contact is in 2 companies?

You'd see a warning in the reconcile script output. The app doesn't auto-resolve this — you decide which company owns the contact. We recommend keeping each customer as a contact of one company at a time.

If two of your companies legitimately share the same buyer (rare), tag conflicts are handled gracefully but the customer's effective tier becomes whatever was applied last.

***

## Inactive companies

Setting a Company's status to **Inactive** does NOT push the tier change. Inactive companies hold their contacts dormant — tier is intentionally NOT applied. Flipping back to Active re-applies the tag.

Use this when:

* You're pausing an account temporarily (suspended, late payment, off-season)
* You want to keep the contacts on file but stop their wholesale discount

See [Status](/orbit-b2b-docs/companies/status.md) for details.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://orbit-b2b.gitbook.io/orbit-b2b-docs/companies/assign-tier.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.