# Changing settings

Source: https://cumulocity.com/docs/standard-tenant/changing-settings/
Sector: Platform administration
Release: Latest

From the **Settings** menu, administrators can manage various settings for the account:

- Change the [application settings](https://cumulocity.com/docs/standard-tenant/changing-settings/#application).
- Manage the [properties library](https://cumulocity.com/docs/standard-tenant/changing-settings/#properties-library).
- Provide [SMS provider credentials](https://cumulocity.com/docs/standard-tenant/changing-settings/#sms-provider).
- Manage the [connectivity settings](https://cumulocity.com/docs/standard-tenant/changing-settings/#connectivity).
- Change the [localization settings](https://cumulocity.com/docs/standard-tenant/changing-settings/#localization).


## Application

Click **Application** in the **Settings** menu to change applications settings.

![Application settings](https://cumulocity.com/docs/images/users-guide/Administration/admin-settings-application.png)

### To change application settings {#to-change-application-settings}

Under **Default application**, you can select a default application from the list which will apply to all users within the tenant. Whenever the platform is accessed, for example, by domain name only, without mentioning a specific application, the application selected as default application is used as default landing page.


> **Info:**
> All users must have access to this application.



Under **Access control**, administrators can enable cross-origin resource sharing or "CORS" on the Cumulocity API.

The **Allowed Domain** setting will enable your JavaScript web applications to directly communicate with REST APIs.

* Set it to "*" to allow communication from any host.
* Set it to `http://my.host.com`, `http://myother.host.com` to allow applications from `http://my.host.com` and from `http://myother.host.com` to communicate with the platform.

For further information, see [http://enable-cors.org](http://enable-cors.org).


> **Related topics:**
> - [Platform administration > Standard tenant administration > Managing applications](https://cumulocity.com/docs/standard-tenant/ecosystem/#managing-applications) for general information on managing applications.
> - [Platform administration > Standard tenant administration > Managing users](https://cumulocity.com/docs/standard-tenant/managing-users/) for general information on managing users.

## Properties library

> **Requirements:**
> ROLES & PERMISSIONS:
>
> Custom properties are visible to all authenticated users of the tenant, regardless of their inventory role permission.



Click **Properties library** in the **Settings** menu, to add custom properties to inventory objects, alarms, events and tenants.

![Properties library](https://cumulocity.com/docs/images/users-guide/Administration/admin-settings-properties-library.png)

With custom properties, you can extend the data model of Cumulocity built-in objects. You may create the following custom values:

- Custom inventory properties are used to extend the inventory data model. They can be used in the [Asset table widget](https://cumulocity.com/docs/cockpit/widgets-collection/#asset-table) and [Asset properties widget](https://cumulocity.com/docs/cockpit/widgets-collection/#asset-properties).
- Custom tenant properties are available during tenant creation. The custom properties can be edited under **Subtenants** in the **Custom properties** tab of each tenant. Additionally, these properties can be viewed and exported in the **Usage statistics**.
- Custom alarm and event properties can be used as custom fields which can be added to your reports and will be available in the **Export** page in the Cockpit application.


> **Related topics:**
> - [Application enablement & solutions > Cockpit > Widgets collection](https://cumulocity.com/docs/cockpit/widgets-collection) for further information on the usage of properties in the "Asset table" and "Asset properties" widgets.
> - [Application enablement & solutions > Cockpit > Managing exports](https://cumulocity.com/docs/cockpit/exports/#managing-exports) for further information on the usage of properties in reports and exports.
> - [Platform administration > Enterprise tenant administration > Managing tenants > To create a subtenant](https://cumulocity.com/docs/enterprise-tenant/managing-tenants/#to-create-a-subtenant) for further information on custom tenant properties.




### To add a custom property {#to-add-a-custom-property}

1. Select the tab for the desired property and click **Add property**.

2. In the resulting dialog box, provide a unique name as identifier and a label for the property and select its data type from the dropdown list.

3. Additionally, select validation rules for the new property:

<table>
<colgroup>
<col width="20%">
<col width="80%">
</colgroup>
<thead>
<tr>
<th style="text-align:left">Checkbox</th>
<th style="text-align:left">Description</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left">Required</td>
<td style="text-align:left">If selected, the property must be provided, for example, during alarm creation. Not available if the property type is "boolean".</td>
</tr>
<tr>
<td style="text-align:left">Default Value</td>
<td style="text-align:left">Provide a default value to be automatically filled in the custom property field. Only available for properties with type "string".</td>
</tr>
<tr>
<td style="text-align:left">Minimum</td>
<td style="text-align:left">Enter a minimum integer value.</td>
</tr>
<tr>
<td style="text-align:left">Maximum</td>
<td style="text-align:left">Enter a maximum integer value.</td>
</tr>
<tr>
<td style="text-align:left">Minimum length</td>
<td style="text-align:left">Enter the minimum length required for the string.</td>
</tr>
<tr>
<td style="text-align:left">Maximum length</td>
<td style="text-align:left">Enter the maximum length required for the string.</td>
</tr>
<tr>
<td style="text-align:left">Regular expression</td>
<td style="text-align:left">Add a regular expression which will be required in order to fill the custom property field.</td>
</tr>
</tbody>
</table>

4. Click **Save** to create the new property.

### To edit a custom property {#to-edit-a-custom-property}

1. Click on the name of a property in the list to open it.
2. Do your edits. For details on the fields see [To add a custom property](https://cumulocity.com/docs/standard-tenant/changing-settings/#to-add-a-custom-property).
3. Click **Save** to save your settings.


### To remove a custom property {#to-remove-a-custom-property}

1. Click on the name of a property in the list to open it.
2. Click **Remove** to delete the property.

## SMS provider

> **Requirements:**
> ROLES & PERMISSIONS:
>
> To view SMS provider configurations: READ permission for the permission type "SMS"
> To set or remove SMS provider configurations: ADMIN permission for the permission type "SMS"



SMS are used throughout the platform for various features like [two-factor authentication](https://cumulocity.com/docs/authentication/tfa) and user notifications, for example, on alarms.

By providing your credentials you enable platform features that utilize SMS services.

### To enter SMS provider credentials {#to-enter-sms-provider-credentials}

1. Click **SMS provider** in the **Settings** menu.

2. In the **SMS provider** page, select one of the available SMS providers from the **SMS provider** dropdown field. You can start typing to filter items and more easily find your preferred provider.

3. In the resulting dialog, enter the required credentials and properties or specify optional settings, which differ depending on the provider you selected.

4. Click **Save** to save your settings.


> **Info:**
> OpenIT does not serve new customers anymore and is in the process of shutting down their SMS provider business. We therefore recommend you to select one of the other SMS providers.

## Connectivity

In the **Connectivity** page, you can manage credentials for different providers. In order to add or replace credentials ADMIN permissions are required.


> **Requirements:**
> ROLES & PERMISSIONS:
>
> The **Connectivity** menu item is only available if you are logged in to the Cumulocity platform as administrator and if you have READ or ADMIN permission for the permission type "Connectivity".
>
> To view connectivity settings: READ permission for the permission type "Connectivity"
> To set or remove connectivity provider configurations: ADMIN permission for the permission type "Connectivity"



The following provider settings may currently be specified:

- [Actility LoRa](https://cumulocity.com/docs/device-integration/lpwan/#actility-lora)
- [Sigfox](https://cumulocity.com/docs/device-integration/lpwan/#sigfox)
- [SIM](https://cumulocity.com/docs/device-management-application/connectivity)

### To provide or replace credentials {#to-provide-or-replace-credentials}

1. Switch to the tab of your desired provider.
2. Enter the URL of the provider.
3. Enter the credentials of your provider platform. Depending on the provider, these credentials will be either the credentials of your account in the provider platform or the credentials with which you can register in the Cumulocity connectivity page, will be displayed in your account in the provider platform.
4. Finally, click **Save** to save your settings.

Depending on the provider you have selected, there may be additional fields, which will be explained in the respective agent documentation, see [Device integration](https://cumulocity.com/docs/device-integration/).

## Localization

Using the **Localization** functionality you can add custom translations for existing static text in the UI.


> **Requirements:**
> - To view the **Localization** page: READ permission for permission type "Application management"
>
> - To add/update/delete localization identifiers: ADMIN permission for permission type "Application management"
>
> - Your user must have a role with READ permission for "Application management". See [Managing permissions and roles](https://cumulocity.com/docs/standard-tenant/managing-permissions/) for more information.



Click **Localization** in the **Settings** menu in the navigator to open the translation editor.

![Main view localization page](https://cumulocity.com/docs/images/users-guide/Administration/admin-localization-main-page.png)

### To add new identifier for translations {#to-add-new-keys-for-translations}

1. Click **Add translation** on the top menu bar.
2. In the resulting dialog box, add a name for the new translation key.
3. Optionally, add translations in the respective fields.
4. Click **Add** to close the the translation editor.
5. Click **Save & apply** in the top menu bar to save the new translation identifier and apply it to the UI.

![localization-add-term](https://cumulocity.com/docs/images/users-guide/Administration/admin-localization-add-term.png)

### To add and edit translations {#to-add-and-edit-translations}

You can add or edit translations for every identifier in two ways:

1. Hover over the respective column to display the edit icon <i class="dlt-c8y-icon-edit1 text-primary icon-20"></i>.
2. Click the edit icon next to the field you want to edit.
3. Add or edit the translation.
4. Click the green checkmark to save the translation.
5. Click **Save & apply** to apply the changes.

Or:

1. Click the edit icon <i class="dlt-c8y-icon-edit1 text-primary icon-20"></i> in any row to open the translation editor for the respective identifier.
2. Add or edit the translations.
3. Click **Add** to close the translation editor.
4. Click **Save & apply** to apply the changes.

To view the added or modified translations in the UI, change the language from the user menu, see [To change user settings](https://cumulocity.com/docs/get-familiar-with-the-ui/user-settings/#to-change-user-settings).

## Feature toggles

The **Feature toggles** functionality enables or disables specific preview features in the UI.
This provides early access to new features before they are generally available.

Moreover, you can temporarily disable a feature that is generally available when you experience an issue with it.

Your feedback on these features is very valuable to us. Please submit your thoughts via the support portal.


> **Requirements:**
> - To view the **Feature toggles** page: No specific permissions.
>
> - To update the state of a feature toggle: ADMIN permission for the permission type "Tenant management".



Click **Feature toggles** in the **Settings** menu in the navigator to open the **Feature toggles** page.

The **Feature toggles** page displays the following columns:

- **Name**: The display name of the feature. Optional.
- **Description**: A brief explanation of what the feature does. Optional.
- **Key**: The unique identifier for the feature toggle.
- **Phase**: The current phase of the feature, either "Generally available" or "Public Preview".
- **Status**: The current state of the feature toggle, either "Enabled" or "Disabled". The state of a feature toggle depends on the phase of the feature. Before a feature is generally available, it is disabled by default. You must opt in to enable it. When a feature is generally available, it is enabled by default. You must opt out to disable it.
- **Strategy**: Indicates if the state of a feature toggle has been customized. Once you customize a feature toggle, it no longer changes its state according to the phase. To return to the default behavior, click the reset button in the customized row. 



### To toggle a feature {#to-toggle-a-feature}

1. Identify the row of the feature toggle that you want to change in the list.
2. Click the toggle switch in the **Status** column to change the state of the feature toggle.

### To manage features of subtenants {#to-manage-features-of-subtenants}

Users on the Management tenant can also manage the feature toggles of subtenants on the environment.
Management tenant see an additional **Feature toggles** tab in the detail view of a subtenant.
This functionality is not available on Enterprise tenants.