Skip to main content
The MoEngage Brand Book is a centralized brand hub that manages, stores, and distributes core brand identity assets across the MoEngage marketing platform. This tool enables brands to establish a single source of truth for their visual identity, facilitating consistent execution across multi-channel campaigns (Email, SMS, Push, Landing Pages, Pop-up messages, and In-App Messages). When you publish brand elements such as logos, colors, fonts, and buttons your changes apply instantly across all active workspaces and channels.
Each workspace is limited to one active brand book. Currently, this feature is exclusive to In-App campaigns and does not support Portfolio.

Access the Brand Book

The brand book is managed at the account level. To access it, perform the following steps:
  1. On the sidebar menu in MoEngage, point to the Settings icon Settings icon. The Settings menu expands.
  2. Click Account, and then click Brand Book. Access the Brand Book
The Brand Book is positioned as a standalone option in the navigation pane, separated from standard configuration settings.

Permissions and Access Control

The system enforces role-based access control for managing brand assets. Review your assigned permissions inside your current workspace to verify your access:
Workspace Account RoleAccess Permission LevelFunctional Details
Admin / ManagerRead, Create, and ModifyFull access to upload brand assets, change fonts, delete files, and publish your brand settings.

Create Your Brand Book

When you configure your brand book, select one of the following creation methods:

Method 1: Import Through Website URL

The platform fetches your visual identity directly from your brand’s live website. To import via website URL, perform the following steps:
  1. On the Brand Book landing page, click Create brand book. The Create brand book dialog box appears.
  2. In the Enter your brand website URL box, type or paste your web address (for example, https://www.example.com). Leading and trailing whitespace is removed automatically.
  3. Click Import.
Import Through Website URL

Method 2: Manual Setup from Scratch

If your target site is protected by corporate access firewalls, or if you prefer full manual control, define your style parameters from scratch:
  1. On the Brand Book page, click Create Brand Book. The Create brand book dialog box appears.
  2. Click Enter manually. Enter manually option
The brand book page appears, where you can configure your individual brand panels (logos, colors, fonts, and button styles).

Configure Brand Assets

The asset manager is divided into visual modules under the Brand Assets tab. You can save and publish your details one module at a time. Partial configurations are valid, and you can return to add details later.
Manage your official logos to enable selection inside campaign visual editors. To upload and manage your brand logos, perform the following steps:
  1. In the Foundation panel, click Logo Style to expand the section.
  2. Click + Add Logo on the right side of the panel. The Upload Logo dialog box opens. Logo Style
  3. To upload a local image file:
    1. Click the Upload tab.
    2. Drag and drop your logo file into the target zone, or click upload from computer to browse files. The uploader supports .ico, .png, .gif, .svg, and .jpg formats, with a maximum file size of 5 MB.
    Logo upload
  4. To import an image from a public web server:
    1. Click the URL tab.
    2. In the Add URL here (only 1 URL at a time) box, type or paste the direct image link (for example, https://www.example.com/logo.png). The URL must point directly to an image file.
    3. Click Add Logo.
    URL tab
  5. (Optional) Under the Logo Name column, click the text box to enter a custom descriptor name containing between 5 and 150 characters. Logo name field
  6. To manage your uploaded brand logos, do any of the following:
    1. To copy the direct file path: Click the Logo URL icon Logo URL icon in the row of the logo, and copy its absolute web path to your clipboard.
    2. To delete a logo: Under Actions, click the delete icon Delete icon in the row of the logo, and then click Delete in the Delete Logo confirmation dialog box.
  • You can add up to 10 logos per brand book.
  • If long file names in the Logo File column are truncated with an ellipsis (…), hover to see the full name.
Set up your brand colors to keep your designs consistent and prevent unapproved color choices. To configure your brand color palettes, perform the following steps:
  1. In the Foundation panel, click Brand Colors to expand the section.
  2. Click + Add Color on the right side of the panel. A new color row is added to the table. Brand Colors panel
  3. In the Color column, do one of the following:
    1. Click the text box to type a six-digit hex code (for example, #aa0566).
    Hex code entry
  4. Click the color preview box to open the color picker, where you can drag the pointer to select a color, or type custom values in the Hex box, or in the R (red), G (green), B (blue), and A (alpha) boxes. Duplicate hex codes are not allowed within the same palette. Color picker
  5. In the Color Name column, click the text box, and then type a unique descriptive name containing between 5 and 50 characters (for example, Primary Brand Orange). Brand color name field
  6. To remove a color from your palette, click the delete icon Delete icon in the Actions column.
You can add up to 10 colors per brand book.
Upload custom typography files and map fallbacks to maintain consistency when custom fonts cannot be displayed. To upload and configure your custom fonts, perform the following steps:
  1. In the Foundation panel, click Fonts to expand the section.
  2. Click + Add font on the right side of the panel. The Add Font wizard opens. Fonts panel
  3. In step 1 (Add font files):
    1. Drag and drop your font files into the target zone, or click upload from computer to select them. The uploader supports .ttf, .otf, .woff, and .woff2 formats, with a maximum file size of 5 MB per file.
    You can upload up to 10 font files per brand book.
    1. Click Next.
    Add font files step
  4. In step 2 (Set fallbacks):
    1. Choose your fallback priority across the Fallback font 1, Fallback font 2, and Fallback font 3 drop-down lists. These fallbacks render in your recipient’s inbox if their client does not support your custom font.
    2. Click Publish.
    Set fallbacks step
  5. To copy the direct file path of an uploaded font, select the font row in the table and click Copy font URL.
  6. To manage your uploaded fonts, do any of the following:
    1. To search: In the Search by font name, fallback fonts box, type the name of the font or fallback you want to find.
    2. To copy the direct file path: Click the row of the custom font in the table, and then click Copy font URL.
    3. To set or remove a default font: In the Default column, turn on the toggle for the font you want to use as your default. Turning on a default font automatically applies it to all campaigns published after the font is added. Previously published campaigns continue using the fonts that were configured when they were created. To stop using the font as the default, turn off the switch.
    Default font toggle
  7. To remove a custom font: Under Actions, click the delete icon Delete icon in the row of the font, and then click Delete & Save in the Delete Font confirmation dialog box. Delete Font confirmation
Define specific typography styles across five core tags: Header 1 (H1), Header 2 (H2), Header 3 (H3), Paragraph, and Span. To configure your brand typography styles, perform the following steps:
  1. In the Building Blocks panel, click Typography to expand the section.
  2. Select the typography element you want to modify (Header 1, Header 2, Header 3, Paragraph, or Span).
    Typography element selection
  3. Under Font styles, configure your visual parameters:
    1. In the Font list, select your preferred brand typeface (for example, Inter).
    2. In the Size box, type a numerical value (for example, 14).
    3. In the Line Height box, enter a custom spacing value (for example, 1.5).
    4. In the Unit list, select either px or rem.
    5. In the Font color box, type a six-digit hex code (for example, #cd2f2f) or click the color block.
  4. Under Style, select or clear the check boxes for Bold, Italics, or Underline.
  5. Review the changes in the Preview section, which displays the standard string: “The quick brown fox jumps over the lazy dog”.
  6. Click Publish. Typography publish
Size and line height ranges
  • When unit is px: accepts integer values between 1 and 48.
  • When unit is rem: accepts decimal values between 0 and 3.
Define layout structures and interactive attributes for three button tiers: Primary, Secondary, and Tertiary. To configure your brand button styles, perform the following steps:
  1. In the Building Blocks panel, click Buttons to expand the section.
  2. Select the button tier you want to modify (Primary, Secondary, or Tertiary).
    Button tier selection
  3. To set standard rendering attributes, select the Default tab and configure the following parameters:
    1. In the Font list, select your preferred brand typeface (for example, Inter).
    2. In the Size box, type a numerical value for your font size (for example, 14).
    3. In the Unit list, select either px or rem.
    4. In the Font color box, type a valid six-digit hex code or select the color block.
    5. In the Background color box, type a valid six-digit hex code (for example, #007bff) or select the color block.
    6. Under Alignment, click the left-align, center-align, or right-align icons to position your button text.
    7. Under Style, select the check boxes for Bold, Italics, or Underline to apply font decorators.
    8. Under Border properties, enter a numerical value in the Radius box (for example, 0), select the Unit, and type a valid six-digit hex code in the Border color box.
    9. Under Margin, enter custom numerical values in the Left, Right, Top, and Bottom boxes, and select the unit from the Unit list.
    10. Under Padding, enter custom numerical values in the Left, Right, Top, and Bottom boxes (for example, 8 for Top and Bottom), and select your preferred unit.
    Default button settings
  4. To set interactive styling, select the Hover tab:
    1. To duplicate your default settings, select the Copy settings from default state check box.
    2. To customize your hover behavior, clear the Copy settings from default state check box and enter your custom values by repeating steps 1 through 10 under step 3.
      Hover button settings
  5. Review your configuration in the Preview section at the bottom of the section.
  6. Click Publish. Button publish

Publish Your Brand Book

Publishing applies your configured brand assets across all your marketing channels. The flow differs slightly the first time you publish versus when you update an already published brand book.

Publish a New Brand Book

When you finish your initial configuration, perform the following steps:
  1. After you configure your assets (logos, colors, fonts, or button styles), click Publish in the lower-right corner of the page.
  2. In the Confirm publishing dialog box, review the summary of the styles that are applied (for example, 2 Hyperlink styles, 3 Brand colors, 1 Brand logo).
  3. Click Confirm to publish the brand book and apply the styles across your communications. Confirm publishing
    • To exit without publishing: Click Cancel or the close icon (×). Your configuration remains in draft mode until you publish it. Cancel publishing dialog

Republish Your Brand Book

When you edit a brand book that has already been published, perform the following steps:
  1. After you update or add brand assets, verify that the orange notification banner appears at the bottom of the workspace.
    To apply your changes, publish your brand book again.
  2. Verify that the yellow Unpublished Changes Unpublished Changes badge indicator appears in the top header alongside the Reset brand book Reset brand book icon icon.
  3. Click Publish in the lower-right corner of the workspace.
  4. In the Confirm publishing dialog box, review the summary of queued changes.
  5. Click Confirm to publish your updates and apply them across your communications. Confirm republishing
  6. To exit without publishing: Click Cancel or the close icon (×). Your configuration remains in draft mode until you publish it. Republish cancel dialog
Published styles are applied across all your communications. You can modify the brand book later if required.

FAQs

In the current scope of the feature, only a single master brand book can be configured and used across an entire workspace. By default, this master configuration applies across all teams.
Automatic ingestion relies on background crawling scripts. If your website incorporates strict cross-origin resource sharing (CORS) rules, access restrictions, or web application firewalls, the background scanner is blocked from accessing those assets. Logos hosted behind authentication or fonts loaded from private CDNs are also often skipped. In these cases, use the manual workflow to update your brand book assets.
Publishing modifications to your brand book immediately updates the default options available inside the asset color pickers and typography menus for new campaigns. However, existing live experiences and pre-saved campaign templates do not update their styled layouts automatically. Changes to existing editor elements must be managed manually within the visual editor interface.