branding_localizations

Creates, updates, deletes, gets or lists a branding_localizations resource.

Overview

Name	branding_localizations
Type	Resource
Id	entra_id.organization.branding_localizations

Fields

The following fields are returned by SELECT queries:

get

Retrieved navigation property

Name	Datatype	Description
id	string	The unique identifier for an entity. Read-only.
backgroundColor	string	Color that appears in place of the background image in low-bandwidth connections. We recommend that you use the primary color of your banner logo or your organization color. Specify this in hexadecimal format, for example, white is #FFFFFF.
backgroundImage	string (base64url)	Image that appears as the background of the sign-in page. The allowed types are PNG or JPEG not smaller than 300 KB and not larger than 1920 × 1080 pixels. A smaller image reduces bandwidth requirements and make the page load faster.
backgroundImageRelativeUrl	string	A relative URL for the backgroundImage property that is combined with a CDN base URL from the cdnList to provide the version served by a CDN. Read-only.
bannerLogo	string (base64url)	A banner version of your company logo that appears on the sign-in page. The allowed types are PNG or JPEG not larger than 36 × 245 pixels. We recommend using a transparent image with no padding around the logo.
bannerLogoRelativeUrl	string	A relative URL for the bannerLogo property that is combined with a CDN base URL from the cdnList to provide the read-only version served by a CDN. Read-only.
cdnList	array	A list of base URLs for all available CDN providers that are serving the assets of the current resource. Several CDN providers are used at the same time for high availability of read requests. Read-only.
contentCustomization		Represents the content options to be customized throughout the authentication flow for a tenant. NOTE: Supported by Microsoft Entra External ID in external tenants only.
customAccountResetCredentialsUrl	string	A custom URL for resetting account credentials. This URL must be in ASCII format or non-ASCII characters must be URL encoded, and not exceed 128 characters.
customCSS	string (base64url)	CSS styling that appears on the sign-in page. The allowed format is .css format only and not larger than 25 KB.
customCSSRelativeUrl	string	A relative URL for the customCSS property that is combined with a CDN base URL from the cdnList to provide the version served by a CDN. Read-only.
customCannotAccessYourAccountText	string	A string to replace the default 'Can't access your account?' self-service password reset (SSPR) hyperlink text on the sign-in page. This text must be in Unicode format and not exceed 256 characters.
customCannotAccessYourAccountUrl	string	A custom URL to replace the default URL of the self-service password reset (SSPR) 'Can't access your account?' hyperlink on the sign-in page. This URL must be in ASCII format or non-ASCII characters must be URL encoded, and not exceed 128 characters. DO NOT USE. Use customAccountResetCredentialsUrl instead.
customForgotMyPasswordText	string	A string to replace the default 'Forgot my password' hyperlink text on the sign-in form. This text must be in Unicode format and not exceed 256 characters.
customPrivacyAndCookiesText	string	A string to replace the default 'Privacy and Cookies' hyperlink text in the footer. This text must be in Unicode format and not exceed 256 characters.
customPrivacyAndCookiesUrl	string	A custom URL to replace the default URL of the 'Privacy and Cookies' hyperlink in the footer. This URL must be in ASCII format or non-ASCII characters must be URL encoded, and not exceed 128 characters.
customResetItNowText	string	A string to replace the default 'reset it now' hyperlink text on the sign-in form. This text must be in Unicode format and not exceed 256 characters. DO NOT USE: Customization of the 'reset it now' hyperlink text is currently not supported.
customTermsOfUseText	string	A string to replace the the default 'Terms of Use' hyperlink text in the footer. This text must be in Unicode format and not exceed 256 characters.
customTermsOfUseUrl	string	A custom URL to replace the default URL of the 'Terms of Use' hyperlink in the footer. This URL must be in ASCII format or non-ASCII characters must be URL encoded, and not exceed 128characters.
favicon	string (base64url)	A custom icon (favicon) to replace a default Microsoft product favicon on a Microsoft Entra tenant.
faviconRelativeUrl	string	A relative url for the favicon above that is combined with a CDN base URL from the cdnList to provide the version served by a CDN. Read-only.
headerBackgroundColor	string	The RGB color to apply to customize the color of the header.
headerLogo	string (base64url)	A company logo that appears in the header of the sign-in page. The allowed types are PNG or JPEG not larger than 36 × 245 pixels. We recommend using a transparent image with no padding around the logo.
headerLogoRelativeUrl	string	A relative URL for the headerLogo property that is combined with a CDN base URL from the cdnList to provide the read-only version served by a CDN. Read-only.
loginPageLayoutConfiguration		Represents the layout configuration to be displayed on the login page for a tenant.
loginPageTextVisibilitySettings		Represents the various texts that can be hidden on the login page for a tenant.
signInPageText	string	Text that appears at the bottom of the sign-in box. Use this to communicate additional information, such as the phone number to your help desk or a legal statement. This text must be in Unicode format and not exceed 1024 characters.
squareLogo	string (base64url)	A square version of your company logo that appears in Windows 10 out-of-box experiences (OOBE) and when Windows Autopilot is enabled for deployment. Allowed types are PNG or JPEG not larger than 240 x 240 pixels and not more than 10 KB in size. We recommend using a transparent image with no padding around the logo.
squareLogoDark	string (base64url)	A square dark version of your company logo that appears in Windows 10 out-of-box experiences (OOBE) and when Windows Autopilot is enabled for deployment. Allowed types are PNG or JPEG not larger than 240 x 240 pixels and not more than 10 KB in size. We recommend using a transparent image with no padding around the logo.
squareLogoDarkRelativeUrl	string	A relative URL for the squareLogoDark property that is combined with a CDN base URL from the cdnList to provide the version served by a CDN. Read-only.
squareLogoRelativeUrl	string	A relative URL for the squareLogo property that is combined with a CDN base URL from the cdnList to provide the version served by a CDN. Read-only.
usernameHintText	string	A string that shows as the hint in the username textbox on the sign-in screen. This text must be a Unicode, without links or code, and can't exceed 64 characters.

list

Retrieved collection

Name	Datatype	Description
id	string	The unique identifier for an entity. Read-only.
backgroundColor	string	Color that appears in place of the background image in low-bandwidth connections. We recommend that you use the primary color of your banner logo or your organization color. Specify this in hexadecimal format, for example, white is #FFFFFF.
backgroundImage	string (base64url)	Image that appears as the background of the sign-in page. The allowed types are PNG or JPEG not smaller than 300 KB and not larger than 1920 × 1080 pixels. A smaller image reduces bandwidth requirements and make the page load faster.
backgroundImageRelativeUrl	string	A relative URL for the backgroundImage property that is combined with a CDN base URL from the cdnList to provide the version served by a CDN. Read-only.
bannerLogo	string (base64url)	A banner version of your company logo that appears on the sign-in page. The allowed types are PNG or JPEG not larger than 36 × 245 pixels. We recommend using a transparent image with no padding around the logo.
bannerLogoRelativeUrl	string	A relative URL for the bannerLogo property that is combined with a CDN base URL from the cdnList to provide the read-only version served by a CDN. Read-only.
cdnList	array	A list of base URLs for all available CDN providers that are serving the assets of the current resource. Several CDN providers are used at the same time for high availability of read requests. Read-only.
contentCustomization		Represents the content options to be customized throughout the authentication flow for a tenant. NOTE: Supported by Microsoft Entra External ID in external tenants only.
customAccountResetCredentialsUrl	string	A custom URL for resetting account credentials. This URL must be in ASCII format or non-ASCII characters must be URL encoded, and not exceed 128 characters.
customCSS	string (base64url)	CSS styling that appears on the sign-in page. The allowed format is .css format only and not larger than 25 KB.
customCSSRelativeUrl	string	A relative URL for the customCSS property that is combined with a CDN base URL from the cdnList to provide the version served by a CDN. Read-only.
customCannotAccessYourAccountText	string	A string to replace the default 'Can't access your account?' self-service password reset (SSPR) hyperlink text on the sign-in page. This text must be in Unicode format and not exceed 256 characters.
customCannotAccessYourAccountUrl	string	A custom URL to replace the default URL of the self-service password reset (SSPR) 'Can't access your account?' hyperlink on the sign-in page. This URL must be in ASCII format or non-ASCII characters must be URL encoded, and not exceed 128 characters. DO NOT USE. Use customAccountResetCredentialsUrl instead.
customForgotMyPasswordText	string	A string to replace the default 'Forgot my password' hyperlink text on the sign-in form. This text must be in Unicode format and not exceed 256 characters.
customPrivacyAndCookiesText	string	A string to replace the default 'Privacy and Cookies' hyperlink text in the footer. This text must be in Unicode format and not exceed 256 characters.
customPrivacyAndCookiesUrl	string	A custom URL to replace the default URL of the 'Privacy and Cookies' hyperlink in the footer. This URL must be in ASCII format or non-ASCII characters must be URL encoded, and not exceed 128 characters.
customResetItNowText	string	A string to replace the default 'reset it now' hyperlink text on the sign-in form. This text must be in Unicode format and not exceed 256 characters. DO NOT USE: Customization of the 'reset it now' hyperlink text is currently not supported.
customTermsOfUseText	string	A string to replace the the default 'Terms of Use' hyperlink text in the footer. This text must be in Unicode format and not exceed 256 characters.
customTermsOfUseUrl	string	A custom URL to replace the default URL of the 'Terms of Use' hyperlink in the footer. This URL must be in ASCII format or non-ASCII characters must be URL encoded, and not exceed 128characters.
favicon	string (base64url)	A custom icon (favicon) to replace a default Microsoft product favicon on a Microsoft Entra tenant.
faviconRelativeUrl	string	A relative url for the favicon above that is combined with a CDN base URL from the cdnList to provide the version served by a CDN. Read-only.
headerBackgroundColor	string	The RGB color to apply to customize the color of the header.
headerLogo	string (base64url)	A company logo that appears in the header of the sign-in page. The allowed types are PNG or JPEG not larger than 36 × 245 pixels. We recommend using a transparent image with no padding around the logo.
headerLogoRelativeUrl	string	A relative URL for the headerLogo property that is combined with a CDN base URL from the cdnList to provide the read-only version served by a CDN. Read-only.
loginPageLayoutConfiguration		Represents the layout configuration to be displayed on the login page for a tenant.
loginPageTextVisibilitySettings		Represents the various texts that can be hidden on the login page for a tenant.
signInPageText	string	Text that appears at the bottom of the sign-in box. Use this to communicate additional information, such as the phone number to your help desk or a legal statement. This text must be in Unicode format and not exceed 1024 characters.
squareLogo	string (base64url)	A square version of your company logo that appears in Windows 10 out-of-box experiences (OOBE) and when Windows Autopilot is enabled for deployment. Allowed types are PNG or JPEG not larger than 240 x 240 pixels and not more than 10 KB in size. We recommend using a transparent image with no padding around the logo.
squareLogoDark	string (base64url)	A square dark version of your company logo that appears in Windows 10 out-of-box experiences (OOBE) and when Windows Autopilot is enabled for deployment. Allowed types are PNG or JPEG not larger than 240 x 240 pixels and not more than 10 KB in size. We recommend using a transparent image with no padding around the logo.
squareLogoDarkRelativeUrl	string	A relative URL for the squareLogoDark property that is combined with a CDN base URL from the cdnList to provide the version served by a CDN. Read-only.
squareLogoRelativeUrl	string	A relative URL for the squareLogo property that is combined with a CDN base URL from the cdnList to provide the version served by a CDN. Read-only.
usernameHintText	string	A string that shows as the hint in the username textbox on the sign-in screen. This text must be a Unicode, without links or code, and can't exceed 64 characters.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	organization_id, organizational_branding_localization_id		Read the properties and relationships of an organizationalBrandingLocalization object. To retrieve a localization branding object, specify the value of id in the URL.
list	select	organization_id		Retrieve all localization branding objects, including the default branding.
insert	insert	organization_id		Create a new organizationalBrandingLocalization object. This creates a localized branding and at the same time, the default branding if it doesn't exist. The default branding is created only once. It's loaded when a localized branding isn't configured for the user's browser language. To retrieve the default branding, see Get branding.
update	update	organization_id, organizational_branding_localization_id		Update the properties of an organizationalBrandingLocalization object for a specific localization.
delete	delete	organization_id, organizational_branding_localization_id	If-Match	Delete a localized branding object. To delete the organizationalBrandingLocalization object, all images (Stream types) must first be removed from the object.
background_image	exec	organization_id, organizational_branding_localization_id		Image that appears as the background of the sign-in page. The allowed types are PNG or JPEG not smaller than 300 KB and not larger than 1920 × 1080 pixels. A smaller image reduces bandwidth requirements and make the page load faster.
background_image_2	exec	organization_id, organizational_branding_localization_id	If-Match	Image that appears as the background of the sign-in page. The allowed types are PNG or JPEG not smaller than 300 KB and not larger than 1920 × 1080 pixels. A smaller image reduces bandwidth requirements and make the page load faster.
banner_logo	exec	organization_id, organizational_branding_localization_id		Update the properties of an organizationalBrandingLocalization object for a specific localization.
banner_logo_2	exec	organization_id, organizational_branding_localization_id	If-Match	A banner version of your company logo that appears on the sign-in page. The allowed types are PNG or JPEG not larger than 36 × 245 pixels. We recommend using a transparent image with no padding around the logo.
custom_css	exec	organization_id, organizational_branding_localization_id		CSS styling that appears on the sign-in page. The allowed format is .css format only and not larger than 25 KB.
custom_css_2	exec	organization_id, organizational_branding_localization_id	If-Match	CSS styling that appears on the sign-in page. The allowed format is .css format only and not larger than 25 KB.
favicon	exec	organization_id, organizational_branding_localization_id		A custom icon (favicon) to replace a default Microsoft product favicon on a Microsoft Entra tenant.
favicon_2	exec	organization_id, organizational_branding_localization_id	If-Match	A custom icon (favicon) to replace a default Microsoft product favicon on a Microsoft Entra tenant.
header_logo	exec	organization_id, organizational_branding_localization_id		A company logo that appears in the header of the sign-in page. The allowed types are PNG or JPEG not larger than 36 × 245 pixels. We recommend using a transparent image with no padding around the logo.
header_logo_2	exec	organization_id, organizational_branding_localization_id	If-Match	A company logo that appears in the header of the sign-in page. The allowed types are PNG or JPEG not larger than 36 × 245 pixels. We recommend using a transparent image with no padding around the logo.
square_logo	exec	organization_id, organizational_branding_localization_id		A square version of your company logo that appears in Windows 10 out-of-box experiences (OOBE) and when Windows Autopilot is enabled for deployment. Allowed types are PNG or JPEG not larger than 240 x 240 pixels and not more than 10 KB in size. We recommend using a transparent image with no padding around the logo.
square_logo_2	exec	organization_id, organizational_branding_localization_id	If-Match	A square version of your company logo that appears in Windows 10 out-of-box experiences (OOBE) and when Windows Autopilot is enabled for deployment. Allowed types are PNG or JPEG not larger than 240 x 240 pixels and not more than 10 KB in size. We recommend using a transparent image with no padding around the logo.
square_logo_dark	exec	organization_id, organizational_branding_localization_id		A square dark version of your company logo that appears in Windows 10 out-of-box experiences (OOBE) and when Windows Autopilot is enabled for deployment. Allowed types are PNG or JPEG not larger than 240 x 240 pixels and not more than 10 KB in size. We recommend using a transparent image with no padding around the logo.
square_logo_dark_2	exec	organization_id, organizational_branding_localization_id	If-Match	A square dark version of your company logo that appears in Windows 10 out-of-box experiences (OOBE) and when Windows Autopilot is enabled for deployment. Allowed types are PNG or JPEG not larger than 240 x 240 pixels and not more than 10 KB in size. We recommend using a transparent image with no padding around the logo.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
organization_id	string	The unique identifier of organization
organizational_branding_localization_id	string	The unique identifier of organizationalBrandingLocalization
If-Match	string	ETag

SELECT examples

get

Read the properties and relationships of an organizationalBrandingLocalization object. To retrieve a localization branding object, specify the value of id in the URL.

SELECT
id,
backgroundColor,
backgroundImage,
backgroundImageRelativeUrl,
bannerLogo,
bannerLogoRelativeUrl,
cdnList,
contentCustomization,
customAccountResetCredentialsUrl,
customCSS,
customCSSRelativeUrl,
customCannotAccessYourAccountText,
customCannotAccessYourAccountUrl,
customForgotMyPasswordText,
customPrivacyAndCookiesText,
customPrivacyAndCookiesUrl,
customResetItNowText,
customTermsOfUseText,
customTermsOfUseUrl,
favicon,
faviconRelativeUrl,
headerBackgroundColor,
headerLogo,
headerLogoRelativeUrl,
loginPageLayoutConfiguration,
loginPageTextVisibilitySettings,
signInPageText,
squareLogo,
squareLogoDark,
squareLogoDarkRelativeUrl,
squareLogoRelativeUrl,
usernameHintText
FROM entra_id.organization.branding_localizations
WHERE organization_id = '{{ organization_id }}' -- required
AND organizational_branding_localization_id = '{{ organizational_branding_localization_id }}' -- required
;

list

Retrieve all localization branding objects, including the default branding.

SELECT
id,
backgroundColor,
backgroundImage,
backgroundImageRelativeUrl,
bannerLogo,
bannerLogoRelativeUrl,
cdnList,
contentCustomization,
customAccountResetCredentialsUrl,
customCSS,
customCSSRelativeUrl,
customCannotAccessYourAccountText,
customCannotAccessYourAccountUrl,
customForgotMyPasswordText,
customPrivacyAndCookiesText,
customPrivacyAndCookiesUrl,
customResetItNowText,
customTermsOfUseText,
customTermsOfUseUrl,
favicon,
faviconRelativeUrl,
headerBackgroundColor,
headerLogo,
headerLogoRelativeUrl,
loginPageLayoutConfiguration,
loginPageTextVisibilitySettings,
signInPageText,
squareLogo,
squareLogoDark,
squareLogoDarkRelativeUrl,
squareLogoRelativeUrl,
usernameHintText
FROM entra_id.organization.branding_localizations
WHERE organization_id = '{{ organization_id }}' -- required
;

INSERT examples

insert

Create a new organizationalBrandingLocalization object. This creates a localized branding and at the same time, the default branding if it doesn't exist. The default branding is created only once. It's loaded when a localized branding isn't configured for the user's browser language. To retrieve the default branding, see Get branding.

INSERT INTO entra_id.organization.branding_localizations (
id,
backgroundColor,
backgroundImage,
backgroundImageRelativeUrl,
bannerLogo,
bannerLogoRelativeUrl,
cdnList,
contentCustomization,
customAccountResetCredentialsUrl,
customCannotAccessYourAccountText,
customCannotAccessYourAccountUrl,
customCSS,
customCSSRelativeUrl,
customForgotMyPasswordText,
customPrivacyAndCookiesText,
customPrivacyAndCookiesUrl,
customResetItNowText,
customTermsOfUseText,
customTermsOfUseUrl,
favicon,
faviconRelativeUrl,
headerBackgroundColor,
headerLogo,
headerLogoRelativeUrl,
loginPageLayoutConfiguration,
loginPageTextVisibilitySettings,
signInPageText,
squareLogo,
squareLogoDark,
squareLogoDarkRelativeUrl,
squareLogoRelativeUrl,
usernameHintText,
organization_id
)
SELECT 
'{{ id }}',
'{{ backgroundColor }}',
'{{ backgroundImage }}',
'{{ backgroundImageRelativeUrl }}',
'{{ bannerLogo }}',
'{{ bannerLogoRelativeUrl }}',
'{{ cdnList }}',
'{{ contentCustomization }}',
'{{ customAccountResetCredentialsUrl }}',
'{{ customCannotAccessYourAccountText }}',
'{{ customCannotAccessYourAccountUrl }}',
'{{ customCSS }}',
'{{ customCSSRelativeUrl }}',
'{{ customForgotMyPasswordText }}',
'{{ customPrivacyAndCookiesText }}',
'{{ customPrivacyAndCookiesUrl }}',
'{{ customResetItNowText }}',
'{{ customTermsOfUseText }}',
'{{ customTermsOfUseUrl }}',
'{{ favicon }}',
'{{ faviconRelativeUrl }}',
'{{ headerBackgroundColor }}',
'{{ headerLogo }}',
'{{ headerLogoRelativeUrl }}',
'{{ loginPageLayoutConfiguration }}',
'{{ loginPageTextVisibilitySettings }}',
'{{ signInPageText }}',
'{{ squareLogo }}',
'{{ squareLogoDark }}',
'{{ squareLogoDarkRelativeUrl }}',
'{{ squareLogoRelativeUrl }}',
'{{ usernameHintText }}',
'{{ organization_id }}'
RETURNING
id,
backgroundColor,
backgroundImage,
backgroundImageRelativeUrl,
bannerLogo,
bannerLogoRelativeUrl,
cdnList,
contentCustomization,
customAccountResetCredentialsUrl,
customCSS,
customCSSRelativeUrl,
customCannotAccessYourAccountText,
customCannotAccessYourAccountUrl,
customForgotMyPasswordText,
customPrivacyAndCookiesText,
customPrivacyAndCookiesUrl,
customResetItNowText,
customTermsOfUseText,
customTermsOfUseUrl,
favicon,
faviconRelativeUrl,
headerBackgroundColor,
headerLogo,
headerLogoRelativeUrl,
loginPageLayoutConfiguration,
loginPageTextVisibilitySettings,
signInPageText,
squareLogo,
squareLogoDark,
squareLogoDarkRelativeUrl,
squareLogoRelativeUrl,
usernameHintText
;

Manifest

# Description fields are for documentation purposes
- name: branding_localizations
props:
  - name: organization_id
    value: "{{ organization_id }}"
    description: Required parameter for the branding_localizations resource.
  - name: id
    value: "{{ id }}"
    description: |
      The unique identifier for an entity. Read-only.
  - name: backgroundColor
    value: "{{ backgroundColor }}"
    description: |
      Color that appears in place of the background image in low-bandwidth connections. We recommend that you use the primary color of your banner logo or your organization color. Specify this in hexadecimal format, for example, white is #FFFFFF.
  - name: backgroundImage
    value: "{{ backgroundImage }}"
    description: |
      Image that appears as the background of the sign-in page. The allowed types are PNG or JPEG not smaller than 300 KB and not larger than 1920 × 1080 pixels. A smaller image reduces bandwidth requirements and make the page load faster.
  - name: backgroundImageRelativeUrl
    value: "{{ backgroundImageRelativeUrl }}"
    description: |
      A relative URL for the backgroundImage property that is combined with a CDN base URL from the cdnList to provide the version served by a CDN. Read-only.
  - name: bannerLogo
    value: "{{ bannerLogo }}"
    description: |
      A banner version of your company logo that appears on the sign-in page. The allowed types are PNG or JPEG not larger than 36 × 245 pixels. We recommend using a transparent image with no padding around the logo.
  - name: bannerLogoRelativeUrl
    value: "{{ bannerLogoRelativeUrl }}"
    description: |
      A relative URL for the bannerLogo property that is combined with a CDN base URL from the cdnList to provide the read-only version served by a CDN. Read-only.
  - name: cdnList
    value:
      - "{{ cdnList }}"
    description: |
      A list of base URLs for all available CDN providers that are serving the assets of the current resource. Several CDN providers are used at the same time for high availability of read requests. Read-only.
  - name: contentCustomization
    value: "{{ contentCustomization }}"
    description: |
      Represents the content options to be customized throughout the authentication flow for a tenant. NOTE: Supported by Microsoft Entra External ID in external tenants only.
  - name: customAccountResetCredentialsUrl
    value: "{{ customAccountResetCredentialsUrl }}"
    description: |
      A custom URL for resetting account credentials. This URL must be in ASCII format or non-ASCII characters must be URL encoded, and not exceed 128 characters.
  - name: customCannotAccessYourAccountText
    value: "{{ customCannotAccessYourAccountText }}"
    description: |
      A string to replace the default 'Can't access your account?' self-service password reset (SSPR) hyperlink text on the sign-in page. This text must be in Unicode format and not exceed 256 characters.
  - name: customCannotAccessYourAccountUrl
    value: "{{ customCannotAccessYourAccountUrl }}"
    description: |
      A custom URL to replace the default URL of the self-service password reset (SSPR) 'Can't access your account?' hyperlink on the sign-in page. This URL must be in ASCII format or non-ASCII characters must be URL encoded, and not exceed 128 characters. DO NOT USE. Use customAccountResetCredentialsUrl instead.
  - name: customCSS
    value: "{{ customCSS }}"
    description: |
      CSS styling that appears on the sign-in page. The allowed format is .css format only and not larger than 25 KB.
  - name: customCSSRelativeUrl
    value: "{{ customCSSRelativeUrl }}"
    description: |
      A relative URL for the customCSS property that is combined with a CDN base URL from the cdnList to provide the version served by a CDN. Read-only.
  - name: customForgotMyPasswordText
    value: "{{ customForgotMyPasswordText }}"
    description: |
      A string to replace the default 'Forgot my password' hyperlink text on the sign-in form. This text must be in Unicode format and not exceed 256 characters.
  - name: customPrivacyAndCookiesText
    value: "{{ customPrivacyAndCookiesText }}"
    description: |
      A string to replace the default 'Privacy and Cookies' hyperlink text in the footer. This text must be in Unicode format and not exceed 256 characters.
  - name: customPrivacyAndCookiesUrl
    value: "{{ customPrivacyAndCookiesUrl }}"
    description: |
      A custom URL to replace the default URL of the 'Privacy and Cookies' hyperlink in the footer. This URL must be in ASCII format or non-ASCII characters must be URL encoded, and not exceed 128 characters.
  - name: customResetItNowText
    value: "{{ customResetItNowText }}"
    description: |
      A string to replace the default 'reset it now' hyperlink text on the sign-in form. This text must be in Unicode format and not exceed 256 characters. DO NOT USE: Customization of the 'reset it now' hyperlink text is currently not supported.
  - name: customTermsOfUseText
    value: "{{ customTermsOfUseText }}"
    description: |
      A string to replace the the default 'Terms of Use' hyperlink text in the footer. This text must be in Unicode format and not exceed 256 characters.
  - name: customTermsOfUseUrl
    value: "{{ customTermsOfUseUrl }}"
    description: |
      A custom URL to replace the default URL of the 'Terms of Use' hyperlink in the footer. This URL must be in ASCII format or non-ASCII characters must be URL encoded, and not exceed 128characters.
  - name: favicon
    value: "{{ favicon }}"
    description: |
      A custom icon (favicon) to replace a default Microsoft product favicon on a Microsoft Entra tenant.
  - name: faviconRelativeUrl
    value: "{{ faviconRelativeUrl }}"
    description: |
      A relative url for the favicon above that is combined with a CDN base URL from the cdnList to provide the version served by a CDN. Read-only.
  - name: headerBackgroundColor
    value: "{{ headerBackgroundColor }}"
    description: |
      The RGB color to apply to customize the color of the header.
  - name: headerLogo
    value: "{{ headerLogo }}"
    description: |
      A company logo that appears in the header of the sign-in page. The allowed types are PNG or JPEG not larger than 36 × 245 pixels. We recommend using a transparent image with no padding around the logo.
  - name: headerLogoRelativeUrl
    value: "{{ headerLogoRelativeUrl }}"
    description: |
      A relative URL for the headerLogo property that is combined with a CDN base URL from the cdnList to provide the read-only version served by a CDN. Read-only.
  - name: loginPageLayoutConfiguration
    value: "{{ loginPageLayoutConfiguration }}"
    description: |
      Represents the layout configuration to be displayed on the login page for a tenant.
  - name: loginPageTextVisibilitySettings
    value: "{{ loginPageTextVisibilitySettings }}"
    description: |
      Represents the various texts that can be hidden on the login page for a tenant.
  - name: signInPageText
    value: "{{ signInPageText }}"
    description: |
      Text that appears at the bottom of the sign-in box. Use this to communicate additional information, such as the phone number to your help desk or a legal statement. This text must be in Unicode format and not exceed 1024 characters.
  - name: squareLogo
    value: "{{ squareLogo }}"
    description: |
      A square version of your company logo that appears in Windows 10 out-of-box experiences (OOBE) and when Windows Autopilot is enabled for deployment. Allowed types are PNG or JPEG not larger than 240 x 240 pixels and not more than 10 KB in size. We recommend using a transparent image with no padding around the logo.
  - name: squareLogoDark
    value: "{{ squareLogoDark }}"
    description: |
      A square dark version of your company logo that appears in Windows 10 out-of-box experiences (OOBE) and when Windows Autopilot is enabled for deployment. Allowed types are PNG or JPEG not larger than 240 x 240 pixels and not more than 10 KB in size. We recommend using a transparent image with no padding around the logo.
  - name: squareLogoDarkRelativeUrl
    value: "{{ squareLogoDarkRelativeUrl }}"
    description: |
      A relative URL for the squareLogoDark property that is combined with a CDN base URL from the cdnList to provide the version served by a CDN. Read-only.
  - name: squareLogoRelativeUrl
    value: "{{ squareLogoRelativeUrl }}"
    description: |
      A relative URL for the squareLogo property that is combined with a CDN base URL from the cdnList to provide the version served by a CDN. Read-only.
  - name: usernameHintText
    value: "{{ usernameHintText }}"
    description: |
      A string that shows as the hint in the username textbox on the sign-in screen. This text must be a Unicode, without links or code, and can't exceed 64 characters.

UPDATE examples

update

Update the properties of an organizationalBrandingLocalization object for a specific localization.

UPDATE entra_id.organization.branding_localizations
SET 
id = '{{ id }}',
backgroundColor = '{{ backgroundColor }}',
backgroundImage = '{{ backgroundImage }}',
backgroundImageRelativeUrl = '{{ backgroundImageRelativeUrl }}',
bannerLogo = '{{ bannerLogo }}',
bannerLogoRelativeUrl = '{{ bannerLogoRelativeUrl }}',
cdnList = '{{ cdnList }}',
contentCustomization = '{{ contentCustomization }}',
customAccountResetCredentialsUrl = '{{ customAccountResetCredentialsUrl }}',
customCannotAccessYourAccountText = '{{ customCannotAccessYourAccountText }}',
customCannotAccessYourAccountUrl = '{{ customCannotAccessYourAccountUrl }}',
customCSS = '{{ customCSS }}',
customCSSRelativeUrl = '{{ customCSSRelativeUrl }}',
customForgotMyPasswordText = '{{ customForgotMyPasswordText }}',
customPrivacyAndCookiesText = '{{ customPrivacyAndCookiesText }}',
customPrivacyAndCookiesUrl = '{{ customPrivacyAndCookiesUrl }}',
customResetItNowText = '{{ customResetItNowText }}',
customTermsOfUseText = '{{ customTermsOfUseText }}',
customTermsOfUseUrl = '{{ customTermsOfUseUrl }}',
favicon = '{{ favicon }}',
faviconRelativeUrl = '{{ faviconRelativeUrl }}',
headerBackgroundColor = '{{ headerBackgroundColor }}',
headerLogo = '{{ headerLogo }}',
headerLogoRelativeUrl = '{{ headerLogoRelativeUrl }}',
loginPageLayoutConfiguration = '{{ loginPageLayoutConfiguration }}',
loginPageTextVisibilitySettings = '{{ loginPageTextVisibilitySettings }}',
signInPageText = '{{ signInPageText }}',
squareLogo = '{{ squareLogo }}',
squareLogoDark = '{{ squareLogoDark }}',
squareLogoDarkRelativeUrl = '{{ squareLogoDarkRelativeUrl }}',
squareLogoRelativeUrl = '{{ squareLogoRelativeUrl }}',
usernameHintText = '{{ usernameHintText }}'
WHERE 
organization_id = '{{ organization_id }}' --required
AND organizational_branding_localization_id = '{{ organizational_branding_localization_id }}' --required
RETURNING
id,
backgroundColor,
backgroundImage,
backgroundImageRelativeUrl,
bannerLogo,
bannerLogoRelativeUrl,
cdnList,
contentCustomization,
customAccountResetCredentialsUrl,
customCSS,
customCSSRelativeUrl,
customCannotAccessYourAccountText,
customCannotAccessYourAccountUrl,
customForgotMyPasswordText,
customPrivacyAndCookiesText,
customPrivacyAndCookiesUrl,
customResetItNowText,
customTermsOfUseText,
customTermsOfUseUrl,
favicon,
faviconRelativeUrl,
headerBackgroundColor,
headerLogo,
headerLogoRelativeUrl,
loginPageLayoutConfiguration,
loginPageTextVisibilitySettings,
signInPageText,
squareLogo,
squareLogoDark,
squareLogoDarkRelativeUrl,
squareLogoRelativeUrl,
usernameHintText;

DELETE examples

delete

Delete a localized branding object. To delete the organizationalBrandingLocalization object, all images (Stream types) must first be removed from the object.

DELETE FROM entra_id.organization.branding_localizations
WHERE organization_id = '{{ organization_id }}' --required
AND organizational_branding_localization_id = '{{ organizational_branding_localization_id }}' --required
AND If-Match = '{{ If-Match }}'
;

Lifecycle Methods

background_image

Image that appears as the background of the sign-in page. The allowed types are PNG or JPEG not smaller than 300 KB and not larger than 1920 × 1080 pixels. A smaller image reduces bandwidth requirements and make the page load faster.

EXEC entra_id.organization.branding_localizations.background_image 
@organization_id='{{ organization_id }}' --required, 
@organizational_branding_localization_id='{{ organizational_branding_localization_id }}' --required
;

background_image_2

Image that appears as the background of the sign-in page. The allowed types are PNG or JPEG not smaller than 300 KB and not larger than 1920 × 1080 pixels. A smaller image reduces bandwidth requirements and make the page load faster.

EXEC entra_id.organization.branding_localizations.background_image_2 
@organization_id='{{ organization_id }}' --required, 
@organizational_branding_localization_id='{{ organizational_branding_localization_id }}' --required, 
@If-Match='{{ If-Match }}'
;

banner_logo

Update the properties of an organizationalBrandingLocalization object for a specific localization.

EXEC entra_id.organization.branding_localizations.banner_logo 
@organization_id='{{ organization_id }}' --required, 
@organizational_branding_localization_id='{{ organizational_branding_localization_id }}' --required
;

banner_logo_2

A banner version of your company logo that appears on the sign-in page. The allowed types are PNG or JPEG not larger than 36 × 245 pixels. We recommend using a transparent image with no padding around the logo.

EXEC entra_id.organization.branding_localizations.banner_logo_2 
@organization_id='{{ organization_id }}' --required, 
@organizational_branding_localization_id='{{ organizational_branding_localization_id }}' --required, 
@If-Match='{{ If-Match }}'
;

custom_css

CSS styling that appears on the sign-in page. The allowed format is .css format only and not larger than 25 KB.

EXEC entra_id.organization.branding_localizations.custom_css 
@organization_id='{{ organization_id }}' --required, 
@organizational_branding_localization_id='{{ organizational_branding_localization_id }}' --required
;

custom_css_2

CSS styling that appears on the sign-in page. The allowed format is .css format only and not larger than 25 KB.

EXEC entra_id.organization.branding_localizations.custom_css_2 
@organization_id='{{ organization_id }}' --required, 
@organizational_branding_localization_id='{{ organizational_branding_localization_id }}' --required, 
@If-Match='{{ If-Match }}'
;

favicon

A custom icon (favicon) to replace a default Microsoft product favicon on a Microsoft Entra tenant.

EXEC entra_id.organization.branding_localizations.favicon 
@organization_id='{{ organization_id }}' --required, 
@organizational_branding_localization_id='{{ organizational_branding_localization_id }}' --required
;

favicon_2

A custom icon (favicon) to replace a default Microsoft product favicon on a Microsoft Entra tenant.

EXEC entra_id.organization.branding_localizations.favicon_2 
@organization_id='{{ organization_id }}' --required, 
@organizational_branding_localization_id='{{ organizational_branding_localization_id }}' --required, 
@If-Match='{{ If-Match }}'
;

header_logo

A company logo that appears in the header of the sign-in page. The allowed types are PNG or JPEG not larger than 36 × 245 pixels. We recommend using a transparent image with no padding around the logo.

EXEC entra_id.organization.branding_localizations.header_logo 
@organization_id='{{ organization_id }}' --required, 
@organizational_branding_localization_id='{{ organizational_branding_localization_id }}' --required
;

header_logo_2

A company logo that appears in the header of the sign-in page. The allowed types are PNG or JPEG not larger than 36 × 245 pixels. We recommend using a transparent image with no padding around the logo.

EXEC entra_id.organization.branding_localizations.header_logo_2 
@organization_id='{{ organization_id }}' --required, 
@organizational_branding_localization_id='{{ organizational_branding_localization_id }}' --required, 
@If-Match='{{ If-Match }}'
;

square_logo

A square version of your company logo that appears in Windows 10 out-of-box experiences (OOBE) and when Windows Autopilot is enabled for deployment. Allowed types are PNG or JPEG not larger than 240 x 240 pixels and not more than 10 KB in size. We recommend using a transparent image with no padding around the logo.

EXEC entra_id.organization.branding_localizations.square_logo 
@organization_id='{{ organization_id }}' --required, 
@organizational_branding_localization_id='{{ organizational_branding_localization_id }}' --required
;

square_logo_2

A square version of your company logo that appears in Windows 10 out-of-box experiences (OOBE) and when Windows Autopilot is enabled for deployment. Allowed types are PNG or JPEG not larger than 240 x 240 pixels and not more than 10 KB in size. We recommend using a transparent image with no padding around the logo.

EXEC entra_id.organization.branding_localizations.square_logo_2 
@organization_id='{{ organization_id }}' --required, 
@organizational_branding_localization_id='{{ organizational_branding_localization_id }}' --required, 
@If-Match='{{ If-Match }}'
;

square_logo_dark

A square dark version of your company logo that appears in Windows 10 out-of-box experiences (OOBE) and when Windows Autopilot is enabled for deployment. Allowed types are PNG or JPEG not larger than 240 x 240 pixels and not more than 10 KB in size. We recommend using a transparent image with no padding around the logo.

EXEC entra_id.organization.branding_localizations.square_logo_dark 
@organization_id='{{ organization_id }}' --required, 
@organizational_branding_localization_id='{{ organizational_branding_localization_id }}' --required
;

square_logo_dark_2

A square dark version of your company logo that appears in Windows 10 out-of-box experiences (OOBE) and when Windows Autopilot is enabled for deployment. Allowed types are PNG or JPEG not larger than 240 x 240 pixels and not more than 10 KB in size. We recommend using a transparent image with no padding around the logo.

EXEC entra_id.organization.branding_localizations.square_logo_dark_2 
@organization_id='{{ organization_id }}' --required, 
@organizational_branding_localization_id='{{ organizational_branding_localization_id }}' --required, 
@If-Match='{{ If-Match }}'
;