Fluent Commerce Logo
Docs
Sign In

Switch Store Locations

How-to Guide

Author:

Fluent Commerce

Changed on:

20 Feb 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
No alt text provided

Steps

Step arrow right iconWho is this guide for?

This guide is aimed at In Store users.

Step arrow right iconPrerequisites

Step arrow right iconStep 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 }

Language: json

Name: get Users query

Description:

Sample get Users query

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}

Language: json

Name: Sample query users output

Description:

this user have access to locations 5000236, 5000237 and 5000238.

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

Language: json

Name: updateUser mutation to add roles/contexts to an user

Description:

sample updateUser mutation


Step arrow right iconStep 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 arrow right iconStep 3: logon to Fluent STORE

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

Step arrow right iconStep 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 arrow right iconStep 5: switch location

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

Fluent Commerce

Fluent Commerce

Copyright © 2025 Fluent Retail Pty Ltd (trading as Fluent Commerce). All rights reserved. No materials on this docs.fluentcommerce.com site may be used in any way and/or for any purpose without prior written authorisation from Fluent Commerce. Current customers and partners shall use these materials strictly in accordance with the terms and conditions of their written agreements with Fluent Commerce or its affiliates.

Fluent Logo