How to enable Region Segmentation

Region segmentation lets you author and serve content tailored to specific countries or regions. Once enabled at the workspace level, you can mark collections (and agents) for specific regions, and Brainfish will route visitors to the right content automatically.

When to use it

• You serve customers in multiple countries with materially different policies, products, or pricing.
• You want a single Help Center to deliver region-specific content from one URL.
• Your agents (Help Center or web widget) should default to the visitor's region.

Step 1 — Turn region segmentation on

1. In the Brainfish admin, open Settings → Company → Details.

2. Scroll to the bottom and toggle Enable region segmentation on (the indicator should be green).

3. Click Save.

   

   

Step 2 — Tag a collection with a region

1. Return to the main Brainfish app.

2. Open Knowledge → Collections and click New Collection (top-right).

3. Name the collection and, under Select region, choose the region this content applies to.

4. Click Create.

   

Step 3 — Add region-specific articles

1. Open the new collection and create or move articles into it.

2. Publish the articles. The article preview shows the region this content is tagged with.

   

Step 4 — Surface the region on a Help Center URL

To deep-link directly to a region in your Help Center, add a query parameter to the URL:

https://yoursubdomain.brainfi.sh/?region=US

See Navigate to a specific region for the full list of supported region codes.

Configuring region behavior on agents

If you want a web agent (Search bar / Sidebar / Popup) to filter by region at embed time, configure it via overrides — see Configuring Region Segmentation for Agents.

FAQ

What is region segmentation? A feature that lets you author and serve different content to different geographic regions, while sharing one Brainfish workspace.

Can I disable it after enabling? Yes. Toggle it back off in Settings → Company → Details. Existing region-tagged content remains; it just stops being filtered.

Is there a limit to how many regions I can target? No enforced limit — see Navigate to a specific region for the list of supported codes (around 200 ISO-3166 codes).