# Add Cloud Branding

*Applies to: Patch My PC Cloud*

Adding branding to your Patch My PC (PMPC) Cloud company involves:

* [Creating a Branding app](#creating-a-branding-app)
* [Assigning the Branding app to the relevant audience](#assigning-the-branding-app-to-the-relevant-audience)
* [Deploying the Branding app](#deploying-the-branding-app)

### Creating a Branding app

To add a new branding app to your Patch My PC (PMPC) Cloud company:

1. Navigate to **Settings | Branding**

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FpgUUhPDS8LaJ3Avl3Fqb%2Fimage.png?alt=media&#x26;token=e86322b9-36a6-4dd2-b7b6-5ae87add7a64" alt="Navigating to ‘Settings | Branding’" width="563"><figcaption></figcaption></figure>

2. Click **Add Branding**

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FB5uzwA5cxg3o9TsApHiq%2Fimage.png?alt=media&#x26;token=1db0fae9-cef4-419d-a127-0550474ef91f" alt="Clicking ‘Add Branding’" width="563"><figcaption></figcaption></figure>

3. If you want to continue with the default **Classic** branding, go to Step 5.
4. If you want to create modern branding, **click Modern (PSASDT)**

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FqReQnDpcQsB3yJ4GxvSG%2Fimage.png?alt=media&#x26;token=75abc60f-595b-40bd-a164-67fd811774c9" alt="Clicking ‘Modern(PSASDT)’" width="563"><figcaption></figcaption></figure>

{% hint style="danger" %}
**Important**

When you select **Modern (PSADT)**, you will see the **Are you sure you want to switch branding types** prompt.

![‘Are you sure you want to switch branding type’ prompt](https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FZr0WCq3cZtHWYGvkERGZ%2Funknown.png?alt=media\&token=3f1cda5a-df70-420d-b4e8-0a892239ac3f)

Click **Confirm** to continue.

You will also see the warning message that .NET Framework 4.7.2 or later is required on any devices on which a Modern branding app is targeted to.

![](https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FCMy3N4HjM0mBKftmYnx2%2Funknown.png?alt=media\&token=2e641723-8af9-4009-b32d-01be9c5f48a4)&#x20;
{% endhint %}

{% hint style="info" %}
**Note**

The process for creating a branding app is the same regardless of the **Branding Type**. The differences are with the configuration settings for each branding app, which are detailed in [Default Language Notifications in Cloud](https://docs.patchmypc.com/patch-my-pc-cloud/manage/manage-settings/manage-cloud-branding/default-language-notifications-in-cloud).
{% endhint %}

5. In the **Branding Intune App Name** field, type a name for the branding app that will be created in Intune, containing your branding. For example, use the **Branding** prefix followed by the name of the Entra ID group this branding app will be deployed to.

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2F59GOU4wuda0Vg0UTQmjp%2Fimage.png?alt=media&#x26;token=0e485571-f765-4f83-b908-23235ded1c93" alt="Entering the name for the Branding app" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
**Note**

The **Notification Preview** does not update as you change the text in the various fields.
{% endhint %}

6. In the **Company Name** field, if required, set the name of the company you want to appear on the branding notification when it is displayed on the assigned devices for this branding app. By default, this is the same as the the **Company Name** configured under **Settings | Company | General**.

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2F7U4oFC5bxg3exeogfP8m%2Fimage.png?alt=media&#x26;token=f82b2a46-718e-4b59-aa6f-bd0b46591fff" alt="Entering your company name" width="563"><figcaption></figcaption></figure>

7. Click **Upload Logo** to upload the logo for your branding that meets the requirements detailed on the **Branding** screen.

{% hint style="info" %}
**Note**

The logo you are uploading must be less than 50 MB.
{% endhint %}

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FsSaNS0ccnVsid3sXcrha%2Fimage.png?alt=media&#x26;token=d07ab18e-0b93-4f67-af0b-b2e896f641c2" alt="Clicking ‘Upload Logo’" width="563"><figcaption></figcaption></figure>

The selected image is shown on the **Branding** screen and the **Notification Preview** updates to show what the notification will look like when shown on the assigned devices.

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FACBihLUWEKp6JhGrqMDT%2Fimage.png?alt=media&#x26;token=0e63ed90-64f9-4e0d-a7ef-5bee005a2c1e" alt="Notification Preview" width="563"><figcaption></figcaption></figure>

8. Adjust the logo until you are happy.
9. In the **Localizations** section, click the language you want to use to display this branding app on the relevant devices (**English** is selected by default).

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FG0rbp1SGiO3BV9t8YuBb%2Fimage.png?alt=media&#x26;token=f8ce4a83-4326-48c2-a1e0-265b751ba8cb" alt="‘Localizations’ section" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
**Note**

Please note the following:

* Changing the localization does not update the **Notification Preview** to that language.
* If a device targeted for this branding app is running a language that is configured under the **Localizations** section, the Manage Conflicting Processes notification will be displayed in the configured language.\
  \
  However, if the device’s language is different from that set in the branding app, the default language configured in the branding app will be used to display the notification (the default being **English** unless you change it).
* You can only have one localization defined as the default per branding app.
* As ScriptRunner only supports two-letter language codes such as **EN**, **FR**, DE, etc. If the branding app contains a localization for French and the user's device has a system language of **fr-FR**, the user will receive notifications in French. However, if the user's device has the system language **fr-CI** (French in the Ivory Coast), the user will receive notifications in the default language. This is a limitation of ScriptRunner, not PMPC Cloud.
  {% endhint %}

10. If you need to add a localization for this branding, click **Add Language** and follow the [Add a Localization](https://docs.patchmypc.com/patch-my-pc-cloud/manage/manage-settings/manage-localizations#add-a-localization) section of [Managing Localizations](https://docs.patchmypc.com/patch-my-pc-cloud/manage/manage-settings/manage-cloud-branding/manage-localizations).

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FqpGRkVnigeiK8IHHlmnX%2Fimage.png?alt=media&#x26;token=d03e4e83-676f-413b-9483-3f48e7a10114" alt="Clicking ‘Add Language’" width="563"><figcaption></figcaption></figure>

Now, you need to decide who to assign this branding app to.

### Assigning the Branding app to the relevant audience

To assign a branding app:

1. Click the **Assignments** tab.

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FywgKWIT92k6cmww5DWFH%2Fimage.png?alt=media&#x26;token=936cf3d4-1a23-4369-b297-c120c6d8513a" alt="Clicking the ‘Assignments’ tab." width="563"><figcaption></figcaption></figure>

2. Click **Add Assignment**

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FaCiDwHvVLdwyfTEzlXeG%2Fimage.png?alt=media&#x26;token=71971a8c-5e0d-487f-b728-fabe41f6ec9e" alt="Clicking ‘Add Assignment’" width="563"><figcaption></figcaption></figure>

3. On the **Add Required Assignment** screen, choose the relevant users/Entra ID security groups to target for this branding app, then click **Save**.

{% hint style="danger" %}
**Important**

Avoid overlapping assignments between Branding Apps. Deploying multiple Branding Apps to the same groups will produce unwanted behavior.

You should also check that if an Uninstall Branding App exists (it will appear at the top of the list of Branding Apps), that the assignments for it don't overlap with those for the new Branding App you are deploying.
{% endhint %}

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FKkYWQF1myh7iAJaRnpiE%2Fimage.png?alt=media&#x26;token=6feac935-d32e-4fb0-a2d8-95e8e8b4ea98" alt="Choosing the relevant Entra ID security groups to target for this branding app on the &#x27;Add Required Assignment&#x27; screen, then clicking &#x27;Save&#x27;" width="452"><figcaption></figcaption></figure>

The **Assignments** tab is redisplayed, showing all of the assignments for this branding app.

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FUqxhKDnWvbN86QK75GGQ%2Fimage.png?alt=media&#x26;token=0085b81c-1f9a-453a-b0a0-a8e05c829f92" alt="‘Assignments’ tab is redisplayed." width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
**Note**

When a branding app is deployed, it overwrites any existing branding app with the same name.

If you deploy multiple branding apps with overlapping assignments, when ScriptRunner executes, it will choose the branding app with the most recent creation/modification date.

For example, branding app A was deployed two months ago, and branding app B was deployed two weeks ago. In this case, branding app B will display the banner.
{% endhint %}

### Deploying the Branding app

Once you have configured the branding app and added the required assignments, click **Save** to save and deploy the branding.

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FHhSuxgFYequgBLXJJdJd%2Fimage.png?alt=media&#x26;token=d0366fec-a317-483d-bb46-9ceff816f293" alt="Clicking ‘Save’" width="563"><figcaption></figcaption></figure>

The **Success – Branding created** notification is displayed, and the Status of the branding app is shown as **In Progress**.

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FvJ5ZOVKSiANzG5CXL2bR%2Fimage.png?alt=media&#x26;token=8b6a296e-a995-47e6-872d-57f5c0aefb04" alt="&#x27;Success – Branding created&#x27; notification and the &#x27;Status&#x27; of the branding app is shown as &#x27;In Progress&#x27;" width="563"><figcaption></figcaption></figure>

Once the branding app has been successfully deployed, the **Status** field will automatically update to **Success** and the **Last Updated** field will show the last time this branding app was updated.

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FA4XiZGSQ1E2nuEEcTKh6%2Fimage.png?alt=media&#x26;token=a740b1b9-055e-4120-9843-c21e143b3009" alt="‘Status’ showing as ‘Success’ and the ‘Last Updated’ value is updated." width="563"><figcaption></figcaption></figure>

{% hint style="success" %}
**Tip**

If you look in the **Events** section, you see a message stating either:

* **Default Branding <*****your\_branding\_app\_name*****> Created -** If you used the default out-the-box logo
* **Custom Branding <*****your\_branding\_app\_name*****> Created -** If you upload a custom logo.
  {% endhint %}

If you look in the Intune admin center, you will see the branding app listed along with your other apps.

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FYHHFKzLRgJL1nctZXIlY%2Fimage.png?alt=media&#x26;token=28391996-70ef-4e26-b475-2752cfd9feef" alt="Branding app listed with all of your other apps" width="563"><figcaption></figcaption></figure>

When ScriptRunner runs on your devices, it checks to see if the device has the branding. If it doesn't, ScriptRunner installs it.

Also, if a new branding app includes a device that already has branding deployed to it, the branding on the device will be updated to the new branding app.
