Skip to content
Peekbird

Visual editor

The visual editor opens on your real site, in a tab of your own browser: your pages, logins, carts and scripts as they are. Click anything to change it. Each change is saved as you make it, and visitors' pages apply it with the same code you see working in the editor.

Open the editor

  1. Save the experiment. The editor is for A/B and multivariate tests: a split-URL test sends visitors to other pages, so you edit those pages instead.
  2. In its Setup, go to Variations and click Edit visually on a variation. The control is your page as it is, so it has none. In a multivariate test, each option has its own, and every combination that shows the option gets its changes.
  3. Check Page to open: a page of your site, usually one the experiment runs on. Then click Open the editor.

It's the snippet on your page that loads the editor, so the page needs it installed (see Install the snippet). If your site opens without the editor, the snippet isn't on that page, or an ad blocker in your browser stopped it.

The link works for 12 hours; after that, saving stops and you open the editor again from Peekbird. Anyone with the link can change the experiment's variations until then, so don't share it. Peekbird takes it out of the address bar as the page opens.

You can edit an experiment that's a draft, in QA or paused. A running one opens for looking only: pause it first, since changing a running test mixes two versions into one result. Other experiments on the same page still run in the editor's tab, as they would for you as a visitor.

Select and Browse

  • Select, on when the editor opens: hovering outlines elements and a click picks one. The page's own clicks don't run, so links don't navigate and buttons don't add to the cart.
  • Browse: use the page as a visitor would, to open a menu or follow a link to another page. The editor comes with you to any page with the snippet on it.

The bar at the bottom switches between variations; Original (no changes) shows the page as it is. Undo and redo with its arrows, or Ctrl+Z and Ctrl+Shift+Z (Cmd on a Mac). Esc lets go of the picked element.

What you can change

ChangeHow
TextType on the page (Enter or Esc when done), or edit it in the panel. Double-clicking any text starts typing.
ContentFor an element with others inside it, like a heading with a link: its HTML, typed on the page or edited under Advanced → Content (HTML).
StyleText color, background, font size and weight. Colors come from Peekbird's own picker: drag for a shade, type its code, or take one of the colors the page already uses (or, in Chrome and Edge, any color on the screen with the eyedropper).
HiddenTakes the element out of the page, along with the space it took.
ImageUpload a picture or give its address. Every screen gets it: Peekbird drops the image's other sizes (its srcset), which would otherwise win.
LinkWhere a link goes.
MovedDrag the element by its Move it handle (the page makes room as you go; Esc cancels), or use Move up and Move down.
AddedUnder Advanced: new HTML before or after the element, or inside it at the start or the end.

A change goes to the element you picked, or, with All … like it, to every element like it, such as each product card's button. A variation holds up to 200 changes.

The panel names the picked element in words (Heading “Free shipping”) and shows the everyday tools first: text, style, picture, link, placement and hiding. Advanced holds the rest: which screens, the element's CSS selector (Edit names the elements yourself), Parent and First inside to pick a larger or smaller element, its content as HTML, and adding new HTML. It opens by itself when the element already uses one of them, and stays open once you've opened it.

Phones, tablets and desktops

A change is for every screen unless you pick one kind under Advanced → Screens: All screens, Phones or Tablets & desktops. Phones are windows narrower than 768 px; tablets and desktops are 768 px and wider. It goes by the width of the browser window, so a narrow desktop window gets the phones' version, and a tablet can switch when it's turned.

Phone and Tablet in the bar open the same page in a window 390 px or 820 px wide, with the editor, where your site lays itself out for that size. Edit there: each window shows what the others save. A window only shows the changes for its own width.

An element's text, content, picture, link or place is one version for every screen, or one for phones and one for larger screens, never both: changing it for phones turns an every-screen version into the tablets-and-desktops one. Styles and hiding can be both: on phones, say, the phones' style wins.

Pictures

Upload PNG, JPEG, WebP, GIF or AVIF pictures, up to 2 MB each. SVG isn't accepted, since it can carry scripts. Peekbird checks the file itself, not its name, and serves it from cdn.peekbird.com, cached for good. Or paste the address of a picture anywhere on the web.

Saving and previewing

  • Each change is saved as you make it. The bar shows where it stands: Saved, Saving…, Unsaved, Not saved: retrying in 4s (offline, or a problem on Peekbird's side), Changed elsewhere or Not saved.
  • Changes not yet saved are kept in the tab, so a reload doesn't lose them. If you leave the page with some, your browser asks first.
  • If another tab or person saves the same variation meanwhile, nothing is overwritten: the editor asks whether to Use that version or Keep mine.
  • Done saves and takes you back to Peekbird.

What the editor shows is what visitors get: it applies your changes with the same code their pages run, along with the variation's own CSS and JavaScript. Code that has run can't be taken back, so in a variation with JavaScript, switching to another variation reloads the page.

A draft's changes reach no one until you start it. In QA, each save is published at once, for browsers with a QA link. A paused experiment's changes go live when you resume it. To see a variation outside the editor, use the links on the experiment's Preview & QA tab: see QA and preview.

When a change stops working

Visitors' pages report which changes found their element and which the page undid. From the last 7 days, the editor marks the changes in trouble in its list, and the experiment's page shows Some of this test isn't working on visitors' pages. What the editor says (numbers are examples):

The editor saysWhat it means, and what to do
not on this pageThe change's element isn't on the page open in the editor. That's expected for a change made on another page. If it should be here, the page has changed: remove the change and make it again.
Found on none of the last 12 visitors' pages (7 days): the page has changed since.No visitor in that variation had the element on their page, over at least 5 page views: usually a redesign or a new theme renamed it. Click Pick its element again, then the element the change should go to now.
Visitors' pages kept undoing it (40 times in 7 days): the page redraws that element. Try its parent instead.Your site's own code kept redrawing the element and undoing the change, more than 10 times in a second, so Peekbird stopped re-applying it on those pages rather than fight it. Make the change on a parent element, or in the variation's JavaScript.
Its JavaScript failed: …The variation's own JavaScript threw an error here; the experiment's page lists the errors it threw on visitors' pages too. Fix it in the variation's JavaScript, in the experiment's Setup.
Changes apply to all 8 matching elements on this page.The selector finds more than one element. If you meant one, choose Only this one, or edit the selector.
Changes for phones show on screens narrower than 768 px, not in this window.You chose Phones in a wider window: the change is saved, but this window can only show it at phone width. Open a phone-sized window.

Sites with Trusted Types

Content and Added changes put HTML into the page, which a site that enforces Trusted Types blocks, and the editor can't open on such a site either. Trusted Types isn't supported yet. Your Content Security Policy also needs a few entries for the editor: both are in Speed, CSP and single-page apps.

See what your visitors see.

Start free in a few minutes: one snippet, every feature. Move to a bigger plan when you need more tracked visits.