Microsoft Entra External ID
Authentication

Microsoft Entra External ID Styling

In brief

New documentation describes Basic styling with generated color ramps and Advanced styling with design-token overrides for light and dark authentication themes. The options are scheduled for preview availability on December 7, 2026.

What Entra admins need to know

Administrators can plan branded customer authentication experiences and validate colors, contrast, and appearance in both themes. No immediate action is required.

This editorial summary was generated by AI from the documentation changes. Verify important details in the full Microsoft Learn article.

Documentation change

The comparison below shows only the changed extract. Use the full-page view for complete context.

new file mode 100644

title: Microsoft Entra External ID Styling titleSuffix: "" description: Align customer sign-in with your brand using Basic color ramps or Advanced design tokens, then configure and validate each appearance. ms.topic: concept-article ms.date: 11/15/2026 ms.custom: msecd-doc-authoring-1026 ai-usage: ai-generated #customer intent: As an administrator, I want to understand the styling options so that I can align customer authentication with my organization's visual design.

Microsoft Entra External ID styling overview

[!INCLUDE applies-to-external-only]

Carry your brand's visual identity throughout the authentication experience, from recognizable colors to distinctive typography and shapes. Basic and Advanced styling in Microsoft Entra External ID let you make the modern authentication experience yours, building on Microsoft's Fluent design language.

Use Basic styling to create a branded authentication experience with minimal effort. Set your brand colors in the Microsoft Entra admin center to generate a coordinated palette for supported controls and states in light and dark modes, without configuring individual style overrides. Use Advanced styling for finer control over supported colors, typography, spacing, borders, and other visual properties to reflect your design system.

Both options work through branding themes.

How design tokens work

Design tokens are named values for colors, font sizes, spacing, and corner radii. Controls use these theme values to keep their appearance consistent. A shared token affects all elements that use it; a component-specific property targets a particular supported area or control.

Example tokenWhat it definesExample value
colorBrandBackgroundA brand-colored background for controls that use this visual role.#0F6CBD
fontSizeBase300A font size in the shared typography scale.14px
borderRadiusMediumA corner radius in the shared shape scale.4px

Basic styling requires no design-token knowledge: enter your brand color in the admin center to automatically generate and apply a ramp to supported controls and states. Advanced styling lets you override individual tokens and component-specific properties.

Values are grouped by purpose under lightTheme and darkTheme in the designTokens configuration. Each mode is configured independently and can use different values. Standard Fluent tokens you don't override retain the mode's defaults.

Basic styling

Basic styling creates a branded authentication experience without design-token knowledge. In your theme's Styling settings, select Basic under Styling method, then set Light theme brand color and Dark theme brand color. The admin center automatically generates and applies a coordinated palette to supported controls and states.

Each mode has its own palette, designed to meet contrast requirements and support accessibility. Use the built-in contrast checker to review each brand color against white text, and validate the final experience in both modes.

:::image type="content" source="customers/media/modern-ux-customization/ignite-basic-styling.png" alt-text="Screenshot of Basic styling with separate light-theme and dark-theme brand colors and generated ramps numbered 10 through 160." lightbox="customers/media/modern-ux-customization/ignite-basic-styling.png":::

How ramp values are used

The palette contains 16 related shades, numbered 10 through 160 in increments of 10. Different controls and states use different shades in each mode; the ramp isn't a gradient displayed across the page.

:::image type="content" source="customers/media/modern-ux-customization/brand-color-ramp.png" alt-text="Screenshot of the light-theme and dark-theme brand-color ramps in the admin center, each with 16 stops numbered 10 through 160." lightbox="customers/media/modern-ux-customization/brand-color-ramp.png":::

The following table shows the default ramp mappings before explicit color overrides. Where three values appear, their order is normal / hover / pressed.

Element or stateLight-mode ramp valuesDark-mode ramp values
Primary-button background80 / 70 / 4070 / 80 / 40
Built-in link text70 / 60 / 40100 / 110 / 90
Text-input and dropdown focus underline: focused / focused and pressed80 / 60100 / 90
Code-entry box focused border80100
Checked checkbox indicator and selected radio indicator80 / 70 / 60100 / 110 / 90
Loading spinner: moving arc / track80 / 140100 / 50

The palette doesn't automatically recolor every element, such as logos, page backgrounds, or error messages. For token mappings, overrides, and programmatic requirements, see Color-ramp behavior and semantic mappings in the appendix.

Advanced styling

Use Advanced styling when a brand ramp alone doesn't meet your design requirements. You can keep the ramp and add individual token overrides or component-specific properties rather than replacing the entire theme.

You can combine Advanced styling with custom HTML: use design tokens to style the supported authentication controls and custom HTML to define the surrounding page layout and content.

These settings change appearance, not authentication requirements, flow logic, or the controls' internal structure. They don't provide arbitrary CSS or a dependency on generated class names.

:::image type="content" source="customers/media/modern-ux-customization/overview-advanced-styling.png" alt-text="Screenshot of a Contoso Airways sign-in page with customized purple colors, typography, and rounded controls." lightbox="customers/media/modern-ux-customization/overview-advanced-styling.png":::

JSON template

Start with this light- and dark-theme template. Keep only the overrides you need, preserve existing settings, and replace the example font URL if used.


Expand the JSON template
{
  "lightTheme": {
    "themeColorRamp": {
      "10": "#080117",
      "20": "#21005D",
      "30": "#32147A",
      "40": "#432B8F",
      "50": "#553FA3",
      "60": "#6753B7",
      "70": "#7967CA",
      "80": "#8C7BDD",
      "90": "#9F90EF",
      "100": "#B2A5FF",
      "110": "#C2B7FF",
      "120": "#D1C9FF",
      "130": "#DFDBFF",
      "140": "#EBE8FF",
      "150": "#F5F3FF",
      "160": "#FCFBFF"
    },
    "colorStyles": {
      "colorNeutralBackground1": "#FFFFFF",
      "colorNeutralForeground1": "#242424",
      "colorNeutralStroke1": "#D1D1D1"
    },
    "typographyStyles": {
      "fontFamilyBase": "'Segoe UI', sans-serif",
      "fontSizeBase300": "14px",
      "fontWeightSemibold": 600
    },
    "spacingStyles": {
      "spacingHorizontalM": "12px",
      "spacingVerticalM": "12px"
    },
    "borderStyles": {
      "borderRadiusMedium": "8px",
      "strokeWidthThin": "1px"
    },
    "backgroundStyles": {
      "opacity": 1,
      "fillColor": "#ffffff"
    },
    "titleStyles": {
      "textAlign": "center",
      "textDecoration": "none",
      "maxWidth": "100%",
      "color": "#242424"
    },
    "primaryButtonStyles": {
      "alignSelf": "auto",
      "backgroundColor": "#0f6cbd",
      "borderColor": "transparent",
      "borderRadius": "4px",
      "borderSize": "1px",
      "borderStyle": "none",
      "color": "#ffffff",
      "textAlign": "center",
      "textDecoration": "none",
      "maxWidth": "100%",
      "minWidth": "auto",
      "opacity": 1,
      "width": "auto"
    },
    "inputStyles": {
      "borderRadius": "4px",
      "textAlign": "left",
      "textDecoration": "none",
      "maxWidth": "100%",
      "minWidth": "0",
      "borderStyle": "solid",
      "opacity": 1,
      "lineHeight": "22px",
      "floatingPlaceholderColor": "#707070",
      "floatingPlaceholderBackgroundColor": "#ffffff",
      "disabledPlaceholderColor": "#bdbdbd",
      "floatingLabelMarginTop": "8px",
      "stackedInputMarginTop": "24px",
      "validationErrorFontSize": "12px",
      "transitionDuration": "200ms",
      "transitionTimingFunction": "cubic-bezier(0,0,0,1)"
    },
    "fontFaceStyles": [
      {
        "fontFamily": "CustomBrandFont",
        "srcUrl": "https://cdn.example.com/fonts/custom-brand-font.woff2",
        "fontWeight": "100 900",
        "fontStyle": "normal",
        "fontStretch": "normal",
        "fontDisplay": "swap"
      }
    ],
    "buttonContainerStyles": {
      "flexDirection": "column",
      "justifyContent": "flex-start",
      "alignItems": "stretch",
      "columnGap": "12px",
      "rowGap": "12px",
      "flexWrap": "nowrap"
    },
    "footerStyles": {
      "textAlign": "center",
      "textDecoration": "none",
      "maxWidth": "100%",
      "opacity": 1,
      "borderStyle": "none",
      "backgroundColor": "#ffffff",
      "color": "#424242",
      "paddingVertical": "12px",
      "paddingHorizontal": "12px"
    },
    "headerStyles": {
      "borderRadius": "0",
      "height": "48px",
      "maxWidth": "100%",
      "minWidth": "0",
      "opacity": 1,
      "logoPosition": "left",
      "logoSize": "24px",
      "logoPadding": "0",
      "backgroundColor": "transparent",
      "paddingHorizontal": "16px",
      "paddingVertical": "12px",
      "color": "#242424"
    },
    "linkStyles": {
      "textAlign": "left",
      "textDecoration": "none"
    },
    "paragraphStyles": {
      "textAlign": "left",
      "textDecoration": "none",
      "maxWidth": "100%"
    },
    "secondaryButtonStyles": {
      "alignSelf": "auto",
      "backgroundColor": "#ffffff",
      "borderColor": "#d1d1d1",
      "borderRadius": "4px",
      "borderSize": "1px",
      "borderStyle": "solid",
      "color": "#242424",
      "textAlign": "center",
      "textDecoration": "none",
      "maxWidth": "100%",
      "minWidth": "auto",
      "opacity": 1,
      "width": "auto"
    },
    "signInContainerStyles": {
      "maxWidth": "440px",
      "minWidth": "320px",
      "maxHeight": "none",
      "minHeight": "0",
      "height": "auto",
      "width": "440px",
      "borderStyle": "none",
      "opacity": 1,
      "logoPosition": "center",
      "logoSize": "36px",
      "logoPadding": "0",
      "backgroundColor": "#ffffff",
      "borderRadius": "12px",
      "padding": "40px"
    },
    "slotSubHeadingStyles": {
      "backgroundColor": "transparent",
      "color": "inherit",
      "borderColor": "transparent",
      "borderRadius": "0",
      "borderStyle": "none",
      "borderWidth": "0",
      "paddingHorizontal": "0",
      "paddingVertical": "0"
    },
    "slotFormStyles": {
      "backgroundColor": "transparent",
      "color": "inherit",
      "borderColor": "transparent",
      "borderRadius": "0",
      "borderStyle": "none",
      "borderWidth": "0",
      "paddingHorizontal": "0",
      "paddingVertical": "0"
    },
    "subtleButtonStyles": {
      "alignSelf": "auto",
      "backgroundColor": "transparent",
      "borderColor": "transparent",
      "borderRadius": "4px",
      "borderSize": "1px",
      "borderStyle": "none",
      "color": "#424242",
      "textAlign": "center",
      "textDecoration": "none",
      "maxWidth": "100%",
      "minWidth": "auto",
      "opacity": 1,
      "width": "auto"
    },
    "tileStyles": {
      "mainTextColor": "#242424",
      "mainTextFontSize": "14px",
      "mainTextFontWeight": 600,
      "secondaryTextColor": "#616161",
      "secondaryTextFontSize": "12px",
      "listRowGap": "12px"
    }
  },
  "darkTheme": {
    "themeColorRamp": {
      "10": "#080117",
      "20": "#21005D",
      "30": "#32147A",
      "40": "#432B8F",
      "50": "#553FA3",
      "60": "#6753B7",
      "70": "#7967CA",
      "80": "#8C7BDD",
      "90": "#9F90EF",
      "100": "#B2A5FF",
      "110": "#C2B7FF",
      "120": "#D1C9FF",
      "130": "#DFDBFF",
      "140": "#EBE8FF",
      "150": "#F5F3FF",
      "160": "#FCFBFF"
    },
    "colorStyles": {
      "colorNeutralBackground1": "#292929",
      "colorNeutralForeground1": "#FFFFFF",
      "colorNeutralStroke1": "#666666"
    },
    "typographyStyles": {
      "fontFamilyBase": "'Segoe UI', sans-serif",
      "fontSizeBase300": "14px",
      "fontWeightSemibold": 600
    },
    "spacingStyles": {
      "spacingHorizontalM": "12px",
      "spacingVerticalM": "12px"
    },
    "borderStyles": {
      "borderRadiusMedium": "8px",
      "strokeWidthThin": "1px"
    },
    "backgroundStyles": {
      "opacity": 1,
      "fillColor": "#292929"
    },
    "titleStyles": {
      "textAlign": "center",
      "textDecoration": "none",
      "maxWidth": "100%",
      "color": "#ffffff"
    },
    "primaryButtonStyles": {
      "alignSelf": "auto",
      "backgroundColor": "#115ea3",
      "borderColor": "transparent",
      "borderRadius": "4px",
      "borderSize": "1px",
      "borderStyle": "none",
      "color": "#ffffff",
      "textAlign": "center",
      "textDecoration": "none",
      "maxWidth": "100%",
      "minWidth": "auto",
      "opacity": 1,
      "width": "auto"
    },
    "inputStyles": {
      "borderRadius": "4px",
      "textAlign": "left",
      "textDecoration": "none",
      "maxWidth": "100%",
      "minWidth": "0",
      "borderStyle": "solid",
      "opacity": 1,
      "lineHeight": "22px",
      "floatingPlaceholderColor": "#999999",
      "floatingPlaceholderBackgroundColor": "#292929",
      "disabledPlaceholderColor": "#5c5c5c",
      "floatingLabelMarginTop": "8px",
      "stackedInputMarginTop": "24px",
      "validationErrorFontSize": "12px",
      "transitionDuration": "200ms",
      "transitionTimingFunction": "cubic-bezier(0,0,0,1)"
    },
    "fontFaceStyles": [
      {
        "fontFamily": "CustomBrandFont",
        "srcUrl": "https://cdn.example.com/fonts/custom-brand-font.woff2",
        "fontWeight": "100 900",
        "fontStyle": "normal",
        "fontStretch": "normal",
        "fontDisplay": "swap"
      }
    ],
    "buttonContainerStyles": {
      "flexDirection": "column",
      "justifyContent": "flex-start",
      "alignItems": "stretch",
      "columnGap": "12px",
      "rowGap": "12px",
      "flexWrap": "nowrap"
    },
    "footerStyles": {
      "textAlign": "center",
      "textDecoration": "none",
      "maxWidth": "100%",
      "opacity": 1,
      "borderStyle": "none",
      "backgroundColor": "#292929",
      "color": "#d6d6d6",
      "paddingVertical": "12px",
      "paddingHorizontal": "12px"
    },
    "headerStyles": {
      "borderRadius": "0",
      "height": "48px",
      "maxWidth": "100%",
      "minWidth": "0",
      "opacity": 1,
      "logoPosition": "left",
      "logoSize": "24px",
      "logoPadding": "0",
      "backgroundColor": "transparent",
      "paddingHorizontal": "16px",
      "paddingVertical": "12px",
      "color": "#ffffff"
    },
    "linkStyles": {
      "textAlign": "left",
      "textDecoration": "none"
    },
    "paragraphStyles": {
      "textAlign": "left",
      "textDecoration": "none",
      "maxWidth": "100%"
    },
    "secondaryButtonStyles": {
      "alignSelf": "auto",
      "backgroundColor": "#292929",
      "borderColor": "#666666",
      "borderRadius": "4px",
      "borderSize": "1px",
      "borderStyle": "solid",
      "color": "#ffffff",
      "textAlign": "center",
      "textDecoration": "none",
      "maxWidth": "100%",
      "minWidth": "auto",
      "opacity": 1,
      "width": "auto"
    },
    "signInContainerStyles": {
      "maxWidth": "440px",
      "minWidth": "320px",
      "maxHeight": "none",
      "minHeight": "0",
      "height": "auto",
      "width": "440px",
      "borderStyle": "none",
      "opacity": 1,
      "logoPosition": "center",
      "logoSize": "36px",
      "logoPadding": "0",
      "backgroundColor": "#292929",
      "borderRadius": "12px",
      "padding": "40px"
    },
    "slotSubHeadingStyles": {
      "backgroundColor": "transparent",
      "color": "inherit",
      "borderColor": "transparent",
      "borderRadius": "0",
      "borderStyle": "none",
      "borderWidth": "0",
      "paddingHorizontal": "0",
      "paddingVertical": "0"
    },
    "slotFormStyles": {
      "backgroundColor": "transparent",
      "color": "inherit",
      "borderColor": "transparent",
      "borderRadius": "0",
      "borderStyle": "none",
      "borderWidth": "0",
      "paddingHorizontal": "0",
      "paddingVertical": "0"
    },
    "subtleButtonStyles": {
      "alignSelf": "auto",
      "backgroundColor": "transparent",
      "borderColor": "transparent",
      "borderRadius": "4px",
      "borderSize": "1px",
      "borderStyle": "none",
      "color": "#d6d6d6",
      "textAlign": "center",
      "textDecoration": "none",
      "maxWidth": "100%",
      "minWidth": "auto",
      "opacity": 1,
      "width": "auto"
    },
    "tileStyles": {
      "mainTextColor": "#ffffff",
      "mainTextFontSize": "14px",
      "mainTextFontWeight": 600,
      "secondaryTextColor": "#adadad",
      "secondaryTextFontSize": "12px",
      "listRowGap": "12px"
    }
  }
}

Shared token categories

Shared tokens define reusable visual values across supported authentication controls, helping you keep colors, typography, and other styling consistent. In your JSON, group overrides under the categories below and include only the properties you want to change. See Appendix 2 for properties and examples.

CategoryWhat it changesReference
Brand ramp (themeColorRamp)The complete palette used to generate semantic brand colors.Fluent Theme Designer
Color overrides (themeColorOverrides)Individual semantic brand or neutral colors after the ramp is resolved, including hover and pressed treatments.Fluent colors
Colors (colorStyles)Surface, text, border, status, and supported state colors.Color tokens
Typography (typographyStyles)Font families, sizes, weights, and line heights.Typography
Spacing (spacingStyles)Shared horizontal and vertical spacing.Spacing
Borders (borderStyles)Corner radii and stroke widths.Radii and stroke widths
Shadows (shadowStyles)Elevation and branded shadows.Shadows
Animation (animationStyles)Supported durations and easing.Design tokens

Component-specific options

Use component-specific categories when a change should target a particular area rather than a shared Fluent token. A property affects the relevant component only where that component is present in the selected layout and authentication journey.

CategoriesConfiguration area
backgroundStyles, signInContainerStylesBackground-layer appearance and sign-in-container dimensions, logo placement, background, shape, and padding.
headerStyles, footerStylesHeader and footer appearance, dimensions, and spacing.
inputStylesInput appearance, floating labels, validation-text size, spacing, and transitions.
primaryButtonStyles, secondaryButtonStyles, subtleButtonStylesAppearance and dimensions of each button type.
buttonContainerStylesButton-group direction, alignment, wrapping, and gaps.
linkStyles, paragraphStyles, titleStylesVisual properties for the corresponding text areas.
slotSubHeadingStyles, slotFormStylesAppearance of supported custom HTML content slots.
tileStylesTile text colors, sizes, weights, and row spacing.
fontFaceStylesRegistration of supported custom font files.

Defaults and custom fonts

Omitted standard Fluent tokens retain the selected mode's defaults. Include only the values you intend to change. Uploading every default makes those values explicit overrides and can prevent later Fluent default improvements from taking effect.

Custom fonts require supported HTTPS-hosted font sources on custom-domain surfaces. Register the font with fontFaceStyles, then select its family in typographyStyles, for example with fontFamilyBase. Registering a font doesn't select it, and specifying a family name doesn't load a font file.

The styling appendices cover color-ramp behavior, shared Fluent tokens, and component-specific properties. For the underlying design model, see Fluent UI React theming. Tokens in a newer Fluent catalog aren't necessarily supported by External ID.

Light and dark configuration

lightTheme and darkTheme are independent, with no inheritance between them. Add shared properties to both, but adapt colors and images to each mode rather than copying the light configuration unchanged.

Check text contrast, keyboard focus, hover, pressed and disabled states, and validation messages in both modes. Validate the rendered result, not just the ramp: explicit color overrides can replace ramp-derived colors.

Configure Advanced styling in the admin center

  1. Open your branding theme's Styling settings and select Advanced under Styling method.
  2. Edit the design-token JSON directly in the editor, or select Upload to use a JSON file. You can also download the JSON template to get started or use Download to keep a copy for offline editing.
  3. Add or update the properties you need under lightTheme and darkTheme. Remove an override property to use its default or ramp-derived value instead. The default JSON includes ramps generated from your Basic styling brand colors; preserve those ramps and any existing settings you still need. Use Appendix 2 for shared tokens and Appendix 3 for component-specific properties.
  4. Select Save to save your JSON edits, then Apply to apply the styling changes. Preview and validate the authentication experience in both modes.

:::image type="content" source="customers/media/modern-ux-customization/ignite-advanced-styling.png" alt-text="Screenshot of Advanced styling with a design-token editor and upload and download controls for styling configuration." lightbox="customers/media/modern-ux-customization/ignite-advanced-styling.png":::

Preview availability and configuration

Basic and Advanced styling are scheduled to become available in preview on December 7, 2026. Styling is part of the modern Fluent experience for application branding themes in external tenants with the preview enabled. For theme creation and application assignment, see Customize branding themes.

Programmatic styling is configured through the theme localization's designTokens stream in Microsoft Graph. A configuration applies to the selected theme and language; it doesn't automatically update another theme or localization. See the Microsoft Graph theme localization reference.

Appendices

ReferenceContents
Appendix 1: Color ramps and semantic mappingsHow ramp values map to light- and dark-mode colors, override behavior, and programmatic requirements.
Appendix 2: Shared Fluent token referenceBrand palettes, colors, typography, spacing, borders, shadows, and animation.
Appendix 3: Component-specific styling referenceCustom fonts and properties for page areas, controls, text, and content slots.

Expand categories in Appendices 2 and 3 for properties and example values. Each example omits the outer theme container; copy only needed overrides under lightTheme, darkTheme, or both in your existing designTokens configuration.

Examples illustrate JSON format, not a complete theme, guaranteed defaults, or accessibility compliance. Preserve other settings and validate your application's layouts and journeys.

Appendix 1: Color ramps and semantic mappings

Each color in the ramp is called a stop. Fluent assigns these colors to named settings, called semantic tokens, for backgrounds (colorBrandBackground), links (colorBrandForegroundLink), and borders (colorBrandStroke1). Other tokens set colors for states such as hover (colorBrandBackgroundHover).

The table shows these assignments for all 16 stops. Several tokens can share a stop, and the same token can use different stops in light and dark modes. Not every authentication page uses every token.


Semantic color mappings for all 16 ramp values
Ramp valueLight-mode semantic tokensDark-mode semantic tokens
10No semantic color mapping in this mode.colorBrandBackground2Pressed
20No semantic color mapping in this mode.colorBrandBackground2
30colorBrandForeground2PressedcolorBrandStroke2Pressed
40colorBrandForegroundLinkPressed, colorBrandBackgroundPressed, colorBrandBackground4StaticcolorBrandBackgroundPressed, colorBrandBackground2Hover, colorBrandBackground4Static
50colorBrandForegroundOnLightPressedcolorBrandForegroundOnLightPressed, colorBrandStroke2, colorBrandStroke2Hover, colorBrandStroke2Contrast
60colorBrandForegroundLinkHover, colorCompoundBrandForeground1Pressed, colorBrandForeground2Hover, colorBrandForegroundOnLightSelected, colorBrandBackgroundSelected, colorCompoundBrandBackgroundPressed, colorBrandBackground3Static, colorCompoundBrandStrokePressedcolorBrandForegroundInvertedPressed, colorBrandForegroundOnLightSelected, colorBrandBackgroundSelected, colorBrandBackground3Static
70colorNeutralForeground2BrandPressed, colorNeutralForeground3BrandPressed, colorBrandForegroundLink, colorBrandForegroundLinkSelected, colorCompoundBrandForeground1Hover, colorBrandForeground2, colorBrandForegroundOnLightHover, colorBrandBackgroundHover, colorCompoundBrandBackgroundHover, colorCompoundBrandStrokeHovercolorBrandForegroundInvertedHover, colorBrandForegroundOnLightHover, colorBrandBackground
80colorNeutralForeground2BrandHover, colorNeutralForeground2BrandSelected, colorNeutralForeground3BrandHover, colorNeutralForeground3BrandSelected, colorCompoundBrandForeground1, colorBrandForeground1, colorBrandForegroundOnLight, colorBrandBackground, colorCompoundBrandBackground, colorBrandBackgroundStatic, colorNeutralStrokeAccessibleSelected, colorBrandStroke1, colorBrandStroke2Pressed, colorCompoundBrandStrokecolorBrandForegroundInverted, colorBrandForegroundOnLight, colorBrandBackgroundHover, colorBrandBackgroundStatic
90No semantic color mapping in this mode.colorNeutralForeground2BrandPressed, colorNeutralForeground3BrandPressed, colorBrandForegroundLinkPressed, colorCompoundBrandForeground1Pressed, colorCompoundBrandBackgroundPressed, colorCompoundBrandStrokePressed
100colorBrandForegroundInverted, colorBrandForegroundInvertedPressedcolorNeutralForeground2BrandHover, colorNeutralForeground2BrandSelected, colorNeutralForeground3BrandHover, colorNeutralForeground3BrandSelected, colorBrandForegroundLink, colorBrandForegroundLinkSelected, colorCompoundBrandForeground1, colorBrandForeground1, colorCompoundBrandBackground, colorNeutralStrokeAccessibleSelected, colorBrandStroke1, colorCompoundBrandStroke
110colorBrandForegroundInvertedHovercolorBrandForegroundLinkHover, colorCompoundBrandForeground1Hover, colorBrandForeground2, colorCompoundBrandBackgroundHover, colorCompoundBrandStrokeHover
120colorBrandStroke2HoverNo semantic color mapping in this mode.
130colorBrandBackground2PressedcolorBrandForeground2Hover
140colorBrandBackgroundInvertedPressed, colorBrandStroke2, colorBrandStroke2ContrastcolorBrandBackgroundInvertedPressed
150colorBrandBackground2Hover, colorBrandBackgroundInvertedSelectedcolorBrandBackgroundInvertedSelected
160colorBrandBackground2, colorBrandBackgroundInvertedHovercolorBrandForeground2Pressed, colorBrandBackgroundInvertedHover

Ramp behavior and configuration

Ramp changes affect only parts of built-in controls that use these tokens. An input's branded underline and keyboard focus outline are separate, as are a checkbox's indicator and label.

The ramp doesn't change neutral body or title text, page or sign-in-card backgrounds, logos, images, error or success colors, or normal secondary- and subtle-button backgrounds. Customize these separately with supported Advanced styling properties. Disabled controls and high-contrast mode can use neutral or system colors.

Settings in themeColorOverrides, colorStyles, or component-specific categories can override ramp colors. If a color doesn't change, check for overrides and whether that part of the page uses a brand token.

The admin center generates a ramp from your brand color. Programmatic configuration requires all 16 themeColorRamp values, including stops unused in that mode; the service doesn't generate missing stops from one color.

Appendix 2: Shared Fluent token reference

Shared tokens define visual values used across supported Fluent controls. Expand a category for its complete property example; omitted standard tokens retain the selected mode's defaults.

themeColorRamp

A complete brand palette, with stops from 10 through 160. Fluent uses these values to derive semantic brand colors; see Color-ramp behavior and semantic mappings.

Reference: Fluent Theme Designer and theme colors.


Properties and example values
{
  "themeColorRamp": {
    "10": "#020305",
    "20": "#111723",
    "30": "#17243A",
    "40": "#1B3150",
    "50": "#1E3F66",
    "60": "#1F4D7A",
    "70": "#1B5A8F",
    "80": "#1267A3",
    "90": "#0075B8",
    "100": "#0F82C5",
    "110": "#2B8FD0",
    "120": "#479CDA",
    "130": "#62A9E3",
    "140": "#7EB6EB",
    "150": "#9AC3F2",
    "160": "#B6D0F8"
  }
}

themeColorOverrides

Individual semantic color overrides applied after the brand ramp is resolved. Names identify visual roles and states such as hover, pressed, selected, disabled, or inverted.

Reference: Fluent theme colors.


Properties and example values
{
  "themeColorOverrides": {
    "colorNeutralForeground1": "#242424",
    "colorNeutralForeground1Hover": "#242424",
    "colorNeutralForeground1Pressed": "#242424",
    "colorNeutralForeground1Selected": "#242424",
    "colorNeutralForeground2": "#424242",
    "colorNeutralForeground2Hover": "#242424",
    "colorNeutralForeground2Pressed": "#242424",
    "colorNeutralForeground2Selected": "#242424",
    "colorNeutralForeground2BrandHover": "#0f6cbd",
    "colorNeutralForeground2BrandPressed": "#115ea3",
    "colorNeutralForeground2BrandSelected": "#0f6cbd",
    "colorNeutralForeground3": "#616161",
    "colorNeutralForeground3Hover": "#424242",
    "colorNeutralForeground3Pressed": "#424242",
    "colorNeutralForeground3Selected": "#424242",
    "colorNeutralForeground3BrandHover": "#0f6cbd",
    "colorNeutralForeground3BrandPressed": "#115ea3",
    "colorNeutralForeground3BrandSelected": "#0f6cbd",
    "colorNeutralForeground4": "#707070",
    "colorNeutralForegroundDisabled": "#bdbdbd",
    "colorNeutralForegroundInvertedDisabled": "rgba(255, 255, 255, 0.4)",
    "colorBrandForegroundLink": "#115ea3",
    "colorBrandForegroundLinkHover": "#0f548c",
    "colorBrandForegroundLinkPressed": "#0c3b5e",
    "colorBrandForegroundLinkSelected": "#115ea3",
    "colorNeutralForeground2Link": "#424242",
    "colorNeutralForeground2LinkHover": "#242424",
    "colorNeutralForeground2LinkPressed": "#242424",
    "colorNeutralForeground2LinkSelected": "#242424",
    "colorCompoundBrandForeground1": "#0f6cbd",
    "colorCompoundBrandForeground1Hover": "#115ea3",
    "colorCompoundBrandForeground1Pressed": "#0f548c",
    "colorBrandForeground1": "#0f6cbd",
    "colorBrandForeground2": "#115ea3",
    "colorBrandForeground2Hover": "#0f548c",
    "colorBrandForeground2Pressed": "#0a2e4a",
    "colorNeutralForeground1Static": "#242424",
    "colorNeutralForegroundStaticInverted": "#ffffff",
    "colorNeutralForegroundInverted": "#ffffff",
    "colorNeutralForegroundInvertedHover": "#ffffff",
    "colorNeutralForegroundInvertedPressed": "#ffffff",
    "colorNeutralForegroundInvertedSelected": "#ffffff",
    "colorNeutralForegroundInverted2": "#ffffff",
    "colorNeutralForegroundOnBrand": "#ffffff",
    "colorNeutralForegroundInvertedLink": "#ffffff",
    "colorNeutralForegroundInvertedLinkHover": "#ffffff",
    "colorNeutralForegroundInvertedLinkPressed": "#ffffff",
    "colorNeutralForegroundInvertedLinkSelected": "#ffffff",
    "colorBrandForegroundInverted": "#479ef5",
    "colorBrandForegroundInvertedHover": "#62abf5",
    "colorBrandForegroundInvertedPressed": "#479ef5",
    "colorBrandForegroundOnLight": "#0f6cbd",
    "colorBrandForegroundOnLightHover": "#115ea3",
    "colorBrandForegroundOnLightPressed": "#0e4775",
    "colorBrandForegroundOnLightSelected": "#0f548c",
    "colorNeutralBackground1": "#ffffff",
    "colorNeutralBackground1Hover": "#f5f5f5",
    "colorNeutralBackground1Pressed": "#e0e0e0",
    "colorNeutralBackground1Selected": "#ebebeb",
    "colorNeutralBackground2": "#fafafa",
    "colorNeutralBackground2Hover": "#f0f0f0",
    "colorNeutralBackground2Pressed": "#dbdbdb",
    "colorNeutralBackground2Selected": "#e6e6e6",
    "colorNeutralBackground3": "#f5f5f5",
    "colorNeutralBackground3Hover": "#ebebeb",
    "colorNeutralBackground3Pressed": "#d6d6d6",
    "colorNeutralBackground3Selected": "#e0e0e0",
    "colorNeutralBackground4": "#f0f0f0",
    "colorNeutralBackground4Hover": "#fafafa",
    "colorNeutralBackground4Pressed": "#f5f5f5",
    "colorNeutralBackground4Selected": "#ffffff",
    "colorNeutralBackground5": "#ebebeb",
    "colorNeutralBackground5Hover": "#f5f5f5",
    "colorNeutralBackground5Pressed": "#f0f0f0",
    "colorNeutralBackground5Selected": "#fafafa",
    "colorNeutralBackground6": "#e6e6e6",
    "colorNeutralBackgroundInverted": "#292929",
    "colorNeutralBackgroundStatic": "#333333",
    "colorNeutralBackgroundAlpha": "rgba(255, 255, 255, 0.5)",
    "colorNeutralBackgroundAlpha2": "rgba(255, 255, 255, 0.8)",
    "colorSubtleBackground": "transparent",
    "colorSubtleBackgroundHover": "#f5f5f5",
    "colorSubtleBackgroundPressed": "#e0e0e0",
    "colorSubtleBackgroundSelected": "#ebebeb",
    "colorSubtleBackgroundLightAlphaHover": "rgba(255, 255, 255, 0.7)",
    "colorSubtleBackgroundLightAlphaPressed": "rgba(255, 255, 255, 0.5)",
    "colorSubtleBackgroundLightAlphaSelected": "transparent",
    "colorSubtleBackgroundInverted": "transparent",
    "colorSubtleBackgroundInvertedHover": "rgba(0, 0, 0, 0.1)",
    "colorSubtleBackgroundInvertedPressed": "rgba(0, 0, 0, 0.3)",
    "colorSubtleBackgroundInvertedSelected": "rgba(0, 0, 0, 0.2)",
    "colorTransparentBackground": "transparent",
    "colorTransparentBackgroundHover": "transparent",
    "colorTransparentBackgroundPressed": "transparent",
    "colorTransparentBackgroundSelected": "transparent",
    "colorNeutralBackgroundDisabled": "#f0f0f0",
    "colorNeutralBackgroundInvertedDisabled": "rgba(255, 255, 255, 0.1)",
    "colorNeutralStencil1": "#e6e6e6",
    "colorNeutralStencil2": "#fafafa",
    "colorNeutralStencil1Alpha": "rgba(0, 0, 0, 0.1)",
    "colorNeutralStencil2Alpha": "rgba(0, 0, 0, 0.05)",
    "colorBackgroundOverlay": "rgba(0, 0, 0, 0.4)",
    "colorScrollbarOverlay": "rgba(0, 0, 0, 0.5)",
    "colorBrandBackground": "#0f6cbd",
    "colorBrandBackgroundHover": "#115ea3",
    "colorBrandBackgroundPressed": "#0c3b5e",
    "colorBrandBackgroundSelected": "#0f548c",
    "colorCompoundBrandBackground": "#0f6cbd",
    "colorCompoundBrandBackgroundHover": "#115ea3",
    "colorCompoundBrandBackgroundPressed": "#0f548c",
    "colorBrandBackgroundStatic": "#0f6cbd",
    "colorBrandBackground2": "#ebf3fc",
    "colorBrandBackground2Hover": "#cfe4fa",
    "colorBrandBackground2Pressed": "#96c6fa",
    "colorBrandBackground3Static": "#0f548c",
    "colorBrandBackground4Static": "#0c3b5e",
    "colorBrandBackgroundInverted": "#ffffff",
    "colorBrandBackgroundInvertedHover": "#ebf3fc",
    "colorBrandBackgroundInvertedPressed": "#b4d6fa",
    "colorBrandBackgroundInvertedSelected": "#cfe4fa",
    "colorNeutralCardBackground": "#fafafa",
    "colorNeutralCardBackgroundHover": "#ffffff",
    "colorNeutralCardBackgroundPressed": "#f5f5f5",
    "colorNeutralCardBackgroundSelected": "#ebebeb",
    "colorNeutralCardBackgroundDisabled": "#f0f0f0",
    "colorNeutralStrokeAccessible": "#616161",
    "colorNeutralStrokeAccessibleHover": "#575757",
    "colorNeutralStrokeAccessiblePressed": "#4d4d4d",
    "colorNeutralStrokeAccessibleSelected": "#0f6cbd",
    "colorNeutralStroke1": "#d1d1d1",
    "colorNeutralStroke1Hover": "#c7c7c7",
    "colorNeutralStroke1Pressed": "#b3b3b3",
    "colorNeutralStroke1Selected": "#bdbdbd",
    "colorNeutralStroke2": "#e0e0e0",
    "colorNeutralStroke3": "#f0f0f0",
    "colorNeutralStrokeSubtle": "#e0e0e0",
    "colorNeutralStrokeOnBrand": "#ffffff",
    "colorNeutralStrokeOnBrand2": "#ffffff",
    "colorNeutralStrokeOnBrand2Hover": "#ffffff",
    "colorNeutralStrokeOnBrand2Pressed": "#ffffff",
    "colorNeutralStrokeOnBrand2Selected": "#ffffff",
    "colorBrandStroke1": "#0f6cbd",
    "colorBrandStroke2": "#b4d6fa",
    "colorBrandStroke2Hover": "#77b7f7",
    "colorBrandStroke2Pressed": "#0f6cbd",
    "colorBrandStroke2Contrast": "#b4d6fa",
    "colorCompoundBrandStroke": "#0f6cbd",
    "colorCompoundBrandStrokeHover": "#115ea3",
    "colorCompoundBrandStrokePressed": "#0f548c",
    "colorNeutralStrokeDisabled": "#e0e0e0",
    "colorNeutralStrokeInvertedDisabled": "rgba(255, 255, 255, 0.4)",
    "colorTransparentStroke": "transparent",
    "colorTransparentStrokeInteractive": "transparent",
    "colorTransparentStrokeDisabled": "transparent",
    "colorNeutralStrokeAlpha": "rgba(0, 0, 0, 0.05)",
    "colorNeutralStrokeAlpha2": "rgba(255, 255, 255, 0.2)",
    "colorStrokeFocus1": "#ffffff",
    "colorStrokeFocus2": "#000000",
    "colorNeutralShadowAmbient": "rgba(0,0,0,0.12)",
    "colorNeutralShadowKey": "rgba(0,0,0,0.14)",
    "colorNeutralShadowAmbientLighter": "rgba(0,0,0,0.06)",
    "colorNeutralShadowKeyLighter": "rgba(0,0,0,0.07)",
    "colorNeutralShadowAmbientDarker": "rgba(0,0,0,0.20)",
    "colorNeutralShadowKeyDarker": "rgba(0,0,0,0.24)",
    "colorBrandShadowAmbient": "rgba(0,0,0,0.30)",
    "colorBrandShadowKey": "rgba(0,0,0,0.25)"
  }
}

colorStyles

Semantic, neutral, brand, palette, and status colors. A value affects elements that use that color role; validate foreground and background combinations together.

Reference: Fluent theme colors.


Properties and example values
{
  "colorStyles": {
    "colorNeutralForeground1": "#242424",
    "colorNeutralForeground1Hover": "#242424",
    "colorNeutralForeground1Pressed": "#242424",
    "colorNeutralForeground1Selected": "#242424",
    "colorNeutralForeground2": "#424242",
    "colorNeutralForeground2Hover": "#242424",
    "colorNeutralForeground2Pressed": "#242424",
    "colorNeutralForeground2Selected": "#242424",
    "colorNeutralForeground2BrandHover": "#0f6cbd",
    "colorNeutralForeground2BrandPressed": "#115ea3",
    "colorNeutralForeground2BrandSelected": "#0f6cbd",
    "colorNeutralForeground3": "#616161",
    "colorNeutralForeground3Hover": "#424242",
    "colorNeutralForeground3Pressed": "#424242",
    "colorNeutralForeground3Selected": "#424242",
    "colorNeutralForeground3BrandHover": "#0f6cbd",
    "colorNeutralForeground3BrandPressed": "#115ea3",
    "colorNeutralForeground3BrandSelected": "#0f6cbd",
    "colorNeutralForeground4": "#707070",
    "colorNeutralForegroundDisabled": "#bdbdbd",
    "colorNeutralForegroundInvertedDisabled": "rgba(255, 255, 255, 0.4)",
    "colorBrandForegroundLink": "#115ea3",
    "colorBrandForegroundLinkHover": "#0f548c",
    "colorBrandForegroundLinkPressed": "#0c3b5e",
    "colorBrandForegroundLinkSelected": "#115ea3",
    "colorNeutralForeground2Link": "#424242",
    "colorNeutralForeground2LinkHover": "#242424",
    "colorNeutralForeground2LinkPressed": "#242424",
    "colorNeutralForeground2LinkSelected": "#242424",
    "colorCompoundBrandForeground1": "#0f6cbd",
    "colorCompoundBrandForeground1Hover": "#115ea3",
    "colorCompoundBrandForeground1Pressed": "#0f548c",
    "colorBrandForeground1": "#0f6cbd",
    "colorBrandForeground2": "#115ea3",
    "colorBrandForeground2Hover": "#0f548c",
    "colorBrandForeground2Pressed": "#0a2e4a",
    "colorNeutralForeground1Static": "#242424",
    "colorNeutralForegroundStaticInverted": "#ffffff",
    "colorNeutralForegroundInverted": "#ffffff",
    "colorNeutralForegroundInvertedHover": "#ffffff",
    "colorNeutralForegroundInvertedPressed": "#ffffff",
    "colorNeutralForegroundInvertedSelected": "#ffffff",
    "colorNeutralForegroundInverted2": "#ffffff",
    "colorNeutralForegroundOnBrand": "#ffffff",
    "colorNeutralForegroundInvertedLink": "#ffffff",
    "colorNeutralForegroundInvertedLinkHover": "#ffffff",
    "colorNeutralForegroundInvertedLinkPressed": "#ffffff",
    "colorNeutralForegroundInvertedLinkSelected": "#ffffff",
    "colorBrandForegroundInverted": "#479ef5",
    "colorBrandForegroundInvertedHover": "#62abf5",
    "colorBrandForegroundInvertedPressed": "#479ef5",
    "colorBrandForegroundOnLight": "#0f6cbd",
    "colorBrandForegroundOnLightHover": "#115ea3",
    "colorBrandForegroundOnLightPressed": "#0e4775",
    "colorBrandForegroundOnLightSelected": "#0f548c",
    "colorNeutralBackground1": "#ffffff",
    "colorNeutralBackground1Hover": "#f5f5f5",
    "colorNeutralBackground1Pressed": "#e0e0e0",
    "colorNeutralBackground1Selected": "#ebebeb",
    "colorNeutralBackground2": "#fafafa",
    "colorNeutralBackground2Hover": "#f0f0f0",
    "colorNeutralBackground2Pressed": "#dbdbdb",
    "colorNeutralBackground2Selected": "#e6e6e6",
    "colorNeutralBackground3": "#f5f5f5",
    "colorNeutralBackground3Hover": "#ebebeb",
    "colorNeutralBackground3Pressed": "#d6d6d6",
    "colorNeutralBackground3Selected": "#e0e0e0",
    "colorNeutralBackground4": "#f0f0f0",
    "colorNeutralBackground4Hover": "#fafafa",
    "colorNeutralBackground4Pressed": "#f5f5f5",
    "colorNeutralBackground4Selected": "#ffffff",
    "colorNeutralBackground5": "#ebebeb",
    "colorNeutralBackground5Hover": "#f5f5f5",
    "colorNeutralBackground5Pressed": "#f0f0f0",
    "colorNeutralBackground5Selected": "#fafafa",
    "colorNeutralBackground6": "#e6e6e6",
    "colorNeutralBackgroundInverted": "#292929",
    "colorNeutralBackgroundStatic": "#333333",
    "colorNeutralBackgroundAlpha": "rgba(255, 255, 255, 0.5)",
    "colorNeutralBackgroundAlpha2": "rgba(255, 255, 255, 0.8)",
    "colorSubtleBackground": "transparent",
    "colorSubtleBackgroundHover": "#f5f5f5",
    "colorSubtleBackgroundPressed": "#e0e0e0",
    "colorSubtleBackgroundSelected": "#ebebeb",
    "colorSubtleBackgroundLightAlphaHover": "rgba(255, 255, 255, 0.7)",
    "colorSubtleBackgroundLightAlphaPressed": "rgba(255, 255, 255, 0.5)",
    "colorSubtleBackgroundLightAlphaSelected": "transparent",
    "colorSubtleBackgroundInverted": "transparent",
    "colorSubtleBackgroundInvertedHover": "rgba(0, 0, 0, 0.1)",
    "colorSubtleBackgroundInvertedPressed": "rgba(0, 0, 0, 0.3)",
    "colorSubtleBackgroundInvertedSelected": "rgba(0, 0, 0, 0.2)",
    "colorTransparentBackground": "transparent",
    "colorTransparentBackgroundHover": "transparent",
    "colorTransparentBackgroundPressed": "transparent",
    "colorTransparentBackgroundSelected": "transparent",
    "colorNeutralBackgroundDisabled": "#f0f0f0",
    "colorNeutralBackgroundInvertedDisabled": "rgba(255, 255, 255, 0.1)",
    "colorNeutralStencil1": "#e6e6e6",
    "colorNeutralStencil2": "#fafafa",
    "colorNeutralStencil1Alpha": "rgba(0, 0, 0, 0.1)",
    "colorNeutralStencil2Alpha": "rgba(0, 0, 0, 0.05)",
    "colorBackgroundOverlay": "rgba(0, 0, 0, 0.4)",
    "colorScrollbarOverlay": "rgba(0, 0, 0, 0.5)",
    "colorBrandBackground": "#0f6cbd",
    "colorBrandBackgroundHover": "#115ea3",
    "colorBrandBackgroundPressed": "#0c3b5e",
    "colorBrandBackgroundSelected": "#0f548c",
    "colorCompoundBrandBackground": "#0f6cbd",
    "colorCompoundBrandBackgroundHover": "#115ea3",
    "colorCompoundBrandBackgroundPressed": "#0f548c",
    "colorBrandBackgroundStatic": "#0f6cbd",
    "colorBrandBackground2": "#ebf3fc",
    "colorBrandBackground2Hover": "#cfe4fa",
    "colorBrandBackground2Pressed": "#96c6fa",
    "colorBrandBackground3Static": "#0f548c",
    "colorBrandBackground4Static": "#0c3b5e",
    "colorBrandBackgroundInverted": "#ffffff",
    "colorBrandBackgroundInvertedHover": "#ebf3fc",
    "colorBrandBackgroundInvertedPressed": "#b4d6fa",
    "colorBrandBackgroundInvertedSelected": "#cfe4fa",
    "colorNeutralCardBackground": "#fafafa",
    "colorNeutralCardBackgroundHover": "#ffffff",
    "colorNeutralCardBackgroundPressed": "#f5f5f5",
    "colorNeutralCardBackgroundSelected": "#ebebeb",
    "colorNeutralCardBackgroundDisabled": "#f0f0f0",
    "colorNeutralStrokeAccessible": "#616161",
    "colorNeutralStrokeAccessibleHover": "#575757",
    "colorNeutralStrokeAccessiblePressed": "#4d4d4d",
    "colorNeutralStrokeAccessibleSelected": "#0f6cbd",
    "colorNeutralStroke1": "#d1d1d1",
    "colorNeutralStroke1Hover": "#c7c7c7",
    "colorNeutralStroke1Pressed": "#b3b3b3",
    "colorNeutralStroke1Selected": "#bdbdbd",
    "colorNeutralStroke2": "#e0e0e0",
    "colorNeutralStroke3": "#f0f0f0",
    "colorNeutralStrokeSubtle": "#e0e0e0",
    "colorNeutralStrokeOnBrand": "#ffffff",
    "colorNeutralStrokeOnBrand2": "#ffffff",
    "colorNeutralStrokeOnBrand2Hover": "#ffffff",
    "colorNeutralStrokeOnBrand2Pressed": "#ffffff",
    "colorNeutralStrokeOnBrand2Selected": "#ffffff",
    "colorBrandStroke1": "#0f6cbd",
    "colorBrandStroke2": "#b4d6fa",
    "colorBrandStroke2Hover": "#77b7f7",
    "colorBrandStroke2Pressed": "#0f6cbd",
    "colorBrandStroke2Contrast": "#b4d6fa",
    "colorCompoundBrandStroke": "#0f6cbd",
    "colorCompoundBrandStrokeHover": "#115ea3",
    "colorCompoundBrandStrokePressed": "#0f548c",
    "colorNeutralStrokeDisabled": "#e0e0e0",
    "colorNeutralStrokeInvertedDisabled": "rgba(255, 255, 255, 0.4)",
    "colorTransparentStroke": "transparent",
    "colorTransparentStrokeInteractive": "transparent",
    "colorTransparentStrokeDisabled": "transparent",
    "colorNeutralStrokeAlpha": "rgba(0, 0, 0, 0.05)",
    "colorNeutralStrokeAlpha2": "rgba(255, 255, 255, 0.2)",
    "colorStrokeFocus1": "#ffffff",
    "colorStrokeFocus2": "#000000",
    "colorNeutralShadowAmbient": "rgba(0,0,0,0.12)",
    "colorNeutralShadowKey": "rgba(0,0,0,0.14)",
    "colorNeutralShadowAmbientLighter": "rgba(0,0,0,0.06)",
    "colorNeutralShadowKeyLighter": "rgba(0,0,0,0.07)",
    "colorNeutralShadowAmbientDarker": "rgba(0,0,0,0.20)",
    "colorNeutralShadowKeyDarker": "rgba(0,0,0,0.24)",
    "colorBrandShadowAmbient": "rgba(0,0,0,0.30)",
    "colorBrandShadowKey": "rgba(0,0,0,0.25)",
    "colorPaletteRedBackground1": "#fdf6f6",
    "colorPaletteRedBackground2": "#f1bbbc",
    "colorPaletteRedBackground3": "#d13438",
    "colorPaletteRedForeground1": "#bc2f32",
    "colorPaletteRedForeground2": "#751d1f",
    "colorPaletteRedForeground3": "#d13438",
    "colorPaletteRedBorderActive": "#d13438",
    "colorPaletteRedBorder1": "#f1bbbc",
    "colorPaletteRedBorder2": "#d13438",
    "colorPaletteGreenBackground1": "#f1faf1",
    "colorPaletteGreenBackground2": "#9fd89f",
    "colorPaletteGreenBackground3": "#107c10",
    "colorPaletteGreenForeground1": "#0e700e",
    "colorPaletteGreenForeground2": "#094509",
    "colorPaletteGreenForeground3": "#107c10",
    "colorPaletteGreenBorderActive": "#107c10",
    "colorPaletteGreenBorder1": "#9fd89f",
    "colorPaletteGreenBorder2": "#107c10",
    "colorPaletteDarkOrangeBackground1": "#fdf6f3",
    "colorPaletteDarkOrangeBackground2": "#f4bfab",
    "colorPaletteDarkOrangeBackground3": "#da3b01",
    "colorPaletteDarkOrangeForeground1": "#c43501",
    "colorPaletteDarkOrangeForeground2": "#7a2101",
    "colorPaletteDarkOrangeForeground3": "#da3b01",
    "colorPaletteDarkOrangeBorderActive": "#da3b01",
    "colorPaletteDarkOrangeBorder1": "#f4bfab",
    "colorPaletteDarkOrangeBorder2": "#da3b01",
    "colorPaletteYellowBackground1": "#fffef5",
    "colorPaletteYellowBackground2": "#fef7b2",
    "colorPaletteYellowBackground3": "#fde300",
    "colorPaletteYellowForeground1": "#817400",
    "colorPaletteYellowForeground2": "#817400",
    "colorPaletteYellowForeground3": "#fde300",
    "colorPaletteYellowBorderActive": "#fde300",
    "colorPaletteYellowBorder1": "#fef7b2",
    "colorPaletteYellowBorder2": "#fde300",
    "colorPaletteBerryBackground1": "#fdf5fc",
    "colorPaletteBerryBackground2": "#edbbe7",
    "colorPaletteBerryBackground3": "#c239b3",
    "colorPaletteBerryForeground1": "#af33a1",
    "colorPaletteBerryForeground2": "#6d2064",
    "colorPaletteBerryForeground3": "#c239b3",
    "colorPaletteBerryBorderActive": "#c239b3",
    "colorPaletteBerryBorder1": "#edbbe7",
    "colorPaletteBerryBorder2": "#c239b3",
    "colorPaletteLightGreenBackground1": "#f2fbf2",
    "colorPaletteLightGreenBackground2": "#a7e3a5",
    "colorPaletteLightGreenBackground3": "#13a10e",
    "colorPaletteLightGreenForeground1": "#11910d",
    "colorPaletteLightGreenForeground2": "#0b5a08",
    "colorPaletteLightGreenForeground3": "#13a10e",
    "colorPaletteLightGreenBorderActive": "#13a10e",
    "colorPaletteLightGreenBorder1": "#a7e3a5",
    "colorPaletteLightGreenBorder2": "#13a10e",
    "colorPaletteMarigoldBackground1": "#fefbf4",
    "colorPaletteMarigoldBackground2": "#f9e2ae",
    "colorPaletteMarigoldBackground3": "#eaa300",
    "colorPaletteMarigoldForeground1": "#d39300",
    "colorPaletteMarigoldForeground2": "#835b00",
    "colorPaletteMarigoldForeground3": "#eaa300",
    "colorPaletteMarigoldBorderActive": "#eaa300",
    "colorPaletteMarigoldBorder1": "#f9e2ae",
    "colorPaletteMarigoldBorder2": "#eaa300",
    "colorPaletteRedForegroundInverted": "#dc5e62",
    "colorPaletteGreenForegroundInverted": "#359b35",
    "colorPaletteYellowForegroundInverted": "#fef7b2",
    "colorPaletteDarkRedBackground2": "#d69ca5",
    "colorPaletteDarkRedForeground2": "#420610",
    "colorPaletteDarkRedBorderActive": "#750b1c",
    "colorPaletteCranberryBackground2": "#eeacb2",
    "colorPaletteCranberryForeground2": "#6e0811",
    "colorPaletteCranberryBorderActive": "#c50f1f",
    "colorPalettePumpkinBackground2": "#efc4ad",
    "colorPalettePumpkinForeground2": "#712d09",
    "colorPalettePumpkinBorderActive": "#ca5010",
    "colorPalettePeachBackground2": "#ffddb3",
    "colorPalettePeachForeground2": "#8f4e00",
    "colorPalettePeachBorderActive": "#ff8c00",
    "colorPaletteGoldBackground2": "#ecdfa5",
    "colorPaletteGoldForeground2": "#6c5700",
    "colorPaletteGoldBorderActive": "#c19c00",
    "colorPaletteBrassBackground2": "#e0cea2",
    "colorPaletteBrassForeground2": "#553e06",
    "colorPaletteBrassBorderActive": "#986f0b",
    "colorPaletteBrownBackground2": "#ddc3b0",
    "colorPaletteBrownForeground2": "#50301a",
    "colorPaletteBrownBorderActive": "#8e562e",
    "colorPaletteForestBackground2": "#bdd99b",
    "colorPaletteForestForeground2": "#294903",
    "colorPaletteForestBorderActive": "#498205",
    "colorPaletteSeafoamBackground2": "#a8f0cd",
    "colorPaletteSeafoamForeground2": "#00723b",
    "colorPaletteSeafoamBorderActive": "#00cc6a",
    "colorPaletteDarkGreenBackground2": "#9ad29a",
    "colorPaletteDarkGreenForeground2": "#063b06",
    "colorPaletteDarkGreenBorderActive": "#0b6a0b",
    "colorPaletteLightTealBackground2": "#a6e9ed",
    "colorPaletteLightTealForeground2": "#00666d",
    "colorPaletteLightTealBorderActive": "#00b7c3",
    "colorPaletteTealBackground2": "#9bd9db",
    "colorPaletteTealForeground2": "#02494c",
    "colorPaletteTealBorderActive": "#038387",
    "colorPaletteSteelBackground2": "#94c8d4",
    "colorPaletteSteelForeground2": "#00333f",
    "colorPaletteSteelBorderActive": "#005b70",
    "colorPaletteBlueBackground2": "#a9d3f2",
    "colorPaletteBlueForeground2": "#004377",
    "colorPaletteBlueBorderActive": "#0078d4",
    "colorPaletteRoyalBlueBackground2": "#9abfdc",
    "colorPaletteRoyalBlueForeground2": "#002c4e",
    "colorPaletteRoyalBlueBorderActive": "#004e8c",
    "colorPaletteCornflowerBackground2": "#c8d1fa",
    "colorPaletteCornflowerForeground2": "#2c3c85",
    "colorPaletteCornflowerBorderActive": "#4f6bed",
    "colorPaletteNavyBackground2": "#a3b2e8",
    "colorPaletteNavyForeground2": "#001665",
    "colorPaletteNavyBorderActive": "#0027b4",
    "colorPaletteLavenderBackground2": "#d2ccf8",
    "colorPaletteLavenderForeground2": "#3f3682",
    "colorPaletteLavenderBorderActive": "#7160e8",
    "colorPalettePurpleBackground2": "#c6b1de",
    "colorPalettePurpleForeground2": "#341a51",
    "colorPalettePurpleBorderActive": "#5c2e91",
    "colorPaletteGrapeBackground2": "#d9a7e0",
    "colorPaletteGrapeForeground2": "#4c0d55",
    "colorPaletteGrapeBorderActive": "#881798",
    "colorPaletteLilacBackground2": "#e6bfed",
    "colorPaletteLilacForeground2": "#63276d",
    "colorPaletteLilacBorderActive": "#b146c2",
    "colorPalettePinkBackground2": "#f7c0e3",
    "colorPalettePinkForeground2": "#80215d",
    "colorPalettePinkBorderActive": "#e43ba6",
    "colorPaletteMagentaBackground2": "#eca5d1",
    "colorPaletteMagentaForeground2": "#6b0043",
    "colorPaletteMagentaBorderActive": "#bf0077",
    "colorPalettePlumBackground2": "#d696c0",
    "colorPalettePlumForeground2": "#43002b",
    "colorPalettePlumBorderActive": "#77004d",
    "colorPaletteBeigeBackground2": "#d7d4d4",
    "colorPaletteBeigeForeground2": "#444241",
    "colorPaletteBeigeBorderActive": "#7a7574",
    "colorPaletteMinkBackground2": "#cecccb",
    "colorPaletteMinkForeground2": "#343231",
    "colorPaletteMinkBorderActive": "#5d5a58",
    "colorPalettePlatinumBackground2": "#cdd6d8",
    "colorPalettePlatinumForeground2": "#3b4447",
    "colorPalettePlatinumBorderActive": "#69797e",
    "colorPaletteAnchorBackground2": "#bcc3c7",
    "colorPaletteAnchorForeground2": "#202427",
    "colorPaletteAnchorBorderActive": "#394146",
    "colorStatusSuccessBackground1": "#f1faf1",
    "colorStatusSuccessBackground2": "#9fd89f",
    "colorStatusSuccessBackground3": "#107c10",
    "colorStatusSuccessForeground1": "#0e700e",
    "colorStatusSuccessForeground2": "#094509",
    "colorStatusSuccessForeground3": "#107c10",
    "colorStatusSuccessForegroundInverted": "#54b054",
    "colorStatusSuccessBorderActive": "#107c10",
    "colorStatusSuccessBorder1": "#9fd89f",
    "colorStatusSuccessBorder2": "#107c10",
    "colorStatusWarningBackground1": "#fff9f5",
    "colorStatusWarningBackground2": "#fdcfb4",
    "colorStatusWarningBackground3": "#f7630c",
    "colorStatusWarningForeground1": "#bc4b09",
    "colorStatusWarningForeground2": "#8a3707",
    "colorStatusWarningForeground3": "#bc4b09",
    "colorStatusWarningForegroundInverted": "#faa06b",
    "colorStatusWarningBorderActive": "#f7630c",
    "colorStatusWarningBorder1": "#fdcfb4",
    "colorStatusWarningBorder2": "#bc4b09",
    "colorStatusDangerBackground1": "#fdf3f4",
    "colorStatusDangerBackground2": "#eeacb2",
    "colorStatusDangerBackground3": "#c50f1f",
    "colorStatusDangerForeground1": "#b10e1c",
    "colorStatusDangerForeground2": "#6e0811",
    "colorStatusDangerForeground3": "#c50f1f",
    "colorStatusDangerForegroundInverted": "#dc626d",
    "colorStatusDangerBorderActive": "#c50f1f",
    "colorStatusDangerBorder1": "#eeacb2",
    "colorStatusDangerBorder2": "#c50f1f",
    "colorStatusDangerBackground3Hover": "#b10e1c",
    "colorStatusDangerBackground3Pressed": "#960b18"
  }
}

typographyStyles

The shared type scale: font sizes, line heights, font-family stacks, and numeric font weights. A font-family value selects a font but does not download it.

Reference: Fluent typography and font tokens.


Properties and example values
{
  "typographyStyles": {
    "fontSizeBase100": "10px",
    "fontSizeBase200": "12px",
    "fontSizeBase300": "14px",
    "fontSizeBase400": "16px",
    "fontSizeBase500": "20px",
    "fontSizeBase600": "24px",
    "fontSizeHero700": "28px",
    "fontSizeHero800": "32px",
    "fontSizeHero900": "40px",
    "fontSizeHero1000": "68px",
    "lineHeightBase100": "14px",
    "lineHeightBase200": "16px",
    "lineHeightBase300": "20px",
    "lineHeightBase400": "22px",
    "lineHeightBase500": "28px",
    "lineHeightBase600": "32px",
    "lineHeightHero700": "36px",
    "lineHeightHero800": "40px",
    "lineHeightHero900": "52px",
    "lineHeightHero1000": "92px",
    "fontFamilyBase": "'Segoe UI', 'Segoe UI Web (West European)', -apple-system, BlinkMacSystemFont, Roboto, 'Helvetica Neue', sans-serif",
    "fontFamilyMonospace": "Consolas, 'Courier New', Courier, monospace",
    "fontFamilyNumeric": "Bahnschrift, 'Segoe UI', 'Segoe UI Web (West European)', -apple-system, BlinkMacSystemFont, Roboto, 'Helvetica Neue', sans-serif",
    "fontWeightRegular": 400,
    "fontWeightMedium": 500,
    "fontWeightSemibold": 600,
    "fontWeightBold": 700
  }
}

spacingStyles

Horizontal and vertical spacing scales. Names identify direction and size, from None through XXXL; a shared spacing change can affect several components.

Reference: Fluent spacing tokens.


Properties and example values
{
  "spacingStyles": {
    "spacingHorizontalNone": "0",
    "spacingHorizontalXXS": "2px",
    "spacingHorizontalXS": "4px",
    "spacingHorizontalSNudge": "6px",
    "spacingHorizontalS": "8px",
    "spacingHorizontalMNudge": "10px",
    "spacingHorizontalM": "12px",
    "spacingHorizontalL": "16px",
    "spacingHorizontalXL": "20px",
    "spacingHorizontalXXL": "24px",
    "spacingHorizontalXXXL": "32px",
    "spacingVerticalNone": "0",
    "spacingVerticalXXS": "2px",
    "spacingVerticalXS": "4px",
    "spacingVerticalSNudge": "6px",
    "spacingVerticalS": "8px",
    "spacingVerticalMNudge": "10px",
    "spacingVerticalM": "12px",
    "spacingVerticalL": "16px",
    "spacingVerticalXL": "20px",
    "spacingVerticalXXL": "24px",
    "spacingVerticalXXXL": "32px"
  }
}

borderStyles

Shared corner-radius and stroke-width scales. Use a component-specific category when the change should apply to only one type of control.

Reference: Fluent border radii and stroke widths.


Properties and example values
{
  "borderStyles": {
    "borderRadiusNone": "0",
    "borderRadiusSmall": "2px",
    "borderRadiusMedium": "4px",
    "borderRadiusLarge": "6px",
    "borderRadiusXLarge": "8px",
    "borderRadiusCircular": "10000px",
    "strokeWidthThin": "1px",
    "strokeWidthThick": "2px",
    "strokeWidthThicker": "3px",
    "strokeWidthThickest": "4px"
  }
}

shadowStyles

Standard and brand-colored elevation shadows. The numeric suffix identifies the Fluent elevation level.

Reference: Fluent shadow tokens.


Properties and example values
{
  "shadowStyles": {
    "shadow2": "0 0 2px rgba(0,0,0,0.12), 0 1px 2px rgba(0,0,0,0.14)",
    "shadow4": "0 0 2px rgba(0,0,0,0.12), 0 2px 4px rgba(0,0,0,0.14)",
    "shadow8": "0 0 2px rgba(0,0,0,0.12), 0 4px 8px rgba(0,0,0,0.14)",
    "shadow16": "0 0 2px rgba(0,0,0,0.12), 0 8px 16px rgba(0,0,0,0.14)",
    "shadow28": "0 0 8px rgba(0,0,0,0.12), 0 14px 28px rgba(0,0,0,0.14)",
    "shadow64": "0 0 8px rgba(0,0,0,0.12), 0 32px 64px rgba(0,0,0,0.14)",
    "shadow2Brand": "0 0 2px rgba(0,0,0,0.30), 0 1px 2px rgba(0,0,0,0.25)",
    "shadow4Brand": "0 0 2px rgba(0,0,0,0.30), 0 2px 4px rgba(0,0,0,0.25)",
    "shadow8Brand": "0 0 2px rgba(0,0,0,0.30), 0 4px 8px rgba(0,0,0,0.25)",
    "shadow16Brand": "0 0 2px rgba(0,0,0,0.30), 0 8px 16px rgba(0,0,0,0.25)",
    "shadow28Brand": "0 0 8px rgba(0,0,0,0.30), 0 14px 28px rgba(0,0,0,0.25)",
    "shadow64Brand": "0 0 8px rgba(0,0,0,0.30), 0 32px 64px rgba(0,0,0,0.25)"
  }
}

animationStyles

Durations and easing curves for supported transitions. Duration values use time units; curve values describe the transition timing function.


Properties and example values
{
  "animationStyles": {
    "durationUltraFast": "50ms",
    "durationFaster": "100ms",
    "durationFast": "150ms",
    "durationNormal": "200ms",
    "durationGentle": "250ms",
    "durationSlow": "300ms",
    "durationSlower": "400ms",
    "durationUltraSlow": "500ms",
    "curveAccelerateMax": "cubic-bezier(0.9,0.1,1,0.2)",
    "curveAccelerateMid": "cubic-bezier(1,0,1,1)",
    "curveAccelerateMin": "cubic-bezier(0.8,0,0.78,1)",
    "curveDecelerateMax": "cubic-bezier(0.1,0.9,0.2,1)",
    "curveDecelerateMid": "cubic-bezier(0,0,0,1)",
    "curveDecelerateMin": "cubic-bezier(0.33,0,0.1,1)",
    "curveEasyEaseMax": "cubic-bezier(0.8,0,0.2,1)",
    "curveEasyEase": "cubic-bezier(0.33,0,0.67,1)",
    "curveLinear": "cubic-bezier(0,0,1,1)"
  }
}

Appendix 3: Component-specific styling reference

These categories configure custom fonts or target a supported page area or control. Each description remains visible; expand the category's example to view its properties and value formats.

fontFaceStyles

An array of custom font declarations. fontFamily names the font, srcUrl identifies its HTTPS resource, and the remaining properties describe its weight, style, stretch, and loading strategy. Use a supported custom-domain surface and select the registered family in typographyStyles.


Properties and example values
{
  "fontFaceStyles": [
    {
      "fontFamily": "CustomBrandFont",
      "srcUrl": "https://cdn.example.com/fonts/custom-brand-font.woff2",
      "fontWeight": "100 900",
      "fontStyle": "normal",
      "fontStretch": "normal",
      "fontDisplay": "swap"
    }
  ]
}

backgroundStyles

Background-layer settings. opacity uses a number from 0 through 1; fillColor supplies a fill color.


Properties and example values
{
  "backgroundStyles": {
    "opacity": 1,
    "fillColor": "#ffffff"
  }
}

buttonContainerStyles

Button-group layout. flexDirection sets the arrangement direction, justifyContent and alignItems set axis alignment, flexWrap controls wrapping, and the gap properties set spacing.


Properties and example values
{
  "buttonContainerStyles": {
    "flexDirection": "column",
    "justifyContent": "flex-start",
    "alignItems": "stretch",
    "columnGap": "12px",
    "rowGap": "12px",
    "flexWrap": "nowrap"
  }
}

footerStyles

Footer appearance and spacing properties. Color values describe the background and foreground; horizontal and vertical padding apply to the corresponding pair of sides.


Properties and example values
{
  "footerStyles": {
    "textAlign": "center",
    "textDecoration": "none",
    "maxWidth": "100%",
    "opacity": 1,
    "borderStyle": "none",
    "backgroundColor": "#ffffff",
    "color": "#424242",
    "paddingVertical": "12px",
    "paddingHorizontal": "12px"
  }
}

headerStyles

Header dimensions, appearance, logo settings, and padding. Use size values with units where appropriate, and a number from 0 through 1 for opacity.


Properties and example values
{
  "headerStyles": {
    "borderRadius": "0",
    "height": "48px",
    "maxWidth": "100%",
    "minWidth": "0",
    "opacity": 1,
    "logoPosition": "left",
    "logoSize": "24px",
    "logoPadding": "0",
    "backgroundColor": "transparent",
    "paddingHorizontal": "16px",
    "paddingVertical": "12px",
    "color": "#242424"
  }
}

inputStyles

Input and floating-label appearance, spacing, validation-text size, and transition settings. Placeholder colors, label margins, and transition properties can be configured independently.


Properties and example values
{
  "inputStyles": {
    "borderRadius": "4px",
    "textAlign": "left",
    "textDecoration": "none",
    "maxWidth": "100%",
    "minWidth": "0",
    "borderStyle": "solid",
    "opacity": 1,
    "lineHeight": "22px",
    "floatingPlaceholderColor": "#707070",
    "floatingPlaceholderBackgroundColor": "#ffffff",
    "disabledPlaceholderColor": "#bdbdbd",
    "floatingLabelMarginTop": "8px",
    "stackedInputMarginTop": "24px",
    "validationErrorFontSize": "12px",
    "transitionDuration": "200ms",
    "transitionTimingFunction": "cubic-bezier(0,0,0,1)"
  }
}

linkStyles

Link text-alignment and decoration properties. Use semantic color tokens when configuring link colors and their interaction states.


Properties and example values
{
  "linkStyles": {
    "textAlign": "left",
    "textDecoration": "none"
  }
}

paragraphStyles

Paragraph text-alignment, decoration, and maximum-width properties.


Properties and example values
{
  "paragraphStyles": {
    "textAlign": "left",
    "textDecoration": "none",
    "maxWidth": "100%"
  }
}

primaryButtonStyles

Primary-button appearance, alignment, dimensions, and opacity. borderSize is the button border-width property; use color for text and backgroundColor for the surface.


Properties and example values
{
  "primaryButtonStyles": {
    "alignSelf": "auto",
    "backgroundColor": "#0f6cbd",
    "borderColor": "transparent",
    "borderRadius": "4px",
    "borderSize": "1px",
    "borderStyle": "none",
    "color": "#ffffff",
    "textAlign": "center",
    "textDecoration": "none",
    "maxWidth": "100%",
    "minWidth": "auto",
    "opacity": 1,
    "width": "auto"
  }
}

secondaryButtonStyles

Secondary-button appearance, alignment, dimensions, and opacity. These values are separate from the primary-button category.


Properties and example values
{
  "secondaryButtonStyles": {
    "alignSelf": "auto",
    "backgroundColor": "#ffffff",
    "borderColor": "#d1d1d1",
    "borderRadius": "4px",
    "borderSize": "1px",
    "borderStyle": "solid",
    "color": "#242424",
    "textAlign": "center",
    "textDecoration": "none",
    "maxWidth": "100%",
    "minWidth": "auto",
    "opacity": 1,
    "width": "auto"
  }
}

signInContainerStyles

Sign-in-container dimensions, logo settings, background, border treatment, radius, and padding. Check sizing changes at narrow widths and with longer localized content.


Properties and example values
{
  "signInContainerStyles": {
    "maxWidth": "440px",
    "minWidth": "320px",
    "maxHeight": "none",
    "minHeight": "0",
    "height": "auto",
    "width": "440px",
    "borderStyle": "none",
    "opacity": 1,
    "logoPosition": "center",
    "logoSize": "36px",
    "logoPadding": "0",
    "backgroundColor": "#ffffff",
    "borderRadius": "12px",
    "padding": "40px"
  }
}

slotSubHeadingStyles

Colors, border, radius, and padding for the supported custom HTML subheading content slot. Horizontal and vertical padding apply to both sides of the corresponding axis.


Properties and example values
{
  "slotSubHeadingStyles": {
    "backgroundColor": "transparent",
    "color": "inherit",
    "borderColor": "transparent",
    "borderRadius": "0",
    "borderStyle": "none",
    "borderWidth": "0",
    "paddingHorizontal": "0",
    "paddingVertical": "0"
  }
}

slotFormStyles

Colors, border, radius, and padding for the supported custom HTML form content slot. These settings style the slot rather than changing authentication-control behavior.


Properties and example values
{
  "slotFormStyles": {
    "backgroundColor": "transparent",
    "color": "inherit",
    "borderColor": "transparent",
    "borderRadius": "0",
    "borderStyle": "none",
    "borderWidth": "0",
    "paddingHorizontal": "0",
    "paddingVertical": "0"
  }
}

subtleButtonStyles

Subtle-button appearance, alignment, dimensions, and opacity. These values are separate from the primary- and secondary-button categories.


Properties and example values
{
  "subtleButtonStyles": {
    "alignSelf": "auto",
    "backgroundColor": "transparent",
    "borderColor": "transparent",
    "borderRadius": "4px",
    "borderSize": "1px",
    "borderStyle": "none",
    "color": "#424242",
    "textAlign": "center",
    "textDecoration": "none",
    "maxWidth": "100%",
    "minWidth": "auto",
    "opacity": 1,
    "width": "auto"
  }
}

tileStyles

Primary and secondary tile text colors and sizes, primary-text weight, and the vertical gap between tile rows.


Properties and example values
{
  "tileStyles": {
    "mainTextColor": "#242424",
    "mainTextFontSize": "14px",
    "mainTextFontWeight": 600,
    "secondaryTextColor": "#616161",
    "secondaryTextFontSize": "12px",
    "listRowGap": "12px"
  }
}

titleStyles

Title text-alignment, decoration, maximum-width, and color properties.


Properties and example values
{
  "titleStyles": {
    "textAlign": "center",
    "textDecoration": "none",
    "maxWidth": "100%",
    "color": "#242424"
  }
}

Related content

Daily Entra.News

Get daily email updates

Get a concise summary of the latest Microsoft Entra updates delivered straight to your inbox.

Loading the secure signup form…