> This page is for Portal. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.emnify.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.emnify.com/_mcp/server. > Learn how to manage your devices via the Connected Devices page in the emnify Portal [**Connected Devices**](https://portal.emnify.com/connected-devices) is where you manage your devices. ## View your devices The **Connected Devices** page displays a list of all your devices. You can tailor the table to your specific workflow using **Table settings**. ![Connected Devices table with the Table settings icon at the right end of the header row](/_fern-img/5bdb0d4f059b734f1f5869577ec1f5512786aa8f1315b4b3480e2d567c6f1e8e.webp) This new approach replaces the previous **Plain** and **Extensive** views, giving you a single, flexible interface to manage your devices more effectively. For more information, see [Customize tables in the emnify Portal](/portal/how-tos/customize-tables). ### Available columns | Property | Description | Predefined options *if applicable* | | ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | | Device Name | Name of the device and the tags you've assigned to the device. | | | Tags | Name of the tags you've assigned to the device. | | | Status | Current state of the device. | * **Enabled** * **Disabled** * **Factory Test** * **No SIM** | | Connectivity Status | Current [connectivity status](https://www.emnify.com/iot-glossary#connectivity-status) of the device. | - **Online** (cellular only) - **Online** (satellite capable) - **Attached** - **Offline** - **Blocked** - **N/A** | | Network | Name of the mobile network operator (MNO) the device is currently connected to (if applicable). | | | Cellular usage | Total amount of terrestrial cellular network data usage in **MB** or **no usage**. | | | Satellite usage | Total amount of satellite non-terrestrial network usage in **Messages**, **no usage**, or **can't connect**. *Note: This column only shows if you have satellite capable SIMs.* | | | ICCID | [Integrated circuit card identifier](https://www.emnify.com/iot-glossary#iccid) including the final [Luhn checksum digit](https://www.emnify.com/iot-glossary#luhn-checksum-digit). The ICCID also identifies eSIM profiles. | | | EID | [eUICC identifier](https://www.emnify.com/iot-glossary#eid) that is unique for every eUICC. | | | eSIM profile status | Status of the eSIM profile on the device. | * **Available** * **Allocated** * **Linked** * **Ready to download** * **Ready to install** * **Installed (Inactive)** | | Service Policy | Name of the service policy assigned to the device. | | | Coverage Policy | Name of the coverage policy assigned to the device. | | | IMEI | 15-digit IMEI including the final [check digit](https://www.emnify.com/iot-glossary#check-digit). | | | Device ID | Unique identifier for the device. | | | IP address | Unique address that identifies the device on the internet or a local network (for example, `10.1.1.9`). | | | SIM ID | Unique identifier for the attached SIM card. | | | MSISDN | [Mobile Station International Subscriber Directory Number](https://www.emnify.com/iot-glossary#msisdn), used to identify a mobile phone number internationally. | | > **Note** > > For each device, click anywhere on the table row to open the device details. ### Quick actions When you hover over a device, buttons appear to trigger quick actions. ![Device row with quick action icons and a menu listing Disable IMEI lock, Extend limit, Release SIM, and Delete](/_fern-img/041c00f4d114f05860962a00086dc09aa645e684b8e9c4d87d46f06466ff4a44.webp) The following actions are available: | Action | Description | | :----------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Reset connectivity | [Reset the device's connectivity](#reset-connectivity). This action is commonly used for troubleshooting. | | Enable device | Change the [device status](#device-status) to **Enabled** if the device is currently **Disabled** or in **Factory Test**. | | Disable device | Change the [device status](#device-status) to **Disabled** if the device is currently **Enabled**. | | Open SMS console | Open an interface to send SMS from the Portal to the device. | | Enable IMEI lock | Strictly associate the assigned SIM with its [International Mobile Equipment Identity (IMEI)](https://www.emnify.com/iot-glossary#imei) if [IMEI lock](/services/security#imei-lock) is currently disabled. Resets the device's connectivity. | | Disable IMEI lock | Clears the IMEI lock if it's currently enabled. Resets the device's connectivity. | | Extend limit | [Increase the device's data limit](/portal/how-tos/extend-data-limit) for the rest of the month. | | Release SIM | Release the assigned SIM. For more information on the potential affects, see [How SIM status and device status interact](/portal/troubleshooting#how-sim-status-and-device-status-interact) *Note: If there's no assigned SIM, this action isn't visible.* | | Delete | Permanently removes the device from **Connected Devices**. | ## Create a new device As part of the SIM registration process, you can [create a new device](/quickstart/create-device) for the newly registered SIM while still in the SIM registration dialog. To create a new device to be used with an unattached SIM, navigate to **Connected Devices** and select **Add device**. After providing a name for the new device and selecting device policies, you can select a SIM from the list of registered, unassigned SIMs or filter for a specific SIM under **Assign SIM (optional)**. ## Get your device online For information about configuring a device for network connectivity, see [Configure the APN](/apn-configuration). ## Filter devices Filters allow you to query devices based on one or more properties (for example, assigned tags or the device ID). For more information and available filters, see [Filter tables in the emnify Portal](/portal/how-tos/filter-tables). ## Search devices The **Connected Devices** search bar is under the page title next to the filters. For more information and searchable fields, see [Search tables in the emnify Portal](/portal/how-tos/search-tables). ## Tag devices Tags help you organize and filter devices in **Connected Devices**. They can be added when creating a new device, from the device details page, or through bulk actions in the device list. ### Naming conventions * **Minimum length**: 2 characters * **Maximum length**: 150 characters * **Allowed characters**: Uppercase and lowercase English letters, digits, and the following: `- _ . +` * Names cannot begin with a space (leading whitespace is trimmed) * Maximum of **30 tags per device** ### Tag behavior **Scope**: Tags are Workspace-level resources, not personal settings. A tag's name and color are shared by every device the tag is assigned to, and all users in the Workspace see the same values. When someone edits a tag's name or color, the change applies for everyone. **Hierarchy and display**: On the **Connected Devices** table and device details page, tags are displayed alphabetically (A-Z), case insensitive. When managing tags, all tags in your Workspace appear in the dropdown list. By default, tags in this list are sorted by usage frequency in descending order unless manually reordered. If two tags have the same usage count, they are sorted alphabetically (A-Z), case insensitive. **Search**: If your Workspace has more than 15 tags, a search bar appears with suggestions for existing tags. When searching, tags used by the selected devices always appear at the top of the results. **Error handling**: You're notified if limits are reached (for example: maximum tags in Workspace, duplicate names, disallowed characters, or too many tags per device). If a device has reached the maximum tag limit, checkboxes in the popover are disabled. **Click filtering**: Clicking on a tag in the device table triggers a filter and updates the view to show only devices that use that tag. **Advanced filtering**: The tag filter popover includes an **Exact match** toggle: * When switched on, only devices with all selected tags are shown. * When switched off, devices with any of the selected tags are shown. ### Where tags are available Tags can be added, removed, or managed in multiple areas of the Portal: * **Connected Devices**:\ From the device list (via bulk actions) or when creating a new device. * **Device Details**:\ Clicking any tag or the **Add tag** option opens the tag management popover. * **SIM Inventory**:\ When assigning a device to a SIM. ### Tag deletion logic * **Unused tags** (not applied to any device) can be deleted immediately. * **In-use tags** (applied to one or more devices) require confirmation in a modal before deletion. ## Get device information To view all information about a device, navigate to **Connected Devices**, find it in the list, and click anywhere on the table row to open the device details. It opens to the **General** tab by default. Depending on the device, your permissions, and enabled features, you may also see the **Events**, **Stats**, **Location**, **Diagnostics** (see [Flow Logs](#flow-logs)), and **Quota** tabs. **General** shows the following properties: | Property | Description | | :------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Status | Current state of the device (in this document, see [Device status](#device-status)). | | Services | Indicates whether the following services are active or disabled: - Data - SMS MT - SMS MO | | Connectivity Status | [Connectivity status](https://www.emnify.com/iot-glossary#connectivity-status) and available PDP context, with an option to reset the connectivity. If the device is **Online**, click the `i` icon to show all connectivity information—breakout IP, MSC, VLR, etc. | | Blocked networks | Names of any operators on the device's networks blocklist (often used for troubleshooting). | | Device | Identifiers for the device, including: - Device ID (referred to as `endpoint_id` when working with the [REST API](/developers/api/endpoint)) - Configured IP address - Toggle to indicate whether IMEI lock is turned on - 15-digit IMEI including the final check digit - 16-digit IMEISV | | Policies | Names of the assigned [service policy](/portal/device-policies#service-policies) and [coverage policy](/portal/device-policies#coverage-policies). | | SIM | Properties of the assigned SIM, including: - IMSI - MSISDN - ICCID Also includes an option to release the SIM. If there's no assigned SIM, this section is empty and shows an option to assign a SIM. | | Usage | Data and SMS traffic based on a selected time period: - Last hour - Current month - Last month | > **Tip** > > For definitions of any unfamiliar terms or acronyms, see the [IoT glossary](https://www.emnify.com/iot-glossary). ## Flow Logs Beta \[#flow-logs] **Flow Logs** provide visibility into how your devices communicate over the network, including the destinations they connect to, the protocols and ports used, and the amount of data transferred. Use Flow Logs to validate expected communication patterns, investigate unexpected traffic, and troubleshoot connectivity or application issues. Flow Logs are in the device's details view under the **Diagnostics** tab. Logs appear automatically once the device starts sending or receiving data. Until then, the tab shows a **No Flow Logs available** message instead of the table. You may need to change the **Started On** filter to see older Flow Logs. Detailed Flow Logs are retained for up to 30 days. By default, the table is sorted by **Started On**, with the newest flows first. The Flow Logs table has the following columns: | Column | Description | | :------------------- | :---------------------------------------------------------------------------- | | Started On | When the flow started. | | Completed On | When the flow ended or was last updated. | | Destination Hostname | Resolved hostname associated with the destination IP address, when available. | | Destination IP | IP address of the destination the device connected to. | | Destination Port | Port on the destination the device connected to. | | Protocol | Network protocol used for the flow (for example, TCP or UDP). | | Bytes Up | Data sent by the device. | | Bytes Down | Data received by the device. | Flow Logs are grouped by destination using the combination of **Destination Hostname**, **Destination IP**, **Destination Port**, and **Protocol**. Therefore, the same hostname may appear in multiple rows if it was reached via different IPs, ports, or protocols. > **Note** > > Click anywhere on a row to open its [Flow Log details](#flow-log-details). ### Flow Log details Each Flow Log summarizes the communication between a device and a destination and provides additional details about the underlying flow events. Open a row to see: * **Additional details**: destination hostname source, destination IPs, protocol, NAT public IPs, and the networks, country, and operator (PDP context) the device used. * **Total bytes up** and **Total bytes down** for the flow, with a chart of bytes transferred over time. * **Flow events**: a table of the individual flow events that make up the Flow Log, including details such as the source IP and port, session ID, duration, and release reason. ### Filter Flow Logs Use the filter controls to narrow results by time range, destination, and protocol. For more information and the available filters, see [Filter tables in the emnify Portal](/portal/how-tos/filter-tables#flow-logs). ### Export Flow Logs Each view provides a CSV export, and any applied filters are reflected in the exported file. * From the **Flow Logs** table, select **Download CSV** to export the first 100 flow events captured for the device. * From a row's [Flow Log details](#flow-log-details), select **Download CSV** to export the first 1,000 flow events for that destination. To reload the table with the latest flows, select **Refresh**. > **Tip** > > For guidance on interpreting Flow Logs while troubleshooting, see [Flow Logs](/portal/troubleshooting#flow-logs). ## Device status | State | Description | | :----------- | :------------------------------------------------------------------------------------------------- | | Enabled | A SIM is assigned to the device and activated. The device must be enabled to connect to a network. | | Disabled | No SIM assigned, or the assigned SIM is suspended. | | Factory Test | The assigned SIM is in factory test mode (FTM). | | Deleted | Permanently removed from your **Connected Devices**. | ### Configure the device status A device has only two configurable states, **Enabled** or **Disabled**. You can toggle one or more devices between these states to control their data usage. To change the status of a single device, use [quick actions](#quick-actions). For multiple devices, use the [enable or disable devices bulk action](#enable-or-disable-devices). > **Warning** > > If you're using the [emnify REST API](/developers/api) to configure devices, it's possible to have a **Disabled** endpoint with an **Activated** assigned SIM. > In this case, you continue to accrue costs as emnify charges for activated SIMs. > Be sure to suspend the assigned SIM to avoid unexpected charges. > > Reference: [Endpoint Object](/developers/reference/endpoint) and [Endpoint API](/developers/api/endpoint) ## Reset connectivity You can reset a device's connectivity by selecting its **Reset connectivity** icon while viewing it in the list of **Connected Devices** or in [device details](#get-device-information): **General** tab > **Status** column > **Connectivity Status** > **Reset Connectivity**. #### Show where this happens in the Portal ![Reset connectivity icon in a device row, next to the disable and SMS console icons](/_fern-img/ec1eeb92026b0b6a47df3249736688b8afc297a541e7b5dc1b82f2dd3b35184c.webp) ![Reset connectivity link in the Connection section of the device General tab](/_fern-img/a170ed84c5112381537fcdcb2da060827ec30ef4888e768064b8efee7b1c0dae.webp) ## Bulk actions You can also perform bulk actions on a group of devices. ### Enable or disable devices Use a filter to display a list of the targeted devices. Once their checkboxes indicate that they have been selected, the bulk actions menu bar appears at the top of the screen. Select **Device** and then one of the actions: * **Enable Devices** * **Disable Devices** ### Assign EIDs to eSIM profiles To assign EIDs to many eSIM profiles at once from a CSV file, see [Assign EIDs to eSIM profiles](/portal/how-tos/consumer-esim/assign-eids#assign-eids-in-bulk). ### Rename devices To rename multiple devices, see [Rename devices in bulk](/portal/how-tos/rename-devices-in-bulk). ### Release SIMs To release SIMs from multiple devices, see [Release SIMs from devices in bulk](/portal/how-tos/release-sims#multiple-devices-in-bulk). ### Delete devices and SIMs On **Connected Devices**, you can delete devices and, optionally, their associated SIMs using the bulk action menu. This feature helps keep your inventory organized and to ensure that unused SIMs don't generate unnecessary signaling or costs. When you select devices for deletion, a dialog prompts you to confirm whether you want to delete both the device and its SIM, delete only the device (leaving the SIM in your **SIM Inventory**), or cancel the operation. If you choose to delete the SIM, you permanently remove it from your account—this stops all signaling from the SIM and makes it unusable for any future network access. ### Add or remove tags Bulk tag management lets you add or remove tags from multiple devices at once. This feature helps keep your deployment organized and reduces unused or outdated tagging structures. The option to remove tags is only visible if at least one selected device already has tags. Additional considerations when removing tags: * Only tags currently applied to the selected devices are displayed in the removal dialog. * By default, no tags are preselected—you must manually select the tags to remove. * After confirmation, the selected tags are removed from all chosen devices. * If a tag is removed from its last associated device, it becomes an unused tag and can then be deleted without confirmation. For step-by-step instructions, see [Manage device tags](/portal/how-tos/manage-tags).