User Support

Welcome to the CoWorkr user guide

Here you will find detailed information on our app features and general information like definitions and user processes. Additional information, such as API documentation may be provided to authorized users with approval by CoWorkr.

Support Documents:

Section 0 - General Information on CoWork Software & Hardware, Definitions

Section 1 - App basics

Section 2 - Full App Setup and User Guides

If you're just getting started, try starting from the top. If you're a veteran but stuck on a feature try using the search bar.


Not finding what you’re looking for? Send us an email.


0.0 Definitions

0.1 WorkPoint

CoWorkr’s Sensor hardware, called a “WorkPoint”,  reports an occupancy state, using various methods of sensing. WorkPoints report a reading of “Occupied” instantaneously and otherwise, if no change of status is observed, a WorkPoint has a “heartbeat” that reports an update to CoWorkr every minute, letting CoWorkr know it’s online. WorkPoints also contain a notification button that reports to CoWorkr if pressed.

WorkPoint Versions:

    V1 - Version 1 WorkPoint that uses temperature or vibration sensing (no longer available)

    V2 - Version 2 WorkPoint that uses temperature or vibration sensing

    V3 - Version 3 “Motion” WorkPoint that uses passive infrared (PIR) sensing

WorkPoints attributes:

WorkPoint UUID:  Unique string defined by a WorkPoint’s Bluetooth radio, for example “B827EB13B5F2”

WorkPoint ID: Unique string assigned to a WorkPoint when created on CoWorkr, for example, “54f45a67ac641604fd9bfa1a”.

Name: A custom value assigned by users via CoWorkr’s app. Its default value is the WorkPoint’s UUID.

Firmware: The version of firmware running the WorkPoint.

Notes: A custom field for users to input misc. information regarding a WorkPoint

WorkPoint Statuses: The state of a WorkPoint changes with time and its sensor status. The following states may exist:

      connected - true if the WorkPoint has reported to the server within an anticipated time frame, false if hasn’t recently reported to the server

      recentlyConnected: (CoWorkr Admin use only) 

      occupied - true if the workPoint is reporting an occupied state, false if not occupied 

      occupiedBy - (CoWorkr Admin use only) string with admin info on the occupied state

      occupyReason - (CoWorkr Admin use only) string with admin info on the occupied state

      occupancyChanged - timestamp of the last reported change in status - A notification button on the WorkPoint has been pressed 

      flags.button1 - WorkPoint Notification Button 1 has been pressed

      flags.button2 - WorkPoint Notification Button 2 has been pressed 

      rssi - (CoWorkr Admin use only) signal strength

      battery - (CoWorkr Admin use only)

      optical - (CoWorkr Admin use only) if available, a light intensity reading


0.2 WorkHub 

CoWorkr’s internet-enabled device that reads and pushes WorkPoint data to CoWorkr’s servers. WorkHubs, or “Hubs”, require an internet connection using LAN, WiFi, or Cellular dongle to operate. 

WorkHub Attributes:

WorkHub ID: Unique string given to a WorkPoint when placed onto a Floorplan, for example, “54f45a67ac641604fd9bfa1a”

WorkHub UUID: Unique string associated with a WorkHub’s Bluetooth radio, for example “CE27EB1455F1”

0.3 WorkPlace

A physical location from where WorkPoints and Workhubs are streaming. A WorkPlace is generally used to represent a single location that is based on a geographical address - for example, a building. WorkPlaces contain one or more Floorplans to which WorkPoints and WorkHubs are assigned. 

WorkPlace Attributes:

WorkPlace ID: A unique case-sensitive alphanumeric identifier, for example “YvamDKDx6KD4QZh5g”, given to a WorkPlace on creation.

WorkPlace Name: A custom field assigned to the WorkPlace by a user.

Address: The physical location of the WorkPlace. This is also used to pair with geolocation services of WorkHubs.

Timezone: The local timezone of the WorkPlace. 

Group: A grouping of users with specific access permissions. Groups are generally created for each customer to segment access but may also be a group of users that belong to a 3rd party that oversees multiple customers. A group is identified by a given Name and a case-sensitive alphanumeric ID, for example “nzYf5H8RNBYSgrLHJ’

Start & End: “Start Date” is the first day the data is to stream from a corresponding WorkPlace.  “End Date” is the day the data at the corresponding WorkPlace will end its streaming. These dates are generally defined by the customer’s subscription period.

Active Hours: “Active Start Hour“ and “Active End Hour” hours determine a range of time wherein occupancy data will be ignored for a specific WorkPlace. This generally is used to eliminate occupancy data created outside of working hours such as that created by late-night cleaners. This is a custom field that can be set by an admin.

0.4 FloorPlan

An image file used as a background for CoWorkr’s floorplan view on which WorkPoints are placed. This is commonly a cad-based 2D drawing that has been exported as a raster image like jpeg or png.

FloorPlan Attributes:

FloorPlan ID: A unique string assigned to a FloorPlan upon creation.

FloorPlan Name: A custom, required, field given to the FloorPlan image upon upload.

FloorPlan X, Y: A location on the FloorPlan using a X-Y coordinate system, typically used to describe a WorkPoint location 

Location: A X,Y coordinate that locates a WorkPoint icon on a Floorplan image on CoWorkr’s App

0.5 Tags

Values assigned to WorkPoints to describe, but not limited to, the physical location or the use of the space. Tags contain 2 values, a category and a value associated with that category. For example, a tag category/value for a WorkPoint assigned to a workstation may be “furniture/desk”.

0.1 WorkPlace Install General Information

WorkPlace Installation Overview:

The modern workplace is a complex network of work settings ranging from private soft seating to public bench seats to individual standing desks. CoWorkr devices are designed to be used in a variety of ways to cover all space and seat types.


CoWorkr WorkPoints

Motion WorkPoints cover almost all seat sensing opportunities

Motion WorkPoints can also be used to monitor small rooms

Vibration WorkPoints can be used where capturing motion by vision is not convenient, such as soft seating.

• Multiple WorkPoints may be combined in a Link, when any one is activated, all are activated

Read more about different WorkPoints in the next section on Devices

Read more about Linking in the App Topics 2.6 "Tags and Links"

How Many Seats to Sense?

It's important to understand that CoWorkr devices generally collect information at a per-seat basis and the greater number of seats monitored, the higher resolution data you'll receive. In some cases, based on the intent of data collection, one may only collect a sample of seats. In other cases, for example, in a phone room, one may choose to use a single WorkPoint even if there are multiple seats.

0.2 Hub Install General Information

Device Install Support

Admin user guide for installing coWorkr hardware

CoWorkr hardware is designed to provide flexible services for monitoring the use of space. While both WorkPoints and WorkHubs are agile devices that allow for flexibility in their use, it is important to follow general guidelines to ensure the best data outcomes.


“Hubs” are internet gateways for CoWorkr’s Workpoints. Hubs typically connect to CoWorkr's cloud via a Cellular network, however they may also use WiFi or LAN connection.

General Placement Considerations:

Hubs read data packets emitted from WorkPoints.  When placing Hubs on a floorplan, make sure not to place Hubs in areas  the are open to the surrounding WorkPoints. Furthermore, ensure the Hub is elevated in its location—above desk or partition level. Surrounding interior elements may block signal strength and result in lost data packets.  

Hubs require a power source, such as a USB to wall plug.

Placement Considerations per Connectivity Option:

Depending on which connectivity option is used, a Hub may need to be located in a particular location.

Best Practice: Place Hubs above the floor level - higher the better.

• CoWorkr’s Network (standard)

4G: If using a 4G connection provided by CoWorkr, the Hub should be placed in locations with a strong cellular signal strength. This typically means locating Hubs away from building cores and closer to the exterior walls.

• External or Client Network (nonstandard)

LAN: If using a LAN option, the Hub requires being within reach of an ethernet outlet.

WiFi: If using a WiFi option, the Hub must be placed in range of the nearest WiFi router.


0.3 WorkPoint General Information


CoWorkr uses several different WorkPoint technologies for monitoring spaces. Installation considerations vary per model of WorkPoint.

V3 Motion WorkPoint

Motion WorkPoints use a motion sensor to view the presence of workers. These devices work by “seeing” motion and require a view of the worker. These devices are versatile and can be stuck to the underside of desks, chairs, or ceilings to monitor individual areas or small rooms.

Cases (below): Motion WorkPoints have 2 types of plastic cases— one for desks and one for rooms. Desk cases have a narrow field of view while Room cases have a wide field of view.


Desk Case

Motion WorkPoint


Room Case

Motion WorkPoint


Chairs and Desks

Using a Motion WorkPoint with a Desk Case, install the device by sticking it facing downward on the underside of a desk or chair.



• Position the device so it’s just beyond the knees of a typical occupant, at least 12 in. (30cm) in from the edge of the desktop.

• Point the square device so its lens opening is “pointing” at the user’s body

• Movement by the occupant, when seated at the desk, will be detected


• Position the device in the middle of the underside of the seat, facing downwards

• Point the square device so its lens opening is “pointing” at the user’s feet

• Movement by the chair or by an occupant of the chair will be detected.



Using a Motion WorkPoint with a Room Case, install the device by sticking it to the ceiling, facing downwards. Any movement in the entire room will trigger an occupancy reading. If a room is longer than 10 ft (3m) we suggest using 2 WorkPoints.



• For Small Rooms, like phone rooms or small meeting rooms, use a single Motion WorkPoint with a Room Case.

• Position the Motion WorkPoint over the center of the workspace, such as over the center of a table or desk.

• The Motion WorkPoint will detect any motion within the room. It will not detect motion through glass walls.




•  For large rooms, use multiple Motion WorkPoints to ensure coverage

• Split the workspace (table area) into two equal sections and install the Motion WorkPoints on the ceiling centered in each section.



Motion WorkPoints should not be used on ceiling with a height greater than 13 ft (4m) as they may not fully capture seated workers. For spaces with very high ceiling, consider positioning Motion WorkPoints on the walls. 


Frequently Asked Questions


1. Will Motion WorkPoints detect workers walking by a desk?

If installed under a desk (at a depth of at least 1 ft (30cm) from the edge) the Motion WorkPoints vision will not reach the area in which people walk.  

2. Can Motion WorkPoints pick up workers on the other side of glass walls or windows?

No,  the majority of glass used for partition walls will not allow Motion WorkPoints to capture objects in motion on the opposite side. Other clear materials, such as polycarbonate or acrylic, may allow for partial detection of motion but the device’s sensitivity will be greatly reduced.

3. Are Motion WorkPoints dangerous to human health?

Motion WorkPoints use Bluetooth Low Energy (BLE) to communicate. The output power of CoWorkr Bluetooth Low Energy devices is so low, the FCC does not require them to be tested for Specific Absorption Rate (SAR), a measure of the rate at which energy is absorbed by the human body when exposed to RF radiation, including microwave radiation. Cellphones and laptops, on the other hand, must pass strict SAR testing requirements, since they operate at higher power levels.

4. How do I know if Motion WorkPoints are collecting data?

Motion WorkPoints are always on. As long as the battery is charged, the device will broadcast data. It may appear that a Motion WorkPoint is offline, however, if the connection to CoWorkr’s cloud (your Hub) has been disconnected or powered off.


V2 Vibration WorkPoint

Vibration WorkPoints simply need to attach to surfaces that experience vibration when in the presence of a workers. For example, a vibration WorkPoint may be adhered to the underside of a chair, single desk, or embedded within a cushion. Vibration WorkPoints are very sensitive and this must be considered when using. A single vibration WorkPoint may detect presence of multiple workers if used, for example, on the underside of a table that is used by multiple workers at a time.



V2 or V1 Temperature WorkPoint

Temperature WorkPoints are similar to motion WorkPoints, in that they require the visibility of a worker. These differ in that they must remain within 18" of the worker. Rather than "looking" for motion, these devices look for heat profiles that are described by the warmth of a human body. These are designed to be positioned on the underside of a desk, directly facing the waist or thighs of a worker. The temperature sensors have a narrow field of vision of <90°. 



1.0 Account Creation & Login

note: Section 1 of CoWorkr Support reviews the only basics of using CoWorkr’s App. For WorkPlace setup and in-depth knowledge, check out Section 2.

To get started with CoWorkr, please create an account using your email or a registered Google account.

Based on your client's location, create an account in either of the following locations:

This will take you to a CoWorkr Account Log In Page

  • Click "Register" at the very bottom to create a new account

  • Use an existing Google account or create an account using any email

  • Check your email for an account verification, click the link to verify and login to CoWorkr

  • One you've verified your email account, please contact CoWorkr,, to be assigned to a new Group.  If you work within a Partner organization,, please contact your internal Admin to be added to their team

Register with a single sign-on by clicking the red Google Register button

1.1 App Basics


When you log in, you’ll find a list of WorkPlaces to which you’re assigned or you’ve created. If you've logged in and you see nothing but menus, you'll need to contact your CoWorkr rep or your CoWorkr Admin. You'll only be able to see WorkPlaces and Devices to which you're assigned.

Your top menu will give you quick links back to this page (“WorkPlaces”), lists of your devices “WorkHubs” and “WorkPoint”, as well as your User options.  

You can find options to edit your user profile under the drop down at the top right. This includes resetting your password. 

1.2 Your WorkPlace & Floorplans

Note: If you don't see a WorkPlace when logging in, contact your administrator. You may not yet be assigned to the Workplace.

To open a WorkPlace, simply click its name in the list of available WorkPlaces from the home page. This will open your WorkPlace Dashboard which includes tabs for FloorPlans, Hubs, WorkPoints, and WorkPlace Analytics. We'll start by opening a FloorPlan.

A WorkPlace is created by a CoWorkr admin. They add floorplans, assign devices, and set up the analytics. For support document access involving the setup and maintenance of WorkPlaces, please contact or your representative.

To get started exploring a WorkPlace, try clicking on the FloorPlan icon. This will open the FloorPlan and load its default Live View.

Live View

Your FloorPlan will launch into its Live view.

Note: The Live Floor Plan uses on-the-fly calculations to determine if a seat is active. This may be slightly different than your processed data represented in your analytics. Processed data may use long-term analysis, unavailable in the short-term, to determine values.

In this view, Blue Icons represent Seats that are currently active. 

Light Blue Seats have been recently active, for example when someone has recently walked away.

White Seats have no recent activity.

Red Seats are not currently connected.

Launching the FloorPlan will load the Live View


Rewind View

The second view is called Rewind. This allows you to choose a historical date and time of the Live view.  This view will display the same color-coded icons as Live View.

Drag the time slider to adjust

Activity Map View

The third FloorPlan view is called the Activity Map. This allows you to see Activity data overlaid on your FloorPlan. Choose a date and time range in the filterThe Activity Map view uses a color gradient to show the average activity (%) per seat on your floor plan. Hover over an Icon to view its value.

Note: The Activity Map legend includes a selection for your Activity Interval. If you're unfamiliar with this, scroll down to its section below to read about how it works.

Use the Gradient legend to see the color gradation as it corresponds to percent active.

1.3 Analytics Summary

CoWorkr Analytics are a comprehensive set of tools for slicing up your WorkPlace data. Our devices collect data at a very high frequency providing you with a massive trove of data. 

Our Analytics have several metrics and features that we'll walk through in detail including:

  • Analytics Dashboards

    • Analytics Preview

    • FloorPlan Analytics

    • WorkPlace Analytics

  • Using the Analytics Dashboard

  • Features & Tools

    • Selections

    • Interval

    • Data Download

    • Elastic Scales

    • Links


  • Data Metrics

    • Activity

      • Average

      • Peak

    • Average WorkPoints Active

    • Inactive WorkPoints

    • Stays

    • Dashboards


1.3.1 Analytics Dashboards

There are several locations where you can view your workplace's data. These are outlined below:



The analytics preview provides the last week of data, Average Active WorkPoints, and Inactive Workpoints.

Make a selection using the Floor Plan

  • Make a selection using Tags

  • Click the Analytics button

This will launch the Analytics Preview. If you'd like to recalculate the metrics, you can drag over the timeline chart to narrow the focus of your time selection.

Note: Expand the window using the button at the top right of Analytics Preview to launch the full FloorPlan Dashboard.

FloorPlan Analytics:

Expanding the Analytics Preview from your FloorPlan will launch the full FloorPlans analytics.

The FloorPlan analytics displays all metrics based on your selection from the FloorPlan. This scope can be narrowed by further selecting Tags or specific date/time ranges within the Dashboard.

These processes are outlined below per feature.



The WorkPlace analytics contains all data from all floors in the workplace.  This is accessed from the WorkPlace Dashboard by clicking Analytics.

The WorkPlace Analytics will load all the data from the start of the installation. You can then make selections to further narrow the scope of your analysis.

Note: based on your WorkPlace size, this dashboard can load much more slowly than the FloorPlan Analytics. Each change to the dashboard will require the data to be reprocessed and may take several minutes. Once the new selection data is loaded once, it'll be stored and allow to be quickly loaded in the future.

The WorkPlace Analytics dashboard can be found from the WorkPlace's homepage while FloorPlan Analytics, from the FloorPlan

1.3.2 Using the Analytics Dashboard


In all of CoWorkr's analytics, the contents of the Analytics Dashboard is ultimately controlled by several features in the Top Menu such as the date/time range and an Interval option. In the examples below, we will be using the WorkPlace Analytics, found in the WorkPlace's home menu on the right.

The menu along the top of the Analytics Dashboard contains several key functions that control your data. Adjust these prior to analyzing your data and save your settings if you want to change the default. 

1. Start with the Date Range

  • If the date range loaded is not preferred, click the Date Range and select a new Date Range

note: If you'd like to exclude days from your data, for example, holidays or work off-sites, click the calendar button next to your WorkPlace name at the top of the page. This will not delete data — you can add these dates back into your dataset at any time.

 Adjust your date range

Adjust your date range

2. Select an Interval

The Interval will default to 15min. If a different interval is desired, click the Interval menu and select a new Interval. 

Note: An "Interval" is a period of time that rounds up activity into larger chunks. For example, 7 minutes of actual detected activity will be shown as 10 minutes if using a 10 minute interval. If using a 15 minute interval, it will be rounded up even further, to 15 min. 

Aug-27-2018 08-20-06.gif

3. Choose from a list of default View Filters or Save your own.

To create your own:

  • Make a section on the dashboard and choose settings

  • Click the File button above the View Filters

  • Click to save it as your default, or the WorkPlace's default

 Set a WorkPlace Analytics filter or save your existing settings

Set a WorkPlace Analytics filter or save your existing settings


Each chart will display Activity as a function of the time or location. Each chart also acts as a method of filtering. 

Horizontal Bar Charts:

  • Try selecting one of the Tags from the list on the right, this will sort the Dashboard to show only this specific Tag.

  • Try selecting more than one Tag by clicking any multiple Tags. They will aggregate your results.

  • To reset these selections, click RESET to revert to the default settings

Vertical Bar Charts

The full date range graphs at the top of the dashboard shows all data in the date range. You can select any range within this date range:

  • Click and drag a region over the graph, this will filter your dashboard to show data that only falls within this range

  • Adjust this time range by pulling the grips at either end of the selection

Charts using the WorkPlace Analytics

Aug-27-2018 08-59-09.gif

Charts Using the FloorPlan Analytics

Adjusting the charts on the FloorPlan Analytics: All of the charts act as filters for the data instantaneously. Click away or the Reset button to clear the selection.

Note:  Using the Floorplan Analytics, where data is shown based on the WorkPoints selected on your floorplan, the Analytics are responsive — meaning they'll instantaneously change with your interactions. When using the WorkPlace Analytics, which loads all floorplans and all data, making selections on the charts will require the dataset to reload.

1.3.3 Features & Tools


To view a quick preview of the analytics or even load the entire FloorPlan to view, you'll need to first make a selection.  A selection can be made my dragging over any seats you'd like to view or opening the Tag menu and selecting the relevant tag.

  • Click any number of tags to add it to your selection. Click the tag(s) again to remove it from the selection.

  • Shift+Click a seat after selecting to deselect.

After making a selection, click the red Analytics button at the bottom of the window to open a preview. Click the expand button to open the full FloorPlan Analytics dashboard.

Note: If you want to load the full WorkPlace Analytics, where you can view all FloorPlans, you can access this from the WorkPlace Dashboard on the previous page by clicking the Analytics button.

Expand the Analytics Preview to launch the full FloorPlan Analytics dashboard


The Activity Interval defines the length of time associated with each reading of Activity. Intervals may be thought of as buckets of time; if any activity is detected within the amount of time determined by the Interval, such as "5-minutes", the entire 5 minutes will be shown as active. For example, a desk may only be active for 12 minutes during an hour of the day but using an Interval of 30-minutes would mean the entire 30-minutes would be shown as active.

You'll find the Interval selection available at all options to change your data such as in the Activity Map, Analytics Preview, or full Workplace Analytics.

To change the Interval:

  • Click the Interval Drop Down menu to choose an interval

  • Select between 1 min and 30 min intervals

  • Your Analytics will then be reloaded


All of your data collected by CoWorkr can be downloaded in CSV format for integration with other applications. You'll see the download icon throughout the App marking locations where specific data sets are available for download. 

Click the Download icon to start the download, give it a name & click Download.

Download your data from any of our charts by clicking the Download icon


The Elastic Scales button, located under the tools icon, allows the maximum value on the Y-Axis to be the maximum value of the data. This may provide a higher resolution view of your data if the peak of your data is very low. 


When setting up your WorkPlace, Seats on your FloorPlan may be linked to create larger areas of space to study. Linked WorkPoints takes two seats and combines the data. For example, if a desk has two sensors because it may have multiple seating positions, the two locations can be linked together to show the data as one.

Another example is using Linked WorkPoints to create rooms or spaces using individual sensors. For example, select all seats in a conference to link them together. 

Note: When you create a new Link, it creates a new set of data that then gathers data based on the sensors you've linked. This is not retroactive. The Links need to be created before the Start Date of a Workplace to ensure all data is properly collected by the Link.

In the Analytics, to show the Linked Workpoints together, as one, click the Group Linked WorkPoints toggle button under the tools tab. To show the Linked WorkPoints separately, click the Separate Linked WorkPoints toggle button.

1.3.4 CRE Metrics


CoWorkr's primary occupancy metric is called "Activity"

Activity is generated when a human interacts with a space or seat where our sensor(s) are located. This data is collected at 1-minute intervals but is viewed on the app in 30-minute buckets. The resolution of this data can adjusted by using the Interval settings of 1, 5, 10, 15 , or 30 minute buckets. 

Average Activity: The average of all observed activity within the selected time period for a selection of seats or spaces.

Peak Activity: The highest Activity observed at a given point in time. This is often provided with a % occurrence and time of highest occurrence.


Of a selection, how many of seats remained completely vacant throughout the time range. This is defined by seats that have an average activity of less than 5%.

Furthermore, this metric defines the number of seats that fit the next rung of activity: between 5%-10% active. 


Of a selection, this is the number of seats occupied simultaneously. This is a great metric for determining how many people use a space at the same time — for example, use this to estimate the average number of workers in a room. 


The Stay Duration is the quantity of lengths of stay during the date range. For example, a stay might be 120 minutes— represented by the number of times a worker used the seat for an uninterupted 120 minutes.

2.0 App Support Topics

2.0 App Support Topics

Admin user guide for CoWorkr's App

Below you will find detailed information on administrative app features and general information like definitions and user processes. This documentation includes information that only pertains to administrative users. If you're having trouble finding your solution here, please reach out to

The topics below are listed in order of standard customer setup, start to finish.

For our general user guide, please visit


This walks through the basic setup of a WorkPlace. Some of these steps must be done in the order they appear.

NOTE: Before Installing WorkPoints & Hubs, make sure to first create a WorkPlace online. You'll want access the App and your new WorkPlace while at the site.

2.0 WorkPlace Setup

Below you will find detailed information on administrative app features and general information like definitions and user processes. This documentation includes information that only pertains to administrative users. If you're having trouble finding your solution here, please reach out to

The topics below are listed in order of standard customer setup, start to finish.

This walks through the basic setup of a WorkPlace. Some of these steps must be done in the order they appear.

Before installing sensors & Hubs, create a WorkPlace online. You'll want to access the App and your new WorkPlace while at the site.

Steps for setting up your WorkPlace

2.1. Create a Group, Add Users

2.2. Create a New WorkPlace

2.3. Assign Hubs to WorkPlace

2.4. Add FloorPlans

2.5. Add Hubs & WorkPoints to FloorPlans

2.6. Tagging & Linking WorkPoints

2.1 Create a Group

Groups are made to assign multiple Users to one or more WorkPlaces. Typically, a Group is created to represent a customer and the users supporting the customer. This allows an Admin to provide and control all Users associated with the customer from a single place. A Group may have multiple users as well as multiple WorkPlaces. A Group may be named "Customer-ABC" and contain 5 different WorkPlaces, for example —5 different WorkPlaces across the country, that belong to Customer-ABC.

Users in a group may have Normal or Admin permissions. Normal Users will only be able to view content and will not be able to edit or delete content. Admins will be able to view, edit, and delete content. For example, Normal Users will be able to see the floorplan, real-time data, and the analytics while Admin Users will be able to see, modify, and/or delete the floorplan and data.

Get Started

Create a group by accessing the Group page from the main menu. 

1. Add a New Group and give it a name and description. You'll be automatically added to the Group as an Admin. 

2. Add users to the Group. You can do this now or later. Click the number under "Members" to add new users

3. Select if the new user is an Admin, like you, or someone who will only be viewing the WorkPlace (normal).

2.2 Create a New WorkPlace

1. Open the WorkPlaces page and click "NEW WORKPLACE"

2. Fill Out the New WorkPlace Details:

  • Use the exact address & timezone as CoWorkr will use it to geo-sync sensors. 

  • Select the Group of users who'll need to access this Workplace

3.  Click Save. You'll then see your newly made WorkPlace appear in the list on your homepage.

  • To Edit or Delete your newly created WorkPlace, use the Pencil Icon in the Workplace list. 

  •  Additional Buttons in the Workplace Menu include:

    • Resetting will return your hardware to its default state, unassigned to any WorkPlace.

    • Unlinking WorkPoints will remove their assignments to the WorkPlace. Only use this to close a WorkPlace.

    • Tag Updates will update all your WorkPlace data to reflect the most recent tags added, deleted, or modified.

    • Data Download will build a complete file of your WorkPlace and make it available in the Files menu

    • Buttons here including Data Download, Tag Updates, Unlinking WorkPoints, & Resetting.

2.3 Add Hubs to Your New WorkPlace

To start streaming sensors to your FloorPlan, you'll need to first assign the relevant hubs to the WorkPlace:

Note: When moving Hubs to a new Workplace, make sure to reset them from the previous WorkPlace using the "Reset" button on the Hub list.

Get Started



Caution: Turning on a Hub that has an active SIM card will connect it to our servers. However, unless your Hub is assigned to your WorkPlace and detecting Sensors, it may not be visible to you.

To activate and test your Hub's connection, take the following steps:

• Ensure peripherals including SIM card and USB antennas are plugged into the Hub
• Use only 1 network connection (Don't plug in LAN while also using a 3G modem)
• Power on the Hub
• Have a Sensor operating nearby



From the WorkHubs Page ( or you'll find a list of Hubs available for use. This list will include all hubs that you or your colleagues have used or recently added. If you have a Hub but are unsure of its name, you may sort by any of the Hub details to determine its identity. 

If you've just connected a Hub and need to locate it try these steps:

1. Use the Filter drop-down menu to select and only show Connected Hubs

2. Sort the List of Connected Hubs by App Start

3. The most recently started Hub is likely your Hub. If you're still unsure, you can verify the number of sensors detected under the "WorkPoints" column.



On the right side of your Hub list there are several options may be used to edit the Hub:

Click the Pencil icon to change the Hub's assigned WorkPlace.

Additional details on the Hub list include:

Hub Name: This may be changed yet the Hub's unique ID such as "B827EB1C088D" is the recommended naming convention.
WorkPlace: The WorkPlace to which the Hub is currently assigned
FloorPlan: The WorkPlace's specific Floor Plan name
WorkPoints: This displays the most recently unassigned/assigned WorkPoints available through this Hub
Network: The Network name and type currently used by the Hub
APN: Access Point Name defined by the Hub's network
Platform: Hub Hardware Device
Version: Firmware Version loaded on Hub
Connected: Network Connection Status
(Lock): Encryption Status
Uptime: Length of time the Hub remained most recently connected
Last Load: Date or time of the last connection made



If you'd like to create a label for your Hub, try printing a QR code from the Hub's ID

Click the QR icon next to your Hub ID and print

2.4 Add FloorPlans to your New Workplace

A FloorPlan image will be the background on which you place sensors. You'll want this to be a clean image showing basic floor plan elements such as windows, walls, furniture, and more.

Get Started

1. Start by opening your New WorkPlace


3. This will launch a file picker 

  • You can use any image filetype such as JPG, PNG, TIFF, or SVG to be your floor plan.

We recommend PNG or JPG no smaller than 1800 px wide and resolution no less than 72 ppi. We also recommend cleaning up your floor plan as best as possible to make a clear and concise virtual workplace. 

  • Remove any irrelevant text or any content that identifies individual persons

4. Click Save. Your newly added FloorPlan will appear in your WorkPlace's list of FloorPlans. You can open it by clicking the FloorPlan Icon.

Note: After uploading your FloorPlan, you can replace the image at any point by clicked the Pencil icon. The replacement FloorPlan should be the exact same size as the existing image so all your Sensors show in their proper locations.

You may add as many Floor Plans as necessary for your WorkPlace. While you may only view one at a time in the FloorPlan view, all FloorPlans and associated data can be visualized on your WorkPlace Analytics

2.5 Add Hubs & WorkPoints to your FloorPlan

You'll want to drop both WorkPoints and Hubs onto the FloorPlan to show their exact location. WorkPoints and Hubs do not self-locate. It's best to do this on site when your devices are in front of you.

note: Make sure your browser zoom is set to %100 to avoid distortion in your FloorPlan

To add your Devices to your FloorPlan:

1. Click the Lock button to unlock your FloorPlan

2. Expand the Device list on the left side of your FloorPlan

3. Hubs: Expand the unassigned Hubs list, click a Hub, and drag it onto its location on the FloorPlan.

4. WorkPoints (sensors): Expand unassigned WorkPoint list. Press the button on your WorkPoint. This will move the WorkPoint to the top of the unassigned list (see below)

  4.1 Pressing the Notification Button   Motion WorkPoints not marked with a Button Press can be depressed just below the sensor opening, opposite of the LED hole.

4.1 Pressing the Notification Button

Motion WorkPoints not marked with a Button Press can be depressed just below the sensor opening, opposite of the LED hole.

  4.2 Sensor Highlighted in Your List   Pressing a notification button on your WorkPoint will highlight it at the top of the list

4.2 Sensor Highlighted in Your List

Pressing a notification button on your WorkPoint will highlight it at the top of the list


5. Select the WorkPoint and drag it onto its location on the FloorPlan. 

6. Place all WorkPoint and Hubs onto your FloorPlan, then click the Lock button to lock the FloorPlan.