=== Jetpack Stats ===
Contributors: automattic
Tags: stats, analytics, site stats, traffic, visitors
Requires at least: 7.0
Requires PHP: 7.4
Tested up to: 7.1
Stable tag: 1.0.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Simple, yet powerful stats to grow your site. See your traffic, referrers, and top content at a glance — no data science required.

== Description ==

With Jetpack Stats, you don't need to be a data scientist to see how your site is performing. Get a clear, privacy-friendly picture of your traffic right inside your WordPress dashboard.

Jetpack Stats is a standalone plugin — you can run it on its own, without installing the full Jetpack plugin.

**Tried and true visitor stats to help you understand your audience**

Explore real-time data on visitors, likes, and comments. Get detailed insights on the referrers that bring traffic to your site. Discover what countries your visitors are coming from. Measure link clicks, video plays, and file downloads within your site.

**See what's working with content performance metrics**

Discover your top performing posts & pages. See who is creating the most popular content on your team with our author metrics. Easily keep track of your content creation habits & trends over the years. View weekly and yearly trends with 7-day Highlights and Year in Review. Understand where your visitors are coming from with UTM tracking.

**Engage with your subscribers and view your social reach**

See your WordPress & Email subscribers, and follow them back to build your community. Connect Jetpack Social to popular social networks and see your total follower counts. See what popular social networks your content is being shared to the most.

**Third-party integrations to keep you growing**

Promote content to millions of WordPress and Tumblr users directly from Stats using Blaze. Easily see orders, refunds, shipping, and other product trends as a WooCommerce customer. Monitor ads displayed & keep track of earnings when using Jetpack Ads.

**Keeping personal data secure**

Jetpack Stats gives you a powerful WordPress analytics tool that respects your visitors' privacy, allowing you to gain valuable insights while maintaining GDPR compliance.

== Installation ==

= Automated installation =

1. Go to the Plugins screen in your WordPress admin and click "Add New".
2. Search for "Jetpack Stats" and click "Install Now".
3. Activate the plugin through the Plugins screen.
4. Connect your site to a WordPress.com account when the plugin asks you to. Stats cannot collect data before this step is complete.
5. Go to the Stats tab.

= Manual installation =

1. Upload the plugin files to the `/wp-content/plugins/jetpack-stats` directory, or install the .zip file through the Plugins screen in your WordPress admin.
2. Activate the plugin through the Plugins screen.
3. Connect your site to a WordPress.com account when the plugin asks you to.
4. Go to the Stats tab.

== Frequently Asked Questions ==

= How do I configure Jetpack Stats? =

Simply install the plugin and go to the Stats tab. It's that simple. If you need more help, check out [this support article](https://jetpack.com/support/jetpack-stats/).

= Do I need the full Jetpack plugin to use Jetpack Stats? =

No. Jetpack Stats is a standalone plugin and works on its own. If you already run the full Jetpack plugin, Stats works there too — you don't need both, and running both will not create duplicate menus.

= Does Jetpack Stats integrate with Google Analytics? =

Yes! You can use both on your WordPress installation. The benefit of using Jetpack Stats is that you can see a snapshot of your blog's activity directly from your dashboard. If you want to use another analytics service to give you additional in-depth information, you can certainly do so.

= With Stats, can I view visitors by country? =

Yes! Jetpack Stats will show you a heatmap of exactly where in the world your site has been receiving its visitors from.

= Does Stats honor DNT requests? =

Do Not Track (DNT) is a feature in web browsers and websites that asks advertisers and other web software providers not to track individuals' browsing habits. As a site owner, you can configure Jetpack Stats to honor requests from visitors who have DNT enabled, and prevent tracking of their activity (i.e., post and page views) with an easy-to-add snippet.

= Through Stats, can I see who viewed individual posts? =

No. Any piece of data explicitly identifying a specific user (IP address, WordPress.com ID, WordPress.com username, etc.) is not visible to the site owner when using Jetpack Stats, so you won't be able to see which specific users or accounts viewed a particular post.

= Can I download my site stats? =

You can click the title of each feature on your stats page, and scroll to the bottom of that feature to download your stats. Simply click on the "Download data as CSV" link, and download the file to your computer.

== Screenshots ==

1. The Traffic dashboard — views and visitors over time, with your most viewed posts & pages and top referrers.
2. A world heatmap showing where your visitors come from, plus UTM campaigns and link clicks.
3. Insights — all-time stats, your most popular day and hour, and a year of posting activity.
4. Stats for a single post — views, likes, and comments, with daily trends.

== External services ==

This plugin relies on WordPress.com, a service operated by Automattic, to record visits and generate the reports shown in the Stats dashboard. The plugin does not work without it.

It connects to the following external services:

**WordPress.com connection API (`https://jetpack.wordpress.com`)**

* What it does: registers your site with WordPress.com and links it to your WordPress.com account. The view tracking, the reporting API and the data sync do not work without it. The dashboard interface is the exception: it loads before the site is connected, so that the plugin can offer you the connection.
* Data sent: when the site is registered, its address, home address, name, language, time zone, the path of the WordPress installation on the server, the date the site was created, the Stats site ID if the site already has one, the versions of the bundled Jetpack packages, the version of the Jetpack plugin if the site has that plugin, the plugins that use the Jetpack connection, the email address and user ID of the administrator who starts the connection, one-time secrets that WordPress.com uses to check the request, and either the WordPress.com user ID of that administrator or, if they have no connected WordPress.com account, a random identifier that is also kept in a `tk_ai` cookie in their browser. To approve the connection, your browser goes to this host with your WordPress user name and email address, the name, address and icon of the site, and the role you connect with. Your site then exchanges an authorization code for the tokens that sign all later requests. Disconnecting the site, or removing a user from the connection, also sends a request to this host.
* When: when you connect the site, when you approve the connection with your WordPress.com account, when you disconnect the site or remove a user from the connection, and once a day when the plugin makes sure that it can still reach WordPress.com over a secure connection.

**WordPress.com view-tracking pixel (`https://pixel.wp.com/g.gif`)**

* What it does: records a page view each time a visitor loads a page on your site. Once a day, a scheduled task also uses this address to report the state of your site, so that WordPress.com can keep the service working with the software your site runs.
* Data sent: for a page view, the page viewed, the referring URL, the visitor's IP address, the user agent, and your site ID. For the daily report, your WordPress and PHP versions, whether the site is public, whether it is served over HTTPS, whether it can reach WordPress.com over a secure connection, the site language and character set, whether the site is part of a network, the names of the active plugins and must-use plugins, the size of the uploads folder, the first two groups of digits of the server IP address, the versions of the bundled Jetpack packages, the plugins that use the Jetpack connection, and whether the plugin found a problem with the connection. Your visitors are not part of the daily report.
* When: a page view is recorded on every front-end page view. The daily report is sent by a scheduled task, and not more than once every 23 hours.

**WordPress.com measurement script (`https://stats.wp.com/e-{year}.js`)**

* What it does: loads the small JavaScript file that sends the view-tracking request above from the visitor's browser.
* Data sent: no data is sent when the file is downloaded; it is a static script served from Automattic's CDN.
* When: on every front-end page view.

**WordPress.com reporting API (`https://public-api.wordpress.com`)**

* What it does: returns the aggregated statistics displayed in your Stats dashboard.
* Data sent: your site ID and the report parameters (date ranges, metric requested). Requires an authenticated WordPress.com connection.
* When: whenever you open the Stats dashboard or load a report.

**WordPress.com Sync (`https://public-api.wordpress.com`)**

* What it does: keeps a copy of your site's content and settings on WordPress.com. The reports need it to show post titles, authors and categories, and the service needs it to know how your site is set up. If your site cannot use this address, the same data goes to `https://jetpack.wordpress.com/xmlrpc.php` instead.
* Data sent: your posts, pages, other post types and media, with their text, authors, categories, tags and publication state; your comments, with the name, email address and website that the commenter gave; your users, with their user names, email addresses, display names, roles and permissions, but never their passwords; your site settings, menus and theme; and the list of plugins and themes on the site with their versions and available updates.
* When: continuously, as content and settings change, and in full when the site connects or when WordPress.com has to rebuild its copy.

**WordPress.com dashboard assets (`https://widgets.wp.com/odyssey-stats/`)**

* What it does: serves the JavaScript, styles, and icons that render the Stats dashboard interface in your WordPress admin.
* Data sent: no personal data; these are static front-end assets served from Automattic's CDN.
* When: whenever you open the Stats dashboard.

**WordPress.com Tracks (`https://stats.wp.com/w.js` and `https://pixel.wp.com/t.gif`)**

* What it does: records how people who can open the plugin screens use them, so that Automattic can improve the plugin. This is separate from your site statistics.
* Data sent: the name of the action taken, your site ID, your WordPress.com user ID and username, the browser user agent, the browser language, and the IP address of the request. If the person is not connected to a WordPress.com account, a random identifier is used in place of the user ID and username, and it is stored in a `tk_ai` cookie in their browser.
* When: only while a logged-in user with access to the plugin screens uses them in the WordPress admin. You control who has that access through the Stats settings. Nothing is recorded for your site visitors.

This plugin requires a connection to a WordPress.com account. Until that connection is complete, no data is collected and no reports are available.

Service terms: [Terms of Service](https://wordpress.com/tos/)
Service privacy policy: [Privacy Policy](https://automattic.com/privacy/)

== Source code ==

Jetpack Stats is developed in the open. The plugin, every bundled `automattic/jetpack-*` package, and the build tools that produce the released package are all in the Jetpack monorepo:

* Plugin source: [Automattic/jetpack/projects/plugins/stats](https://github.com/Automattic/jetpack/tree/trunk/projects/plugins/stats)
* Stats collection and reporting: [projects/packages/stats](https://github.com/Automattic/jetpack/tree/trunk/projects/packages/stats)
* Stats dashboard integration: [projects/packages/stats-admin](https://github.com/Automattic/jetpack/tree/trunk/projects/packages/stats-admin)
* Monorepo and build tools: [Automattic/jetpack](https://github.com/Automattic/jetpack)

The dashboard interface itself is a React application called Odyssey Stats. It is served as a prebuilt bundle from `widgets.wp.com`, and its source is in a second public repository:

* Odyssey Stats application: [Automattic/wp-calypso/apps/odyssey-stats](https://github.com/Automattic/wp-calypso/tree/trunk/apps/odyssey-stats)
* Shared Stats interface it is built from: [Automattic/wp-calypso/client/my-sites/stats](https://github.com/Automattic/wp-calypso/tree/trunk/client/my-sites/stats)
* Repository and build tools: [Automattic/wp-calypso](https://github.com/Automattic/wp-calypso)

To build the plugin from source, follow the instructions in the monorepo [development guide](https://github.com/Automattic/jetpack/blob/trunk/docs/development-environment.md).

== Changelog ==
### 1.0.0 - 2026-09-23
#### Added
- Initial release of Jetpack Stats as a standalone plugin.
