Visual Editor

The Visual Editor is the recommend way of labeling events in Freshpaint. The Visual Editor is a point and click interface. When using the Visual Editor, Freshpaint will place an overlay on top of your site that let's you see the event you are creating:

Labeling Click Events

To label a click event with the visual editor, just click the part of your website that you want to label the event definition for. This will highlight the element you clicked on and all similar elements on the page:

The Visual Editor will show the total number of elements on the page that are similar to the element you clicked on:

Expanding the Event Definition

Sometimes the initial event definition will not match all the elements you want it to. You can expand the event definition by clicking on other elements on the page you want it to match. Freshpaint will try to compute a new event definition that matches every element you've clicked on. If you ever want to reset and clear all the elements you've clicked on, just click the trash can icon.

Narrowing the Event Definition

Sometimes the event definition will match too many elements on the page. There are two different ways to narrow down the elements the event definition matches, with filters and by rejecting other elements.


The Visual Editor allows you apply specific filters to the event definition. You can use the following filters:

  • href filter - This will filter based on the location a link points to. Applying an href filter will work in most cases if you are trying to narrow in on a specific link or button.

  • text filter - This will filter based on the text of the element you are selecting.

  • path filter - This will limit the event definition to only events that occur on the current page.

Rejecting Elements

If there's an element that's highlighted that you don't want to match, you can click on it to reject it. Freshpaint will now try to compute a new event definition that matches the elements you've approved and does not match the elements you've rejected.

Labeling Pageview Events

The Visual Editor also makes it easy to label pageview events in Freshpaint. Just click the Label Pageview button in the top right. This will create a popup that lets you fill in the path and name of the pageview event you want to label.

Viewing Existing Events

The Visual Editor lets you see where existing event definitions are on the page. To see where an existing event is defined, click Show Events in the top right. This will show you all the events you have labeled. When you mouse over one of the event definitions, Freshpaint will show you all the elements on the page that match that event's definition.