---
title: Creating device profiles
related:
  - https://docs.kentico.com/k9/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. Before you start using device profiles, you need to [enable mobile development](https://docs.kentico.com/k9/developing-websites/developing-websites-for-mobile-devices/configuring-mobile-development.md) in the settings.

To create a new device profile:

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

   | Property    | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
   | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   | Devices     | Select devices directly from a list.                                                                                                                                                                                                                                                                                                                                                                                                                            |
   | 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 [Device macros](https://docs.kentico.com/k9/developing-websites/developing-websites-for-mobile-devices/device-macros.md) and [Macro expressions](https://docs.kentico.com/k9/macro-expressions.md) documentation for more details. |
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/k9/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/k9/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/k9/developing-websites/developing-websites-for-mobile-devices/mapping-shared-mobile-layouts.md) that will replace shared layouts when the current device fits the profile.