JumpCloud® Asset Management enables tracking, management, and optimization of your organization’s IT assets throughout their entire lifecycle. Asset Management seamlessly integrates with JumpCloud Device Management to track new and existing JumpCloud-managed devices. You can also create assets manually, as well as import them in bulk via CSV. This article shows you how to enable and configure Asset Management.
Review Get Started: Asset Management for a feature overview and FAQ: Asset Management to explore commonly asked questions.
Prerequisites:
- JumpCloud Device Management must be enabled in your org and on devices to automatically sync managed devices into Asset Management. See MDM in JumpCloud to learn more.
Considerations:
- Asset Management is a premium feature and requires the Platform Prime package. See JumpCloud Pricing to learn more.
- Devices, Accessories, and Locations are all classified as assets in JumpCloud Asset Management.
- Managed Devices refer to devices that meet the following criteria:
- macOS, Linux, and Windows devices with the JumpCloud Agent installed.
- iOS and iPadOS devices enrolled in Apple MDM.
- Android devices enrolled in Android EMM.
Enabling Asset Management
To start using JumpCloud Asset Management, enable it in the Admin Portal:
- Log in to the JumpCloud Admin Portal.
- Go to DEVICE MANAGEMENT > Asset Management > Settings.
- Toggle on Asset Management Enabled.
After enabling Asset Management, existing JumpCloud-managed devices are added automatically. See FAQ: Asset Management to learn more.
Configuring General Settings
Default Currency
Set the default currency while creating and editing assets. If your org uses multiple currencies, this will not convert between them.
Import Assets
Use a CSV file to add or update assets in bulk. Use this for devices not enrolled in JumpCloud management. peripherals without management capability, or for locations. Your last 5 CSV imports are listed here, or click See All for full import history. Jump to Importing Assets to learn more.
Configuring Field Settings
Use fields to label, organize, and track specific information about your assets, like status, service tags, and service dates. You can modify the defaults or create custom fields. Fields are organized by asset class: Global, Devices, Accessories, and Locations.
To edit a field:
- In Field Settings, go to the appropriate asset class subtab (Global, Devices, Accessories, or Locations).
- Fields are separated into categories. The categories and fields displayed differ depending on the asset class subtab you selected. Asset Details exists for all asset class subtabs.
- Click any existing field in the list to modify it. For this example, select Devices > Asset Details > Type.
- Under Types, you can customize from the existing list, or create a new one by clicking Add Device Type.
Some fields prevent you from modifying or removing certain details. For example, Status is automatically mapped to managed devices and cannot be removed. Jump to Device Asset Information to learn more.
Creating Custom Fields, Labels, and Tags
You can also create custom fields to use as labels or tags to better organize your assets. For example, you can create a custom field like "VM Environment" and label your virtual machines depending on their host environment, like Parallels or Virtual Box.
To create a custom field:
- In Field Settings, go to the appropriate asset class subtab (Global, Devices, Accessories, or Locations).
- For this example, select Devices.
- Under Asset Details, click Add Field.
- Enter a Label for the new field. This label appears as the column name in the asset table.
- (Optional) Enter a Tooltip to explain the label's use case.
- (Optional) Under Field Type, select the type of data associated with this field. The default is Text.
- Click Create.
The new custom field now appears in the details of every individual asset that matches this asset class. For example, all device assets will show this field under their Asset Details.
Default Status Fields for Managed Devices
By default, managed devices have four device activity statuses: active, inactive, not available, and deleted. You can choose how to map these statuses to fields in Asset Management, enabling more granular control and reporting.
To change the default status mapping:
- In Field Settings, go to the Devices subtab.
- In the list, click Status.
- Under Status, scroll down to Status Mapping.
- Optionally select a field to map to each status:
- Active defaults to Active.
- Inactive defaults to Inactive.
- Not Available defaults to Not Available.
- Deleted defaults to Retired.
The following additional device statuses are available by default:
- Ordered
- Delivered
- Ready
- In Use
- Repair
- Maintenance
- Lost
- Retired
Sync Owner with Primary User
You can automatically sync the owner in Asset Management with the Primary User set in the Device object. See Users Tab - Primary User to learn more.
Enabling this setting prevents you from modifying the owner of synced device assets.
To sync owner with the primary user:
- In Field Settings, go to the Devices subtab.
- In the list, click Owner.
- Under Sync with Primary User, select Use the device’s Primary User as the Asset Owner.
Managing Assets
Devices, peripherals, and locations are all categorized as assets. Depending on the source and amount of data, you can import assets or create them manually.
Device assets synced with JumpCloud Device Management update automatically and they cannot be deleted. However, you can modify their type, status, location, and owner.
Adding Assets Manually
In addition to bulk CSV import, you can also create individual assets. Use this when adding a new peripheral, location, or device not managed by JumpCloud.
To manually add an asset:
- In Asset Management, go to the appropriate tab of the asset to add. For example, go to the Devices tab to create a device.
- In the top left, click Add Asset.
- Under Asset Details, fill the following required fields:
- Name
- Status
- Enter the remaining fields depending on the asset type.
- Under Purchase Details, enter information such as asset Purchase Date, Cost, and Warranty Period.
- Under Hardware Specifications, enter information such as the OS Family and Version, Model, Vendor, and CPU.
- (Optional) Select Create another to create a duplicate asset.
- Click Add.
Importing Assets
Use the import feature when adding assets in bulk or when migrating from another platform.
Ensure your CSV file follows the template and the values match expected formats to ensure successful upload and analysis.
To import assets:
- Go to DEVICE MANAGEMENT > Asset Management > General Settings.
- In the General Settings tab under Import Assets, click Download Template and select from the appropriate template:
- Devices Template
- Accessories Template
- Locations Template
- Download All
- On your device, edit the CSV file and add asset information. You can export this from your existing asset management solution, or add it manually.
- After editing and filling the template, click Import CSV.
- Any missing information from the template results in a partial upload to Asset Management and missing columns will be filled as empty.
- Under Import Assets, select the asset type: Devices, Accessories, or Locations.
- Click Upload CSV and select the file from your device.
- The system processes your file. This can take 2-5 minutes.
If analysis fails, you’re prompted with a warning to reanalyze the file. You may need to modify the CSV file and ensure it aligns with the template.
- After successful analysis, click Import.
- In the list of recent imports you can view the import status. If successful, assets are added to the appropriate area.
When formatting the CSV template, the columns (which correspond to fields in Asset Management) must be formatted with the appropriate value type for successful import. See the following table for all supported value types.
Asset Management CSV Value Types
Value Type | Example |
---|---|
TEXT, TEXT_AREA |
Any plain text (for example lorem ipsum) |
INTEGER |
Whole numbers between -2,147,483,648 and 2,147,483,647 (for example 100) |
FLOAT |
Decimal numbers between -1.7976931348623157e+308 and 1.7976931348623157e+308 (for example 100.555) |
BOOLEAN |
|
DATE |
Must follow the format YYYY-MM-DD (for example 2006-01-02) |
DATETIME |
Must follow the ISO format YYYY-MM-DDTHH:MM:SSZ±HH:MM (for example 2006-01-02T15:04:05Z07:00) |
USER |
A valid user’s display name or ID in your organization (for example John Doe or 686cf22e8d9bd8000example) |
USER_GROUP | A valid user group name or ID in your organization (e.g., Engineers or 686cf22e8d9bd800012a8b7a) |
DEVICE_GROUP |
A valid device group name or ID in your organization (for example Mobile Devices or 686cf22e8d9bd8000example) |
LOCATION |
A valid location asset name or ID in your organization (for example Ankara or 686cf22e8d9bd8000example) |
SELECT_* fields (such as SELECT_DEVICE_TYPE, SELECT_ACCESSORY_STATUS, etc.) |
Use any valid option name or ID configured in your organization (for example In Use or 686cf22e8d9bd8000example) |
Using Asset History
Asset Management tracks all changes to your assets. These events provide you with a complete history and an audit trail to help you stay compliant.
To access asset history:
- In Asset Management, go to the appropriate tab of the asset.
- Find the asset in the list.
- In the Overview tab, you can view the Recent History.
- For more details, go to the History tab.
Asset Management Event Types
Events are separated into generic and critical events. Most events expire after one year, but owner, status, and location changes are logged indefinitely.
Event | Description | Priority |
---|---|---|
Asset Created | A new asset is added. | Generic |
Asset Deleted | An asset is removed. | Generic |
Asset Updated | Non-critical asset updates (for example purchase or cost information). | Generic |
Note Added | An admin manually adds a note to an asset. | Generic |
Owner Changed | An asset’s owner is updated. These are tracked indefinitely. | Critical |
Status Changed | An asset’s status is changed. These are tracked indefinitely. | Critical |
Location Changed | An asset is moved to a different location. These are tracked indefinitely. | Critical |
Agent Version Changed | JumpCloud Agent version updated. | Critical |
MDM Satus Changed | Device’s MDM enrollment status changes. | Critical |
MFA Status Changed | Device’s MFA enforcement changes. | Critical |
Actions Menu
Use the Actions menu to quickly modify or delete one or multiple assets.
To access the Actions menu:
- In Asset Management, go to the appropriate asset tab (for example, Devices).
- Find the asset in the list, or select multiple assets for bulk actions.
- To perform an action on a single asset: In the Actions column, click the three dots (...) to open the menu.
- To perform an action on multiple assets: In the top right, click Actions.
- To perform an action on a single asset: In the Actions column, click the three dots (...) to open the menu.
From the Actions menu, select from the following options: Change Status, Location, Type, or Owner.
If you selected a modification option (for example, Change Status), a change modal appears. Select the options from the dropdown, then click Save.
Deleting Assets
Deleting assets permanently removes all associated data.
To delete assets:
- To delete a single asset: In the Actions column, click the three dots (...), then select Delete Asset.
- To delete multiple assets: In the top right, click Actions, then select Delete Asset.
In the Delete Asset modal, enter the number of assets to delete. Click Delete Asset to confirm.
Devices Tab
Use the Devices tab to quickly view and manage all of your devices. JumpCloud-managed devices appear automatically, as well as any devices you’ve added manually or imported via CSV. Click on any asset in the list to view its details. The following information displays:
- Recent History: Shows a log of all changes to this device. Click See All History to view the entire list.
- Actions Menu: Lets you edit the asset, go to the associated Device, launch Remote Assist, or Delete the asset.
- Device Information: See the following table.
Device Asset Information
Section Name | Field Name | Description | Device Management Sync |
---|---|---|---|
Device Management | JumpCloud Agent Installed | Includes agent version, last sync date, and MFA status |
|
JumpCloud MDM | MDM enrollment status |
|
|
Asset Details | ID | A unique value assigned to the asset |
|
Created Time | When the asset was created |
|
|
Last Updated Time | When the asset was last updated |
|
|
Name | The asset name |
|
|
Tag | Service tag value |
|
|
Serial Number | Device serial number |
|
|
Type | Device type |
|
|
Status | Device status |
|
|
Location | Asset location assigned to the device |
|
|
Owner | Device owner (primary user) |
|
|
Date Deployed | Date device deployed to production |
|
|
Ownership Type | Company or personal device |
|
|
Purchase Details | Purchase Date | Date asset was purchased |
|
Purchase Cost | Cost of the asset |
|
|
PO Number | Applicable PO for invoicing |
|
|
Warranty Period | Length of manufacturer warranty |
|
|
Warranty Expiry Date | Date manufacturer warranty expires |
|
|
Supplier | Vendor asset purchased from |
|
|
Hardware Specifications | OS Family | Darwin (macOS), Linux, Windows |
|
Operating System (OS) | Specific OS |
|
|
OS Version | Version of OS |
|
|
Model | Device model |
|
|
Vendor | Manufacturer |
|
|
RAM | Amount of RAM |
|
|
CPU | CPU type and architecture |
|
|
Disk Encrypted | Enabled or disabled |
|
|
IMEI | IMEI for mobile devices |
|
|
Battery Health | Current capacity compared to max capacity |
|
Accessories Tab
View, manually add, and manage all of your IT accessories. These can include large peripherals like monitors, projectors, and printers, or small peripherals like keyboards, mice, cables, and headphones.
Click on any accessory in the list to view its details. The following information displays:
- Asset Details: Includes information about the peripheral including Type, Status, Location, and Model.
- Purchase Details: Information like the Cost, Date, PO Number, and Supplier.
Locations Tab
Create and track equipment locations like main and satellite offices. You can associate all of your assets with locations to help manage inventory levels. Jump to Adding Assets Manually to create a location.
Click on any location in the list to view its details. The following information displays:
- Asset Details: Name*, Tag, Description, Parent, Manager, Phone, Address, City, Stage, Country*, Postal Code.
- * indicates a required field.
- Recent History: Shows a log of recent changes to this location. Click See All History to view the entire list.
Disabling Asset Management
When you disable Asset Management, all data is deleted from JumpCloud and is unrecoverable. Managed devices remain.
To disable Asset Management:
- Log in to the JumpCloud Admin Portal.
- Go to DEVICE MANAGEMENT > Asset Management > Settings.
- Toggle off Asset Management Enabled.