> ## Documentation Index > Fetch the complete documentation index at: https://docs.mylisting.club/llms.txt > Use this file to discover all available pages before exploring further. # 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. This guide explains what the stats mean, where listing owners see them, and how to configure the stats screen in the WordPress admin. ## **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). | **Setting** | **What it shows** | | :---------------------------- | :------------------------------------------------------------- | | **Enable Published Listings** | How many published listings the user has | | **Enable Pending Listings** | How many listings are waiting for approval or payment | | **Enable Active Promotions** | How many active paid promotions the user has | | **Enable Visits this week** | Total listing page visits in the last 7 days | | **Enable Referrers** | Top websites that sent visitors to the user's listings | | **Enable Browsers** | Most common browsers used by visitors | | **Enable Platforms** | Most common operating systems (Windows, macOS, iOS, and so on) | | **Enable Countries** | Countries visitors came from | | **Enable Devices** | Share of visits from mobile vs desktop | | **Enable Views block** | Total views for the last day, 7 days, and 30 days | | **Enable Unique Views block** | Unique visitors for the last day, 7 days, and 30 days | | **Enable Tracks block** | Button click totals grouped by listing type | 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. | **Setting** | **What it shows** | | :-------------------------- | :---------------------------------- | | **Enable Published** | Count of published listings | | **Enable Pending Approval** | Listings waiting for admin approval | | **Enable Pending Payment** | Listings waiting for payment | | **Enable Expired** | Expired listings | ## **Visits Chart** The chart shows how visits changed over time. | **Setting** | **What it does** | | :---------------------- | :-------------------------------------------------------------------------------------------- | | **Enable chart** | Show or hide the visits chart | | **Enable views** | Include total views line on the chart | | **Enable unique views** | Include unique visitors line on the chart | | **Chart Categories** | Choose which time ranges appear as tabs (last 24 hours, 7 days, 30 days, 6 months, 12 months) | ## **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** | **I want to...** | **Go to...** | | :----------------------------------------- | :------------------------------------------------------------------------- | | Change what owners see on their dashboard | **Theme Tools > Listing Stats** | | Change how long visit history is kept | **Delete stats older than (days)** | | Hide button click numbers | Turn off **Enable Tracks block** | | Stop counting button clicks for one action | Edit the listing type and turn off **Enable Tracking** for that action | | See stats for one listing as an owner | **My Account**, then use **Filter by listing** or **Stats** on My Listings | ## **Common Questions** The dashboard caches combined stats for the duration specified in the Cache stats for (minutes) setting. Single listing stats for button clicks update immediately. Visit totals on the single listing page may still use the cache until it expires. Visit records are deleted after the number of days specified in the Delete stats older than (days) setting. This setting does not remove button click totals. No. Only the listing owner (and site administrators) can see stats in the user dashboard. Visits are only counted for **published** listings. The **Stats** link on My Listings only appears for published listings. WordPress admins also get stat widgets on the main **WP Admin > Dashboard** screen. Those widgets use the same visit data, but the Listing Stats settings page does not control them in the same way as the user dashboard layout.