Read time metrics

You could turn that around and say: we think read time is an undervalued indicator so we are putting it on the dashboard so that CMs can report on it, thus making it more valued.

(The assumption is, of course, that CMs can have a say in what they report on.)

I don’t actually believe that read time is an undervalued metric in this context. Reporting should generally be tied directly to a goal or objective – generally one tied to a financial ROI.

I’m interested to hear from CMs who do think it is important to report on, and the reasons for that. I’m open to being convinced, but so far I’m not.

While not CM-specific, I feel like the “Session Duration” metric that Google Analytics puts pretty front-and-center is a reasonable proxy for this, and offers some evidence for the general utility of knowing how valuable people are finding the content on a site by way of the time they spend consuming it:


I’m hoping to use “read-time” as a metric for how helpful the Forums are to lurkers, specifically.

I want this, in addition to metrics on activity among contributors, because I’d like a way to report on the value we’re creating for our largest visitor-base: the non-contributors.

Am I missing another way of reporting on this subset of users?

1 Like

The issue with this approach is that you’re also counting read time from contributors – if you want read time that is specific to non-contributors you’ll need to make that distinction. A data explorer query is going to be your best bet there.


Ah, makes sense, and very fair.

1 Like

Interested in identifying users who visit the site vs. users who just reply to posts via email.

Would a decent metric be something like time_read / post_count? We don’t have anything like this in the dashboard yet, correct? Any other existing data that might help us capture “email only” users?

To rank a given user against the site average, is there anywhere totals for all users are stored?

Finally, in trying to examine the client API I’m looking at the dashboard user visits, but can’t get the urls to work for me as in other places, e.g. should this work?:


Short of my three questions above, can anyone confirm if time_read does EXCLUDE activity coming in from email?

time_read does not include the time a user may have spent reading emails sent from the site. Its value is calculated based on the amount of time the user has spent with topics open on the screen. See How does post tracking work in Discourse for details about how the time is calculated.

You can make API requests to get specific reports. For example, this request works for the User Visits report:

curl -X GET "" \
-H "Api-Username: system" \
-H "Api-Key: $api_key" -H \
"Content-Type: multipart/form-data;"

Making requests to the /admin/reports/bulk.json endpoint should work as well. You need to be sure that you add .json to the URL and that start_date and end_date query parameters are added to the URL.


Very helpful and clarifying. Thank you @simon.

  • Is it fair to say that recent_time_read is the only stat one can pull on a user that is not distorted by time, i.e. has a common time denominator?

  • Are there site-wide totals for anything like time_read or posts_read_count?

Much cleaner than what I had, which did actually work once I added the .json.

Thanks again. Excited to start using this data!