Skip to content

pacx webresources setEnvImage

github-actions[bot] edited this page Jul 22, 2025 · 3 revisions

Sets the image that will be shown in the top left corner of the title bar. This setting applies for all MDAs of a given environment.

Aliases

pacx webresources setLogo
pacx webresources setOrgImage
pacx wr setEnvImage
pacx wr setLogo
pacx wr setOrgImage

Usage

The aim of the current command is to streamline the process of setting the logo that is shown in the of the title bar of each model driven app that is present in a given environment. If you want to change the logo manually, you need to leverage the old theming capability, accessible via the legacy settings UI under Customizations > Themes. You need to:

  1. Create a new theme (from scratch or by cloning an existing default theme) --> this is required because you cannot apply a logo on one of the default themes.
  2. Set the logo on the new theme. --> The logo image should be a webresource already present in the environment.
  3. Apply the new theme to the environment by publishing it.

This command will do all these steps for you, in a single command, performing also a few consistency checks. It will:

  1. Check whether the current environment contains a webresource whose name is passed in the --name argument.
  2. If present, checks if it's of the right type.
  3. Retrieves the current default legacy theme for the environment.
  4. If the theme is a default theme, or the --cloneTheme argument is explicitly passed, creates a copy of the theme using the same name with suffix - Copy.
  5. Sets the logo on the theme (the found or the cloned one).
  6. Publishes the theme.

You can then hit F5 in your environment to see the applied logo.

Please note: The old theming capability is not available in the new Power Platform Environment Settings App. To create modern themes you can leverage _n.ModernThemeBuilder XrmToolbox plugin, or do it manually. However, modern themes does not provides any capability to change the logo, thus leveraging this PACX command is, right now, the quickest viable option to achieve this goal.

Usage examples

pacx webresources setEnvImage -n new_Logo.png
pacx webresources setEnvImage -n new_Logo.png -c
pacx wr setLogo -n new_Logo.png
pacx wr setLogo -n new_Logo.png -c

Arguments

Long Name Short Name Required? Description Default value Valid values
name n Y The unique name of the web resource to set as the organization image. Must be a .png, .jpg or .gif image up to 200x50px. - String
cloneTheme c N If true, the theme will be cloned and the new image will be set as the organization image. False true, false

Command list

Clone this wiki locally