---
title: "Register Things"
slug: "register-things-widget"
updated: 2026-04-17T07:34:58Z
published: 2026-04-17T07:34:58Z
canonical: "learn.servitly.com/register-things-widget"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://learn.servitly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Register Things

Manage the inventory of the things which can be activated by end-users.

![Register Things](https://components-manager.servitly.com/components/RegisterThings_1/IMAGES/_screenshot?owner=AG_Servitly)

Note that, this widget is visible and only by users having the *REGISTER_THING* [permission](/docs/user-permissions).

Registration of things can be done in multiple mode, providing in a CSV file, or single by providing the data of the thing to be registered.

### Multiple Registration

You can register multiple things by providing a CSV file with the following format.

```excel
serialNumber,name,gpsPosition,properties.<property_name>,mapping.path,mapping.assetId,productModelName,productModelPartName,parentThingSerialNumber,parentThingName
        SerialNumber1,Name1,1.12345,2.12345,Prop1,Path1,AssetId1,Model1,ModelPart1,ParentThingSerialNumber1,ParentThingName1
        SerialNumber2,Name2,10.12345,11.12345,Prop2,Path2,AssetId2,Model2,ModelPart2,ParentThingSerialNumber2,ParentThingName2
    
```

Note that:

- If an object is already registered with the same `serialNumber`, its properties will be updated with the contents of the CSV.
- The header `properties.&lt;property_name&gt;` is just a placeholder, you can add as many columns as the number of properties you want to fill during registration.
- In case you need to register [composite things](/docs/composite-thing-management), you can fill the `parentThingSerialNumber` or `parentThingName`, whose value must be defined in a previous row of the CSV.

## Template Syntax

Below you can find some examples of how to use the component within a template.

```xml

            <div class="d-flex flex-wrap components-row">
            <register-things-widget-v2 [title]="'Register new machines'"></register-things-widget-v2>
            </div>
        
```

## Component Reference

Here is a comprehensive list of all the elements and properties that can be used to configure the component.

#### Register Things `&lt;register-things-widget-v2&gt;`

| *Title* | The title displayed on the top part of the widget box. **Name**: title **Type**: STRING \| Optional `[title]="'Register Things'"` |
| --- | --- |
| **Rendering** |
| *Availability* | Configure availability based on active features on Digital Plan on Add-ons **Name**: hasFeature **Type**: FEATURE (multiple) \| Optional `[hasFeature]="['feature_a', 'feature_b']"` |
| *CSS Class* | The name(s) of the CSS class used to customize the widget layout. **Name**: class **Type**: STRING \| Optional `class="my-custom-class"` |
| *Visibility Condition* | The expression that allows you to reduce the visibility of the element. **Name**: *ngIf **Type**: STRING \| Optional `*ngIf="getUser().organizationId != null"` |

## Full Syntax Example

```xml

<register-things-widget-v2    
    [title]="'Register Things'"
    class="my-custom-class"
    *ngIf="getUser().organizationId != null"
    hasFeature="['feature_a', 'feature_b']">
</register-things-widget-v2>
```