Skip to content

Commit 5353ef9

Browse files
committed
docs: call out environment scoping of synchronised segments
1 parent 0d98e99 commit 5353ef9

3 files changed

Lines changed: 24 additions & 1 deletion

File tree

docs/docs/third-party-integrations/cohort-synchronisation/amplitude.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -42,6 +42,14 @@ application uses as the Flagsmith [identity](/flagsmith-concepts/identities) ide
4242

4343
![Amplitude Flagsmith destination configuration](/img/cohort-synchronisation/amplitude-destination-config.png)
4444

45+
:::warning The key decides the environment
46+
47+
Every cohort sent to this destination is synchronised into the environment its key belongs to, and nothing in Amplitude
48+
shows which one that is. To synchronise cohorts into a second environment, create a key there and add a second Flagsmith
49+
destination for it.
50+
51+
:::
52+
4553
## 3. Synchronise a cohort
4654

4755
1. In Amplitude, open the cohort you want to target and click **Target users**.

docs/docs/third-party-integrations/cohort-synchronisation/csv-import.md

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,14 +26,21 @@ Other columns are ignored, so you can upload an export without stripping it down
2626
1. Go to the **Segments** page in your project and click **Create Segment**.
2727
2. Choose **From a CSV list**.
2828
3. Give the segment a name and, optionally, a description.
29-
4. Select the environment the identities should be targeted in. The segment will only have members in that environment.
29+
4. Select the environment the identities should be targeted in.
3030
5. Drag your CSV file onto the upload area, or click **Select file** to browse for it.
3131
6. Check the **Identifier column** that Flagsmith has picked, and change it if the identifiers are in a different
3232
column. Untick **First row contains headers** if your file starts with data rather than column names.
3333
7. Review the preview and the number of identifiers detected, then click **Create Segment**.
3434

3535
![Creating a segment from a CSV list](/img/cohort-synchronisation/csv-create-segment.png)
3636

37+
:::warning Choose the environment carefully
38+
39+
The identities you upload are only targeted in the environment you select, and that choice cannot be changed later. To
40+
target the same list in another environment, create a second segment there and upload the same file.
41+
42+
:::
43+
3744
## Updating the members
3845

3946
Membership only changes when you upload a new file, so re-upload whenever your list has moved on.

docs/docs/third-party-integrations/cohort-synchronisation/index.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,14 @@ Cohort synchronisation is available on paid plans.
2121

2222
:::
2323

24+
:::warning Synchronised segments belong to one environment
25+
26+
You choose the environment when you set the segment up, and it cannot be changed afterwards. The segment has no members
27+
in any other environment, so an override you add in, say, Production will not match anyone if the segment was
28+
synchronised into Development. To target the same group in another environment, set the segment up again there.
29+
30+
:::
31+
2432
## Supported sources
2533

2634
- [CSV import](/third-party-integrations/cohort-synchronisation/csv-import)

0 commit comments

Comments
 (0)