Listing Stats

​

What Are Listing Stats?

Listing stats help listing owners see how their listings are performing. They can view page visits, see where visitors come from, and check how often action buttons are clicked.

​

Where Listing Owners See Stats

​

Main Dashboard (My Account)

When a user logs in and opens My Account, the default dashboard shows an overview of all their listings combined. This includes summary cards at the top (such as published listings and visits this week) and larger blocks below (views, referrers, charts, and more).

​

Stats for One Listing

Listing owners can view a single listing in two ways:

• Use the Filter by listing dropdown on the dashboard.
• Click Stats next to a listing on the My Listings page.

Both actions open a dedicated stats page for that listing, as shown in the example below: https://yoursite.com/my-account/?listing=565 On this page, all numbers apply only to that listing.

​

Where Admins Configure Stats

Go to WP Admin > Theme Tools > Listing Stats. Direct link (when logged in as an admin): https://yoursite.com/wp-admin/admin.php?page=theme-stats-settings This page does not turn tracking on or off. It controls what listing owners see on their dashboard, how long visit data is kept, how often numbers are refreshed, and the colors used on charts and cards. Click Save settings at the bottom after you make changes.

​

Two Types of Data

MyListing tracks two separate kinds of activity. They are stored differently and behave differently.

​

Page Visits

A visit is recorded when someone opens a published listing page. What You Can Learn From Visits:

• Total views and unique views (last 24 hours, 7 days, 30 days)
• Visits over time (the chart)
• Top referrers (which websites sent people to the listing)
• Browsers, operating systems, countries, and mobile vs desktop

How Visits Are Stored:

• Each visit is saved in a database table.
• Repeat views from the same person within a short window (about 3 minutes by default) are not counted again, to reduce inflated numbers.

How Long Visit Data is Kept:

• Old visit records are deleted automatically based on the Delete stats older than (days) setting (default: 30 days).
• This setting only affects visit data. It does not remove button click counts.

​

Button Clicks

A button click is recorded when someone clicks a tracked action on the listing page. Tracked actions include quick actions (call now, website, bookmark, and similar) and cover actions in the listing header. What You Can Learn From Button Clicks:

• How many times each action was clicked
• Which buttons get the most engagement

How Button Clicks Are Stored:

• Counts are saved on each listing as a running total.
• There is no automatic expiry. Counts will continue to grow until you remove or change the action in the listing type.

Important: Hiding the Tracks block in admin settings does not stop clicks from being counted. It only hides the numbers from the dashboard.

​

General Settings

​

Cache Stats for (Minutes)

Default: 60 minutes The dashboard does not recalculate every number on every page load, so the results are cached for a set time to keep the site fast. Results are cached for a set time to keep the site fast.

• Lower value: numbers update more often, but the site may work somewhat harder.
• Higher value: faster dashboard, but combined stats on the main dashboard may look slightly out of date for a while.

Note: When a listing owner views stats for a single listing, button click counts are read directly and are always up to date. Visit stats and charts on that page still use the cache.

​

Delete Stats Older Than (Days)

Default: 30 days Visit records older than this number of days are removed during routine cleanup. This keeps the database from growing too large. This setting does not affect button click totals. Set to 0 to disable automatic deletion (not recommended on busy sites).

​

Stat Boxes

These toggles control which summary blocks appear on the main My Account dashboard (all listings combined). On the single listing stats page, Views, Unique Views, Tracks, and Devices can also appear when enabled. Referrers, browsers, platforms, countries, and the chart use the same settings.

​

My Listings Page

These toggles control the small stat cards shown at the top of the My Listings page in the user dashboard.

​

Visits Chart

The chart shows how visits changed over time.

​

Color Palette

These colors are used on dashboard stat cards and charts.

​

How Button Click Tracking Works

Button clicks are set up per listing type, not on the Listing Stats settings page.

1. Go to WP Admin > Listing Types and edit a listing type.
2. Open the Single Page tab.
3. Edit a Quick Action or Cover Action.
4. Turn on Enable Tracking for actions you want to count.

Most built-in actions (Call now, Get directions, Website, Bookmark, Share, and others) have tracking enabled by default. Custom link actions can also be tracked when this option is on. When a visitor clicks a tracked button on the listing page, the count goes up immediately in storage. The listing owner sees the totals on their dashboard when the Tracks block is enabled. If you remove an action from the listing type, the system cleans up old click counts for that action the next time it reads the stats.

​

Quick Reference

​

Common Questions