Skip to content
BloopBloopBloop Docs

How to manage branding themes

A theme is the complete look of one campaign — colours, fonts, background, copy and custom code across every surface a customer sees. Each campaign has a library of themes and exactly one applied at a time, so you can build a new look in full, preview it, and switch the storefront over in a single click instead of editing live styling and hoping.

Open a campaign and go to Branding. The page lists your current theme first, then the rest of the library.

Manage the library

Section titled “Manage the library”
Action What it does
Create theme Adds a new theme from Bloop’s defaults
Apply Makes that theme live on your storefront
Customize Opens the theme’s surfaces to edit
Rename Renames it in the library only — customers never see the name
Duplicate Copies every setting under a new name
Delete Removes it. The applied theme can’t be deleted — apply another first

Themes belong to a campaign. If you run several campaigns, each keeps its own library, so a seasonal campaign can look completely different from your evergreen one.

The storefront can only load one branding version, themes or Legacy, at a time. Applying a theme in one campaign therefore moves every other active campaign onto themes too, keeping the theme it already has applied (or its first theme). Applying Legacy moves them all back to Legacy.

What a theme covers

Section titled “What a theme covers”

Customize opens the surfaces the theme controls:

Group Surface What it is
Widgets and popups Referral widget The floating widget button and the popup it opens, edited together in one editor. See Popup & widget
Friend popup What a referred friend sees when they arrive
Pages and integrations Referral page Your branded referral landing page. See Landing page
Post-purchase popup The prompt shown right after checkout. See Post-purchase popup
Referral in customer accounts The referral blocks inside Shopify customer accounts. See Customer account extension
Referral hub (hosted by Bloop) The advocate’s dashboard. See Referral hub

Referral page and Post-purchase popup are marked Recommended because they carry most of the programme’s traffic. Style those two before anything else.

Edit a surface

Section titled “Edit a surface”

The referral widget and the friend popup open in an editor with a live desktop and mobile preview. The friend popup has three tabs; the referral widget adds Widget button and Popup behavior tabs in front of them (see Popup & widget):

Appearance — background (a solid colour, an uploaded image, or no image at all), header text colour, body text colour, button background, button text, and corner style: square or rounded.

Content - every string a customer reads, grouped by the step they’re at. The referral widget covers the first three steps, and the friend popup the last two:

Step What the customer is doing
Referral signup Joining the programme
Referral share Copying their link or code
Share by email Sending an invite from the widget
Claim reward Entering their email to claim
Reward ready Collecting the reward they earned

Content is saved per language. Use the language selector to write each translation, or leave automatic translation on to generate them from your default language — see campaign language settings.

Custom code: CSS and JavaScript injected into the surface on your live storefront. On the referral widget it runs on both the widget button and the popup. Text your code displays can live in Custom text slots, translated per language like the rest of the content. Reach for this only when the editor genuinely can’t express what you need. Bloop support can’t debug or fix custom code, and a broken snippet can change how the popup looks or stops it working.

The other surfaces open in their own editors from the same screen. On the Legacy theme (v1), the widget popup and the widget button are still two separate cards.

Migrating from v1 branding

Section titled “Migrating from v1 branding”

Stores that used Bloop before themes see a Legacy theme (v1) entry at the top of the library. It’s still applied and still working, but it is being retired — it has no Referral Hub surface, no custom code, and it won’t receive new features.

Move across before support ends:

  1. Create theme to start a v2 theme.
  2. Customize it and rebuild your colours and copy. The editor shows a live preview, so work through the surfaces in the order customers meet them.
  3. Apply it, then check your storefront.

If something’s wrong, apply Legacy again — it stays in the library until you’re done. Stores that started on Bloop after themes shipped never see a legacy entry and can ignore this.

Common mistakes to avoid

Section titled “Common mistakes to avoid”
  • Editing the applied theme. Every change is live immediately. Duplicate first.
  • Styling the widget panel and stopping there. The referral page and post-purchase popup carry more traffic than the panel does.
  • Writing copy in the wrong language. Check the language selector before typing — it’s easy to overwrite your default-language content while meaning to add a translation.
  • Solving layout problems with custom CSS. A snippet that fixes your theme today breaks on the next Bloop release. Use the editor’s fields where they exist.

Next steps

Section titled “Next steps”