Skip to main content
A location is one operational site of your dental clinic account: a branch, an office or any place where your team uses supplies. Your account (the Dental clinic you pick when you sign in) can have many locations. The API and the technical references call a location a clinic and the account a tenant; in the console you always see Locations. Almost everything operational hangs from a location:
  • Express warehouses belong to exactly one location. Central warehouses belong to none and serve all of them. See Warehouses.
  • Rooms and areas (treatment rooms and other places where supplies are used) belong to one location. See Rooms and areas.
  • Orders are created for a location and delivered to one of its warehouses. See Create and track orders.
  • Location access decides which locations each team member works in. See Team.

​
Who can do it

In Team, settings.manage is shown as Manage clinic configuration. Owners and admins hold it through their role. A member without it sees the same screens in read only mode: no New location button, the name as plain text and no activate or deactivate button. See Roles and permissions.

​
Where

Main navigation, Locations (console.muveya.com/clinics). Selecting a location’s name opens its detail (/clinics/ followed by the location id).

​
The Locations list

The list shows every location of the account, in the order they were created. Search locations filters by name as you type. It ignores upper and lower case and accents, so clinica norte finds “Clínica Norte”. Empty states:
  • No locations yet: No locations yet. Managers read Create the first location to connect its warehouses and supplies.; everyone else reads Ask your clinic administrator to add a location.
  • A search with no match: No matching results and Try a different search.
The list is not filtered by location access. Every member sees every location here; location access narrows orders, approvals and deliveries, not this list.

​
Create a location

1

Open the form

In Locations, select New location. A dialog titled New location opens.
2

Name the location

Type the Location name, for example Clínica Norte.
3

Save

Select Save location. The button reads Saving… while the request runs. When it finishes, the dialog closes and the location appears in the list as Active.
Select Cancel to close the dialog without creating anything. While a save is running the dialog cannot be closed.

​
Fields and rules

  • A location has only a name and a status. There is no location code or address field.
  • Names are not checked for uniqueness: two locations can share a name. People choose locations by name in every screen, so give each one a distinct name.
  • A new location always starts as Active.

​
First setup from Home

When the account has no location yet, managers see the card Create the first location under To start operating on Home. It opens the same New location dialog. After you save it, the New warehouse dialog opens right away with the name Main warehouse filled in:
  • Warehouse type starts as Central. A central warehouse serves every location.
  • If you switch it to Express, the location you just created is already selected in Location, so the warehouse belongs to it.
Closing either dialog ends the journey. You can always create warehouses later from Warehouses.

​
The location detail

Open a location from the list. The header shows its name and Manage this location and its availability. Select Back to locations to return. The detail has three parts:
  1. Name. Managers see an editable Location name field with Save changes. Everyone else sees the name as text.
  2. Status. A heading such as Status: Active, and for managers the button Deactivate location or Activate location.
  3. Rooms and areas. The treatment rooms and areas of this location, with their stock control and stock point. See Rooms and areas.
The detail does not list the location’s warehouses. To see them, open Warehouses: the Location column names the location each express warehouse belongs to.

​
Rename a location

1

Open the location

In Locations, select the location’s name.
2

Change the name

Edit Location name. The same rules apply: required, at most 120 characters.
3

Save

Select Save changes. When it finishes, Changes saved appears under the button.
Records point to the location, not to its name, so the console screens that name it (orders, warehouses, rooms and areas, team access) show the new name, including for work recorded before the change.

​
Statuses

To change it, open the location and select Deactivate location or Activate location. The change applies immediately and can be reversed at any time. There is no confirmation step and no way to delete a location.

​
What deactivating a location does

Activating the location again makes it available for new orders and new express warehouses.

​
What the system records

  • Creating a location stores its name and the active status in your account. Renaming or changing the status updates that same record.
  • These changes are not stock movements and never touch the inventory ledger.
  • muveya does not write a separate audit entry for creating, renaming or changing the status of a location.
  • Locations are never deleted, so every order and record that mentions one keeps showing its name.

​
Location access for team members

Each member has Location access: All locations in this account (including locations created later), Selected locations or No location. It decides which locations’ orders, approvals and deliveries the member sees, and for which locations they can create orders. A member with No location sees none of them. Access is managed from Team; see Team.
If a member’s access lists specific locations, a location you create later is not added to it. Open the member in Team and add the new location.

​
From the API and MCP

  • The public API lists locations with GET /v1/clinics (scope clinics:read). Each item has clinicId, name and status. The API cannot create or change locations. See Scopes.
  • The MCP tool clinics.list lists locations and warehouses with their ids, names and statuses. See MCP tools.

​
What can go wrong

If the list or the detail cannot load, the error appears with a Try again button.

Warehouses

Central and express warehouses, and how orders and inventory use them.

Rooms and areas

Where supplies are used inside a location.

Team

Give each member access to the right locations and warehouses.

Create and track orders

Order supplies for a location.