Skip to main content
This guide takes a new organisation from an empty portal to a fully mapped estate. You’ll build it in this order:
1

Places

Regions, locations, buildings and rooms, created on the Locations page.
2

Assets

Everything you own in each room, imported from a CSV file on the Assets page.
3

Devices

The assets M.A.R.C.U.S. should monitor and control, set up from the asset list.
Build in this order, because each step looks up the one before it. The asset import places each asset by building and room name, so those rooms must already exist. A device set up from an asset picks up that asset’s details.

Assets and devices

  • An asset is anything you own and want on record: a display, a codec, a wall mount, a cable, a spare remote. It holds the asset tag, make, model, serial number, warranty and where it is.
  • A device is an asset that M.A.R.C.U.S. monitors. A Collector polls it for status and readings, and you can send it commands.
Every device can be linked to one asset, and the Assets list marks linked assets as Monitored. A wall mount stays an asset only, while the display on it is an asset and a device.

Before you start

You need:
  • the Manage locations, Manage assets and Manage devices permissions. The admin role has all three; see Roles and permissions.
  • at least one Collector installed and online. See Quickstart and Deploy the Collector.
  • your list of sites, buildings and rooms, and your asset register, if you have one.
Agree on names before you start, and use them exactly the same way everywhere. The asset import matches building and room names letter for letter. Capitals don’t matter, but Park House and Park Hse are different buildings.

1. Build your places

Your estate is organised in four levels: You can limit a user’s access to particular regions, locations, buildings or rooms. Choose your levels with that in mind: if a team looks after one site, make that site a location. See Users and access.

Create a region

  1. Go to Locations, under Manage in the sidebar.
  2. Select New region, enter a Name and select Create.
Every location belongs to a region. If you don’t need regions, create one region, such as your organisation’s name, and put everything in it.
If your organisation uses business units, the Business units section appears at the top of Locations. Create the business units first, then choose one for each region.

Add locations, buildings and rooms

Each row on the Locations page has a button that adds the next level down:
  1. On the region, select + Location and enter the location’s name.
  2. On the location, select + Building. As well as the Name, fill in:
    • Address: the building’s postal address.
    • Timezone: such as Europe/London.
    • Map coordinates: select Geocode from address to fill in the Latitude and Longitude, or enter them yourself. Buildings without coordinates don’t appear on the Map.
  3. On the building, select + Room and enter the room’s name. Repeat for every room.
Use the pencil to rename anything, and the bin to delete it. Before deleting, the portal tells you what’s inside, such as rooms and devices. To group rooms across buildings, such as every courtroom, use room tags.

2. Import your assets

Get the template

Download the asset import template and open it in Excel or any spreadsheet program. It has every column, and example rows you can overwrite.
If the download doesn’t start, copy this into a text editor and save it as asset-import-template.csv:
asset-import-template.csv
If you already have assets in M.A.R.C.U.S., select Export on the Assets page instead. You get every asset you can see, in the same layout, ready to edit and import back.

Fill in the columns

Only name and category are required. Leave out any other column, or leave its cells blank. Columns are matched by their heading, so their order doesn’t matter, and columns the import doesn’t recognise are ignored.

Categories

Statuses

Categories and statuses are written in lower case, with underscores, exactly as in these tables.

Placing assets

Fill in building and room together, or leave both blank. An asset with neither is unplaced: it’s on record, but not in a room, which suits spares and stock.
Only users who can see your whole estate can see unplaced assets. Users whose access is limited to some locations, buildings or rooms don’t see them.
If two buildings have the same name, such as a Main Building on two sites, fill in region and location too, so the import knows which one you mean. Otherwise region and location are for your reference, and the import doesn’t check them.

Save the file as CSV

In Excel, select File > Save As and choose CSV UTF-8 (Comma delimited). Other programs call it something like “CSV, UTF-8”. UTF-8 keeps characters such as é and – intact. The file can be up to 4 MB, which is tens of thousands of assets.

Import it

  1. Go to Assets, under Manage in the sidebar.
  2. Select Import and choose your file.
  3. Read the result:
    • Processed, Created and Updated show what happened.
    • If any row has a problem, nothing is imported. The portal lists each problem with its row number, which is the row number in your spreadsheet. Fix those rows and import the whole file again.
Every import is recorded in the audit log as asset.import, with the number of assets created and updated.

Common problems

Asset tags and re-importing

The asset tag is how the import recognises an asset it has seen before:
  • A row with a new asset tag creates an asset.
  • A row with an asset tag that already exists updates that asset.
  • A row without an asset tag always creates a new asset.
So give every asset a tag if you can. Then you can keep your register in a spreadsheet and import it whenever it changes. The usual way to make changes in bulk is:
  1. Select Export on Assets.
  2. Edit the file: move assets, correct serial numbers, mark old kit retired.
  3. Import it back.
An update replaces every field of the asset with what’s in the row, including blank cells. If you import a row with a blank serial_number, the asset’s serial number is cleared. A row with blank building and room makes the asset unplaced. Export first and edit the export, rather than importing a file that has only some of the columns filled in.Rows without an asset tag are never matched, so importing the same untagged file twice creates every asset twice.

3. Start monitoring devices

Now choose the assets M.A.R.C.U.S. should monitor: the displays, codecs, DSPs, cameras, touch panels, PDUs and switches on your network. See Supported devices for what each one needs.
  1. On Assets, find the asset. Filter by building or category to narrow the list.
  2. In the Monitored column, select Set up.
  3. The device form opens with the asset’s details already filled in. Choose the Collector that can reach the device, its Protocol and Address, and enter its credentials if it has any.
  4. Select Create device.
The device is linked to the asset and is in the asset’s room. Its Collector picks it up within seconds, and the asset shows as Monitored.

From the Devices page

You can also select New device on Devices. Choose the Room, then choose the asset under Linked asset, which lists only assets not yet linked to a device. If the equipment isn’t in your asset register yet, leave Linked asset blank and fill in the Physical inventory (CMDB) section. It creates the asset and links it in one go. Later, when you edit the device, Pull from device fills in the make, model and serial number from what the device reports.
Many devices report their own model, serial number and firmware. Once a device is online, open it and compare Device Information with its asset to catch typos in your register.

4. Check your work

  • Places, in the sidebar, shows every region, building and room with their devices and a status dot for each.
  • Overview has a tile for each building. Devices in the Unassigned tile have no room: edit each one and choose its Room.
  • Map shows a pin for each building with devices. Buildings listed under Missing coordinates need a latitude and longitude on Locations.
  • Assets: filter by building to check each room’s contents. Assets that should be monitored but don’t show as Monitored still need a device.

Next steps

Alerts and notifications

Send alerts to email, Microsoft Teams or your service desk.

Room Readiness

Switch rooms off overnight and check they’re ready each morning.

Users and access

Invite your team, and limit who sees which places.

Dashboards

Build a dashboard or a wallboard for your estate.

Updated 06 Nov 2026 14:07 · page 3fc987c