Sharing Products and Clients with Selected Branches
Instead of sharing products or clients with all of the account’s branches or with none, you can now choose which branches share information, so each branch sees only the catalog and clients that belong to it. This is useful when some branches run a different line of business or operate in a different country.
Required permissionsEdit General Settings, the Branches app enabled, and a plan that includes the Branch Selective Product Sharing feature for products and Branch Selective Client Sharing for clients.
How to accessBranches > Branches Settings > Branch Sharing Settings
Article contents
Fields
- The list shows active branches only.
- The list becomes searchable when you have more than 10 branches.
- Leaving the list empty means sharing with all branches, as it was before the update.
| Field | Default | Appears when | What it does |
|---|---|---|---|
| Clients (toggle) | Disabled | Always | Shares clients between branches |
| Clients shared between | Empty = All Branches | The toggle is enabled and your plan includes the feature | Multiselect for the branches that share clients. Description: Select the branches that will share client information |
| Products (toggle) | Disabled | Always | Shares products and services between branches |
| Products shared between | Empty = All Branches | The toggle is enabled and your plan includes the feature | Multiselect for the branches that share products |
How sharing works
- The branches selected in the list form a single group; each branch in it sees the products (or clients) of the other branches in the group.
- Sharing is symmetrical: adding a branch to the list lets it see the other branches’ information and lets them see its information, and removing it removes visibility in both directions.
- A branch that is not in the list sees only its own information.
- You must select at least two branches; otherwise the message Products must be shared between at least two branches. (or Clients) appears.
- Turning off the sharing toggle resets the list to All Branches when you save.
The effect of changing a branch’s status
- When you suspend or disable a branch, it is automatically removed from all sharing lists.
- If no branch is left in a list, it goes back to All Branches.
- When you reactivate a branch, it does not rejoin sharing automatically; add it manually.
Where the effect appears
- Product and client lists, and searches for them in Invoices and Documents.
- Point of Sales on the web, mobile, and desktop: products and clients are loaded according to sharing.
- Each branch’s Stock Balance depends on its warehouse and its settings, regardless of sharing.
Example
- You have four branches: Riyadh, Jeddah, Dammam, and Cairo.
- You enable Products and, under Products shared between, select Riyadh, Jeddah, and Dammam.
- The three branches see and sell each other’s products, while Cairo sees only its own products, and the three branches do not see Cairo’s products.
- If you later remove Jeddah from the list, Jeddah no longer sees the products of Riyadh and Dammam, and they no longer see Jeddah’s products.
What happens when you save?
- The list is saved as a general setting for the account (not for each branch).
- If the toggle is disabled, the list is automatically saved as All Branches.
- If your plan does not include the feature, the field does not appear, and the toggle works as before: sharing with all branches.
- The message Settings have been saved appears, and the change takes effect immediately in lists and searches, and in Point of Sales after synchronization.
Other sharing settings on the page
| Toggle | Supports Branch Selection? |
|---|---|
| Clients | Yes |
| Products | Yes |
| Suppliers | No, all branches or no sharing |
| Cost Centers | No |
| Unit Templates | No |
Why can’t a branch see a product or client?
| Reason | Solution |
|---|---|
| The branch is not selected in the list | Add it to Products shared between or Clients shared between |
| The branch was suspended and then reactivated | It was removed from the list when it was suspended; add it again |
| The switch is Disabled | Each branch sees only its own information |
| Point of Sales has not been updated | Resync the data in the app |
Where is the configuration saved?
- Both lists are saved in the Branches app settings for the whole account, and they are read every time you search for a product or a client.
- The All Branches amount is saved when the list is empty or the switch is turned off.
- The plan check is cached, so the field may take a little while to appear after you upgrade your plan.
Error Messages and Solutions
| Message | Reason | Solution |
|---|---|---|
| %s must be shared between at least two branches. | You selected only one branch in the list. | Select two or more branches, or leave the list empty to share with all branches. |
| Main branch should not be empty | You did not specify the Main Branch in the Settings. | Select the Main Branch. |
🛈
Note: The report states that the feature is for the Enterprise plan; in the code, it is controlled by the plan limit mentioned, and it is Not Available by default.
Frequently Asked Questions
Why doesn’t the shared branches list appear?
The switch is Disabled, or your plan does not include the feature.
Can you select a single branch?
No, you need at least two branches.
What does a branch outside the list see?
Only its own information.
Does a suspended branch stay in the sharing?
No, it is removed automatically and does not come back when you reactivate it.
Does it affect Point of Sales?
Yes, on web, mobile, and desktop.