> For the complete documentation index, see [llms.txt](https://kb.mago.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kb.mago.io/mago-stage/admin-portal/manage-policies.md).

# Manage policies

Policies provide reusable settings that can be applied consistently across displays and assignments.

A policy can control appearance, display behavior, or digital signage settings. The policy types and available settings depend on the deployment configuration.

### Create a policy

1. In the Administration Portal, select **Policies**.
2. Select **New**.
3. Enter a descriptive name for the policy.
4. Select the policy type.
5. Select **Create**.
6. Configure the available settings.
7. Select **Save**.

Use a name that clearly identifies the policy’s purpose, such as:

* Boardroom Branding
* Reception Signage
* Portrait Displays
* Training Rooms
* Default Appearance

### Appearance policies

Appearance policies can include settings such as:

* Logo
* Background image
* Display orientation
* Light or dark theme
* Extending the receiver across connected displays on supported devices

{% hint style="info" %}
**Extend across connected displays** requires compatible Windows hardware and a license that permits more than one wired display per receiver.&#x20;

Under the current license editions, this option applies only to Basic. Basic is available on Windows only and supports up to three wired displays connected to the same receiver.
{% endhint %}

{% hint style="info" %}
A policy assigned directly to a display overrides the corresponding setting inherited from a display-based or tag-based assignment.&#x20;

When an orientation setting is supplied by the effective policy, it overrides the receiver’s detected or locally configured orientation.
{% endhint %}

Branding image uploads support the following formats:

* PNG
* JPG
* WebP
* GIF

The available settings can vary by platform and deployment configuration.

<figure><img src="https://2978719120-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M2FbpP2hYI1Myy7hMs_%2Fuploads%2Fxg8BhCpMKAnelmCZdr1I%2Fimage.png?alt=media&amp;token=fdb1c663-0a77-4ce7-9a21-ed8ab8d251ca" alt=""><figcaption></figcaption></figure>

### Digital Signage policies

Digital Signage policies can include settings such as:

* Signage playlist
* Idle behavior
* QR code visibility
* QR code placement
* Other signage presentation settings

Create and manage playlist content from the **Digital Signage** area before selecting it in a policy.

For instructions, see **Manage Digital Signage playlists**.

### Edit a policy

1. Select **Policies**.
2. Select the required policy.
3. Change the required settings.
4. Select **Save**.

Changes to a reusable policy can affect every display and assignment using that policy.

{% hint style="warning" %}
Test significant policy changes on a limited number of displays before applying them more widely.
{% endhint %}

### Rename a policy

1. Select the policy.
2. Open the policy actions menu.
3. Select **Rename**.
4. Enter the new name.
5. Select **Save**.

Renaming a policy does not remove it from its existing displays or assignments.

### Remove a policy from a display or assignment

To stop applying a policy to one display or assignment, remove the policy from that target.

Removing a policy from a target does not delete the reusable policy. It remains available for other displays and assignments.

For instructions, see:

* **Assign policies to a display**
* **Display-based assignments**
* **Tag-based assignments**

### Delete a policy

1. Select **Policies**.
2. Select the required policy.
3. Open the policy actions menu.
4. Select **Delete**.
5. Confirm the deletion.

{% hint style="danger" %}
Deleting a reusable policy removes it permanently and can affect every display and assignment using it. Remove the policy from an individual target instead when it should remain available elsewhere.
{% endhint %}
