Switch Store Locations

Get Started
Functionality
Learning
Extension
Dev Tooling
APIs
Releases

How-to Guide

Author:

Fluent Commerce

Changed on:

5 Sept 2025

Key Points

This guide shows you how to seamlessly switch Store Locations within the Fluent Store web app
This guide is aimed at In-Store users

Prerequisites

Enable Fluent Store on your Existing Account

User Editing Mutation

Steps

Who is this guide for?

This guide is aimed at In Store users.

Prerequisites

Fluent Store is enabled
The context switcher is enabled for Fluent Store.
The logged-in user has been granted access to more than one location.

Step 1: Check User roles

Here is the step to ensure the user has the right roles. You can use Postman to get User details:

1POST: {{fluentApiHost}}/graphql
2
3
4Query:
5{
6   users ( first:10, ref:"%MANAGER%"){
7    edges {
8       node {
9            id
10            ref
11            status
12            type
13            username
14            primaryRetailer{
15                ref
16            }
17            status
18            primaryLocation{
19                ref
20            }
21            roles{
22                contexts{
23                    contextId
24                    contextType
25                }
26                role{
27                    id
28                    name
29                }
30            }
31       }
32       
33     }
34
35   }
36 }

The user should have multiple contexts:

1{
2    "data": {
3        "users": {
4            "edges": [
5                {
6                    "node": {
7                        "id": "33333",
8                        "ref": "5000299_MANAGER01",
9                        "status": "ACTIVE",
10                        "type": "AGENT",
11                        "primaryRetailer": {
12                            "ref": "sample_retailer"
13                        },
14                        "primaryLocation": {
15                            "ref": "5000299_SYD"
16                        },
17                        "roles": [
18                            {
19                                "contexts": [
20                                    {
21                                        "contextId": "5000299",
22                                        "contextType": "RETAILER"
23                                    },                                    
24                                    {
25                                        "contextId": "5000238",
26                                        "contextType": "AGENT"
27                                    },
28                                    {
29                                        "contextId": "5000236",
30                                        "contextType": "AGENT"
31                                    },
32                                    {
33                                        "contextId": "5000237",
34                                        "contextType": "AGENT"
35                                    }
36                                ],
37                                "role": {
38                                    "id": "3",
39                                    "name": "STORE"
40                                }
41                            }
42                        ]
43                    }
44                }
45            ]
46
47        }
48    }
49}

1POST: {{fluentApiHost}}/graphql
2
3Query:
4mutation updateUser ($input: UpdateUserInput) {
5    updateUser (input: $input) {
6        id
7        ref
8        username
9        title
10        firstName
11        primaryLocation{
12            id
13        }
14        lastName
15        language{
16            label
17            value
18        }
19        primaryEmail
20        primaryPhone
21        type
22        status
23        department
24        country
25        timezone
26        promotionOptIn
27        createdOn
28        updatedOn
29    }
30}
31
32
33Variable:
34{
35  "input": {
36    "id": 33333,
37     "roles": {
38      "role": {
39        "name": "STORE"
40      },
41      "contexts": [
42        {
43            "contextId": "5000299",
44            "contextType": "RETAILER"
45        },
46        {
47            "contextId": "5000238",
48            "contextType": "AGENT"
49        },
50        {
51            "contextId": "5000236",
52            "contextType": "AGENT"
53        },
54        {
55            "contextId": "5000237",
56            "contextType": "AGENT"
57        }
58      ]
59    }
60
61     
62
63  }
64}
65
66

Step 2: Check manifest

Go to OMS web app -> setting page to look up setting: `fc.mystique.manifest.store`Ensure it has the switcher setup in the manifest: No alt provided

Step 3: logon to Fluent STORE

Log into Fluent Store as a user who has been granted access to multiple locations

Step 4: check the navigation bar

Click on the active location in the top navigation bar, the list of available locations to navigate to should then appear in a dropdown. You can then switch to one of the available locations by choosing one from the list.

Step 5: switch location

You can navigate back to the previous location by repeating Step 2 and choosing the original location

Related content

Switch between all locations in Fluent Store

Edited 154 days ago

Store Interface

Edited 156 days ago

The Store interface empowers retailers to enhance their operational efficiency by transforming stores into fulfillment centers and optimizing inventory management. This ultimately delivers a superior customer experience through streamlined order fulfillment and improved inventory control. The app contains the following configurations:

All Locations
Stores
Warehouses
Networks

UX Framework - Configuration Guide

Edited 332 days ago

The OMX UX Framework delivers configuration-based solution implementation for UIs (Web Apps). Configuration is managed in a JSON document called the OMX Web App Manifest.

Enable location switcher in Fluent Store

Edited 641 days ago

Fluent Commerce

Step 1: Check User roles

Here is the step to ensure the user has the right roles. You can use Postman to get User details:

1POST: {{fluentApiHost}}/graphql
2
3
4Query:
5{
6   users ( first:10, ref:"%MANAGER%"){
7    edges {
8       node {
9            id
10            ref
11            status
12            type
13            username
14            primaryRetailer{
15                ref
16            }
17            status
18            primaryLocation{
19                ref
20            }
21            roles{
22                contexts{
23                    contextId
24                    contextType
25                }
26                role{
27                    id
28                    name
29                }
30            }
31       }
32       
33     }
34
35   }
36 }

The user should have multiple contexts:

1{
2    "data": {
3        "users": {
4            "edges": [
5                {
6                    "node": {
7                        "id": "33333",
8                        "ref": "5000299_MANAGER01",
9                        "status": "ACTIVE",
10                        "type": "AGENT",
11                        "primaryRetailer": {
12                            "ref": "sample_retailer"
13                        },
14                        "primaryLocation": {
15                            "ref": "5000299_SYD"
16                        },
17                        "roles": [
18                            {
19                                "contexts": [
20                                    {
21                                        "contextId": "5000299",
22                                        "contextType": "RETAILER"
23                                    },                                    
24                                    {
25                                        "contextId": "5000238",
26                                        "contextType": "AGENT"
27                                    },
28                                    {
29                                        "contextId": "5000236",
30                                        "contextType": "AGENT"
31                                    },
32                                    {
33                                        "contextId": "5000237",
34                                        "contextType": "AGENT"
35                                    }
36                                ],
37                                "role": {
38                                    "id": "3",
39                                    "name": "STORE"
40                                }
41                            }
42                        ]
43                    }
44                }
45            ]
46
47        }
48    }
49}

1POST: {{fluentApiHost}}/graphql
2
3Query:
4mutation updateUser ($input: UpdateUserInput) {
5    updateUser (input: $input) {
6        id
7        ref
8        username
9        title
10        firstName
11        primaryLocation{
12            id
13        }
14        lastName
15        language{
16            label
17            value
18        }
19        primaryEmail
20        primaryPhone
21        type
22        status
23        department
24        country
25        timezone
26        promotionOptIn
27        createdOn
28        updatedOn
29    }
30}
31
32
33Variable:
34{
35  "input": {
36    "id": 33333,
37     "roles": {
38      "role": {
39        "name": "STORE"
40      },
41      "contexts": [
42        {
43            "contextId": "5000299",
44            "contextType": "RETAILER"
45        },
46        {
47            "contextId": "5000238",
48            "contextType": "AGENT"
49        },
50        {
51            "contextId": "5000236",
52            "contextType": "AGENT"
53        },
54        {
55            "contextId": "5000237",
56            "contextType": "AGENT"
57        }
58      ]
59    }
60
61     
62
63  }
64}
65
66

Switch Store Locations

Key Points

Prerequisites

Enable Fluent Store on your Existing Account

User Editing Mutation

Steps

Who is this guide for?

Prerequisites

Step 1: Check User roles

Step 2: Check manifest

Step 3: logon to Fluent STORE

Step 4: check the navigation bar

Step 5: switch location

Related content

Switch between all locations in Fluent Store

Store Interface

UX Framework - Configuration Guide

Enable location switcher in Fluent Store

Fluent Commerce

Building Blocks

By Type

Helpful Resources

Quick Links

Who is this guide for?

Prerequisites

Step 1: Check User roles

Step 2: Check manifest

Step 3: logon to Fluent STORE

Step 4: check the navigation bar

Step 5: switch location