Customizing appearance and branding

Customers that require their own brand to be prominent across the product can change the appearance of both Workspace and Builder to their needs. This also reduces the presence of the CARTO brand to basemap attribution-only, and makes publicly shared maps neutral so that they can be integrated in your own portals and websites.

Appearance customizations are only available to selected customers in Enterprise Large plans or above, and it needs to be manually enabled by CARTO. If you’re interested in this feature, please get in touch at

To customize the appearance of CARTO, go to Settings > Customizations.


If you click on Customize Appearance, this section will let you set your own brand and colors so that all users view them when entering and using CARTO. This also affects the color of Builder widgets and other styles.

You can define the following styles:

  • Logo: the logo in the header. It needs to be a square image file (like an avatar) with a minimum dimensions of 256x256 pixels and a maximum file size of 1MB.

  • Primary color: the primary color used in the UI. Buttons in Workspace and Builder will use this color.

  • Secondary color: this color is used for accent and in some components for data visualization. For example, widgets in Builder will use this color.

  • Use primary colors for the App bar (header): enable this option if you want to reuse the primary color for the header in Builder and Workspace. Disable that option if you want to customize the header.

If the “Use primary colors…” setting is disabled:

  • App bar background: set this color to customize the header background.

  • App bar contrast text: set this color to customize some components that need contrast with the background in the header.

Once you “Save Changes”, the UI will start applying the new styles. Some changes might take a bit to appear. Remember that these settings will be applied to all users and viewers.

Public and embedded maps

You can also decide if you want the public and embedded maps to use the CARTO footer, which contains the CARTO brand and links to share the map on social media. This setting affects all maps, including existing ones.

Can I add my own logo to the map?

Not at the moment. This may be something we include in the future but for now, the recommended best practice is to keep the map neutral and then embed it in a corporate website that contains your logo and brand identity.


In some cases, new viewers and editors could get distracted by the regular onboarding experience including demo maps. If you want to disable this experience you can do so by disabling Show onboarding to new users.

Last updated