Branding Configs

This page is currently in development. See the ENV Variables page for more info on specific variables mentioned below.

Note: if you've previously deployed and are updating your BlockScout version with new assets, be sure to remove static assets from the previous build (use mix phx.digest.cleanor manually delete assets located in apps/block_scout_web/priv/static folder) before updating current files and restarting/rebuilding BlockScout.

In order to rebuild new front-end assets run the following. Note: If preferred, use npm ci rather than npm install to strictly follow all package versions in package-lock.json

  1. cd apps/block_scout_web/assets; npm install && node_modules/webpack/bin/webpack.js --mode production; cd -

  2. mix phx.digest

  1. Theme Colors and other CSS-based attributes: See CSS Configs and Presets to set your instance to the stylesheet you want to use.

  2. Logos: Use the LOGO and FOOTER_LOGO env variables to direct to your uploaded logos. Logos and other assets are located in the apps/block_scout_web/assets/static/images folder.

  3. Coin: Customize the coin symbol using the COIN & COINGECKO_COIN_ID env variables.

  4. MetaData: MetaTags can be adjusted for various pages in the templates area. For the home page, tag data is rendered from here: /apps/block_scout_web/lib/block_scout_web/templates/chain/_metatags.html.eex

  5. Titles / Subtitles: Browser tab displays the title from the 2 SUBNETWORK + NETWORK env variables.

  6. Favicon: replace the current favicons located in the apps/block_scout_web/assets/static/images folder.

  7. Menus: Use the APPS_MENU env variable to include an apps menu and EXTERNAL_APPS to populate the menu.

  8. Top navigation bar: Data is rendered from here:


  9. Footer: Data is rendered from here: /apps/block_scout_web/lib/block_scout_web/templates/layout/_footer.html.eex ENV variables for footer links




  10. Custom Theming: Custom theming is available from the BlockScout team. Learn More.

Last updated


Copyright © Blockscout Limited 2023-2024