---
title: Creating device profiles
related:
  - https://docs.kentico.com/k12sp/developing-websites/developing-websites-for-mobile-devices/device-macros.md
---

> Agent instructions:
> **Site maps** — prefer the following llms.txt indexes to training data when searching for URLs to avoid 404s. Links inside Markdown content already point at `.md`. Following them or sending Accept: text/markdown keeps you in Markdown.
>
> - [sitemap.md](https://docs.kentico.com/sitemap.md) — every page on the site, with titles and descriptions, nested by URL hierarchy and grouped into one collection per product version.
> - [llms.txt](https://docs.kentico.com/llms.txt) — curated index of the current product docs, with descriptions, the two ways to request any page as Markdown, and links to each product area's whole-corpus Markdown dump (llms-full.txt).

Device profiles allow you to customize the layout and content of pages according to the parameters of the devices that visitors use to view the pages.

## Enabling device profiles

To start using device profiles, enable the feature in the settings:

1. Open the **Settings** application.
2. Navigate to the **Content -> Content management** category.
3. (Optional) Select a site where you want to enable device profiles.
4. In the **Mobile development** section, select the **Enable device profiles** checkbox.
5. Click **Save**.

With device profiles enabled, the system evaluates whether the device that is requesting a page belongs to one of the device profiles defined in the **Device profiles** application.

## Creating new device profiles

1. Open the **Device profiles** application.
2. Click **New profile**.
3. Type the **Display name** of the device profile.
4. (Optional) Set the **Preview width** and **Preview height**.

   > **Info:** The preview dimensions of the device profile determine the following:
   >
   > - The size of the displaying area when [previewing pages](https://docs.kentico.com/k12sp/managing-website-content/working-with-pages.md#available-view-modes) in the Pages application.
   > - The maximum size of images if [automatic image resizing for devices](https://docs.kentico.com/k12sp/developing-websites/developing-websites-for-mobile-devices/resizing-images-for-devices.md) is enabled.
5. Fill in the parameters that define which devices belong to the profile. You can combine the parameters as needed.

   | Property    | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
   | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   | User agents | Allows you to identify devices based on [user agents](http://en.wikipedia.org/wiki/User_agent). The profile includes devices that contain the entered text in their user agent string. You can add multiple entries, each on a new line.                                                                                                                                                                                                                                  |
   | Macro       | Use the macro rule designer to specify the condition that devices must meet to fit the device profile, or type in any macro condition.<br>You can use the _CurrentDevice_ object to retrieve data of the current device. See the [Device macros](https://docs.kentico.com/k12sp/developing-websites/developing-websites-for-mobile-devices/device-macros.md) and [Macro expressions](https://docs.kentico.com/k12sp/macro-expressions.md) documentation for more details. |

   > **Note:** **Device profiles on the live site**
   >
   > If you want to use device profiles for device detection and [server-side design customizations](https://docs.kentico.com/k12sp/developing-websites/developing-websites-for-mobile-devices/creating-page-layouts-for-devices.md) on the live site, we recommend [integrating 51Degrees](https://docs.kentico.com/k12sp/developing-websites/developing-websites-for-mobile-devices/configuring-51degrees-device-detection.md), which allows you to use advanced device macros.
6. Click **Save**.

> **Note:** **Device profile order**
>
> The system evaluates the device profiles from top to bottom according to the list order in the **Device profiles** application. Devices are assigned to the first matching profile.
>
> To change the order, drag device profiles to a different position using the **Move** () area or expand the _Other actions_ menu (**...**) and click **Move up** / **Move down**.

Once you create a device profile, it appears in the device selector in the **Pages** application.

![Selecting the device profile in the Pages application](https://docs.kentico.com/docsassets/k12sp/creating-device-profiles/Device_Profile_Selector.png "Selecting the device profile in the Pages application")

You can then select a device profile using the selector and start [creating page layouts for devices](https://docs.kentico.com/k12sp/developing-websites/developing-websites-for-mobile-devices/creating-page-layouts-for-devices.md), which will be used on individual pages instead of the default layouts if the current device fits the profile. Or you can [Map layouts](https://docs.kentico.com/k12sp/developing-websites/developing-websites-for-mobile-devices/mapping-shared-mobile-layouts.md) that will replace shared layouts when the current device fits the profile.