Setup Web Brand

Updated 11 July 2026

Watch Tutorial Buy Now

A complete beginner guide: download the addon, install it in Odoo, and confirm everything works before you change colors or the login page.

Overview

This page is for new users who have never installed an Odoo addon before. You will install Odoo Branding & Login Page Theme (Web Brand) step by step, from downloading the files to opening Settings → Web branding for the first time.

You need a person with administrator rights on your Odoo database (someone who can open Apps and Settings). If you bought the app on the Odoo Apps Store, use the same Odoo account when you install.

Folder name on disk: webby_odoo_branding_login_theme (keep this name when you copy the folder).

How It Works

Odoo reads addons from special folders on your server (often called addons or custom_addons). After you copy Web Brand there and restart Odoo, you refresh the app list, install the module, and Odoo adds branding options under Settings.

Web Brand does not add a new main menu like Sales or Inventory. It works inside Settings → Web branding. Anyone who can open Settings can configure it; other users simply see the new colors and login page after you save.

This module does not ship demo data. After install you go straight to settings-there is no sample company or extra records to remove.

If installation fails, copy the exact error from the Odoo UI or server log; most failures trace to wrong Odoo version, missing addons_path, or skipping Update Apps List / service restart.

Step-by-Step Guide

Step 1 – Download the latest copy of the addon
  • If you bought on Odoo Apps Store: Sign in at apps.odoo.com, open your module page, and download the ZIP for your Odoo version (16, 17, 18, or 19).
  • If your partner sent files: Ask for the newest ZIP or folder named webby_odoo_branding_login_theme. Do not use an old copy from email if a newer version exists.
  • Unzip the file on your computer. You should see one folder: webby_odoo_branding_login_theme with files such as __manifest__.py inside it.
  • Keep the version matched to your Odoo (for example 17.0 addon for Odoo 17). Using the wrong version can cause install errors.
Step 2 – Upload the addon folder to Odoo addons path
  • Connect to the server where Odoo is installed (or ask your hosting provider / IT team). You need permission to copy files into the addons directory.
  • Copy the entire folder webby_odoo_branding_login_theme into your custom addons path. Common locations:
    • /odoo/custom_addons/webby_odoo_branding_login_theme
    • /opt/odoo/addons/webby_odoo_branding_login_theme
    • On Windows: C:\odoo\custom_addons\webby_odoo_branding_login_theme
  • Make sure the folder name is exactly webby_odoo_branding_login_theme (no extra spaces, no nested duplicate folder like webby_odoo_branding_login_theme\webby_odoo_branding_login_theme).
  • Confirm your Odoo config file (odoo.conf) lists this path in addons_path. If the path is missing, Odoo will not see the module. Your administrator must add it once.
Step 3 – Restart the Odoo service
  • After copying files, restart Odoo so it loads the new addon. A normal browser refresh is not enough for this step.
  • Linux (systemd) example: sudo systemctl restart odoo (service name may differ).
  • Windows service: Restart the Odoo service from Services, or stop and start your Odoo batch script.
  • Odoo.sh / Odoo Online: Push the module through Git or upload via the platform; follow your host’s guide. You usually do not restart manually on Odoo Online.
  • Wait until Odoo is fully running again before you open the browser.
Step 4 – Activate Developer Mode in Settings
  • Log in to Odoo as a user with Settings access (Administrator).
  • Open Settings (gear icon).
  • Scroll to the bottom of the Settings page. Click Activate the developer mode (or Developer Tools → Activate the developer mode on some versions).
  • Developer mode is needed so Odoo can Update Apps List and show technical options. It does not break your database; it only shows extra tools for admins.
Step 5 – Update Apps List
  • Open the Apps menu (main Odoo menu).
  • Click the three-dot menu (or Update Apps List) and confirm Update.
  • Wait until Odoo finishes. It reads all folders in addons_path and registers new modules.
  • If Web Brand still does not appear, check Step 2 (folder path and name) and Step 3 (restart), then update the list again.
Step 6 – Search the addon in Apps and activate (install) it
  • In Apps, remove the Apps filter if you only see installed modules (click the search chip and clear it).
  • Search for Odoo Branding, Web Brand, or webby_odoo_branding_login_theme.
  • Open Odoo Branding & Login Page Theme (Web Brand) and click Install (or Activate on some screens).
  • Wait until the page reloads and the button shows Installed. Installation usually takes a few seconds.
  • If install fails, note the error message. Common causes: wrong Odoo version, missing dependency modules (web, base_setup, web_editor are standard and normally already installed).
Step 7 – Demo data (if the addon provides it)
  • Web Brand does not include demo data. You will not see extra sample customers, products, or branding presets loaded automatically.
  • On install, Odoo may only set a default welcome message for split login layouts inside settings. That is normal and is not separate demo data.
  • If another addon asks “Load demonstration data?” during install, that question belongs to that other addon-not Web Brand.
  • After install, go directly to Step 8 and Step 9 below to configure branding.
Step 8 – User access and permissions
  • Web Brand is configured in Settings → Web branding. Only users who can open Settings can change colors, login layout, favicon, and similar options.
  • Who should have access? Usually company administrators or IT staff-not every employee.
  • To allow a user to manage branding: open Settings → Users & Companies → Users, open the user, and ensure they have a group that includes Administration / Settings (exact name may vary: “Settings”, “Administration”, or full Administrator).
  • Regular staff do not need a special Web Brand permission. After you save branding, they see updated colors and the login page when they use Odoo normally.
  • There is no separate “Web Brand” menu in the main app switcher. Do not search for a missing menu-open Settings instead.
Step 9 – Refresh Odoo and confirm you see Web Brand
  • Press Ctrl+F5 (or Cmd+Shift+R on Mac) in your browser to hard-refresh, or close the tab and open Odoo again.
  • Go to Settings. In the left sidebar, find and click Web branding (you may need to scroll).
  • You should see sections such as Backend and login and Login page (public). If you see them, installation was successful.
  • Make a small test: set Backend window title to your company name, click Save, refresh the page, and check the browser tab title.
  • Open the login page in a private / incognito window (for example /web/login) to preview the public login screen.
  • When everything looks good, continue with the other chapters in this guide (colors, login layout, logo, and more).

Fields Table

This setup guide uses actions and Odoo screens, not form fields. Use this table as a quick checklist.

Step What you do Where / example

1

Download latest addon ZIP or folder

Odoo Apps Store or vendor

2

Copy folder to server addons path

custom_addons/webby_odoo_branding_login_theme

3

Restart Odoo service

systemctl restart odoo (Linux)

4

Activate Developer Mode

Settings (bottom of page)

5

Update Apps List

Apps menu

6

Install Web Brand

Apps → search “Web Brand”

7

Demo data

Not used for this module

8

Give Settings access to admins

Settings → Users

9

Refresh and open Web branding

Settings → Web branding

Field Explanations

Each block below matches a column or row from the checklist table above.

Step

The order number in the first column. Follow steps in sequence unless your administrator already completed earlier steps on the server.

What you do

The second column: the action you perform at that step (download, copy files, restart, update apps, install, and so on).

Where / example

The third column: where the action happens (Odoo screen or server path) or a short example value.

Step 1 – Download latest addon ZIP or folder

Get the correct module package for your Odoo version from the Apps Store or your vendor so the code matches your server.

Step 2 – Copy folder to server addons path

Place webby_odoo_branding_login_theme in a directory listed in addons_path; otherwise Odoo cannot discover the module.

Step 3 – Restart Odoo service

Reloads Odoo so new files on disk are registered; a browser refresh alone does not load a newly copied addon.

Step 4 – Activate Developer Mode

Unlocks technical actions such as Update Apps List so newly copied modules appear in Apps.

Step 5 – Update Apps List

Scans addon folders and refreshes the catalog Odoo shows in the Apps menu after you add or change modules on disk.

Step 6 – Install Web Brand

Activates the module for your database so Settings → Web branding and all branding fields become available.

Step 7 – Demo data

This module does not load demo records; this row reminds you that no sample company or extra cleanup is required for Web Brand.

Step 8 – Give Settings access to admins

Only users with Settings (or full Administrator) access can open Web branding; grant that group to the people who should edit branding.

Step 9 – Refresh and open Web branding

Hard-refresh the browser, open Settings → Web branding, and run a small save test to confirm installation end-to-end.

Tips

  • Tip: Do steps 2 and 3 (copy folder + restart) before you spend time in the browser. Many “module not found” issues are fixed this way.
  • Tip: Write down your Odoo version (e.g. 17.0) before downloading so you get the matching addon.
  • Tip: After setup, continue with Colors & window title and the other chapters to customize your branding.
  • Tip: Keep a short written record of your Odoo version, server path to the module, and the exact service name you restart-future upgrades are easier when those facts are not tribal knowledge.

Common Mistakes

  • Mistake: Copying only files inside the folder without the parent folder webby_odoo_branding_login_theme-Odoo expects the folder name to match the technical module name.
  • Mistake: Skipping server restart after uploading files-the module will not load until Odoo restarts.
  • Mistake: Searching for a new “Web Brand” app menu after install-configuration is always under Settings → Web branding.
  • Mistake: Expecting demo companies or sample data-this module does not install demo records.
  • Mistake: Giving every employee Settings access just to see branding-only admins need Settings; everyone else sees the result automatically.
  • Mistake: Installing from a duplicate nested folder (ZIP extracted twice) so the technical module path does not match webby_odoo_branding_login_theme and Odoo cannot load the manifest.

Image