---
title: Troubleshooting Guide
description: A quick troubleshooting guide and quality assurance check for Metrics for News.
---

[Skip to content](https://docs.metricsfornews.com/en/knowledge/quality-assurance-guide#main-content)

English

Show submenu for translations

[![Metrics for News Logo](https://docs.metricsfornews.com/hs-fs/hubfs/Logo%2002-1.jpg?width=118&height=40&name=Logo%2002-1.jpg)](https://docs.metricsfornews.com/en/knowledge?hsLang=en)

Open main navigation

Close main navigation

- English
  
  Show submenu for translations
- [Go to metricsfornews.com](https://app.metricsfornews.com/home)

[Go to metricsfornews.com](https://app.metricsfornews.com/home)

 How can we help you?

- There are no suggestions because the search field is empty.

1. [Help Center](https://docs.metricsfornews.com/en/knowledge?hsLang=en)
2. [Metrics for News](https://docs.metricsfornews.com/en/knowledge/metrics-for-news?hsLang=en)
3. [Admins - Settings](https://docs.metricsfornews.com/en/knowledge/metrics-for-news?hsLang=en#admins-settings)

# Troubleshooting Guide

## Run a quick audit to ensure your app is set up for success

Ask yourself the questions below to troubleshoot or conduct a quality assurance check on your Metrics for News app. Ideal for those who just finished onboarding, but great any time if you simply want to do a quick check. 

If you find discrepancies, review the knowledge base articles and your settings. Note that not all scenarios mentioned may apply to your setup.  

\> [Content Import](https://docs.metricsfornews.com/en/knowledge/quality-assurance-guide#content)   
\> [Analytics Import](https://docs.metricsfornews.com/en/knowledge/quality-assurance-guide#analytics)   
\> [Engagement Scores & Baseline](https://docs.metricsfornews.com/en/knowledge/quality-assurance-guide#scores)   
\> [Authors & Users](https://docs.metricsfornews.com/en/knowledge/quality-assurance-guide#authors)   
\> [Dashboards](https://docs.metricsfornews.com/en/knowledge/quality-assurance-guide#dashboards)

---

### Content Import

- Do my [RSS feeds](https://docs.metricsfornews.com/en/knowledge/rss-feeds-and-content-importing?hsLang=en) and/or [custom import](https://docs.metricsfornews.com/en/knowledge/custom-imports?hsLang=en) files contain the stories I expect?
- Do my [RSS feeds](https://docs.metricsfornews.com/en/knowledge/rss-feeds-and-content-importing?hsLang=en) contain, at minimum, the most recent seven (7) days worth of content?
- Is my content importing as expected?
  
    - Review a random selection of stories from: 1) The most recent three days; 2) The past three months; and 3) My historical content import.
- Have I set the rules for content that should be ignored or excluded when importing (e.g., bylines, keywords, html elements, sections, etc.)?
  
    - Go to Settings \> [Publications](https://app.sourcematters.com/settings/publications) \> select Edit for the publication \> scroll down to Exclude content \> add rules here.
- For the [stories](https://app.metricsfornews.com/stories) that have been imported, do they appear as expected? 
  
    - Do stories with multiple authors display all of their names?
    - Do names with special characters appear correctly?
- Are the [page scraper settings](https://app.metricsfornews.com/settings/onboarding/scraping) working as expected?
  
    - Are author names captured with no other text (e.g., the name should appear as "Jane Smith" and not "By Jane Smith")?
    - Go to Settings \> Publication \> Edit \> Page scraper settings \> adjust the settings. Use “Preview page scraping” to see the results.

[Back to top](https://docs.metricsfornews.com/en/knowledge/quality-assurance-guide#top)

---

### Analytics Import

- Are my analytics importing as expected?
  
    - Review a random selection of stories from: 1) The most recent three days; 2) The past three months; and 3) My historical content import.
    - Are the analytics correct? Remember that pageviews in MFN represent a cumulative total since the story’s publication.
    - Consider running a [custom report](https://app.metricsfornews.com/report) to inspect your data from another viewpoint.
- Are my [custom metrics](https://docs.metricsfornews.com/en/knowledge/custom-metrics?hsLang=en) importing as expected?

[Back to top](https://docs.metricsfornews.com/en/knowledge/quality-assurance-guide#top)

---

### Engagement Scores & Baseline

- Have I selected all the individual metrics for my [engagement scores](https://docs.metricsfornews.com/en/knowledge/engagement-scores?hsLang=en)?
- Have I set the weights for each metric in my engagement scores?
- Have I set the engagement score scale?
- Are the engagement scores for my stories accurate?
- Does my [baseline](https://docs.metricsfornews.com/en/knowledge/the-baseline?hsLang=en) cover a time frame that has content on most days?

[Back to top](https://docs.metricsfornews.com/en/knowledge/quality-assurance-guide#top)

---

### Authors & Users

- Have I [set up my users](https://docs.metricsfornews.com/en/knowledge/how-to-add-an-author-user-and-connect-the-two?hsLang=en) with their intended permission levels?
  
    - Authors are connected to their user accounts?
    - Author types are created and authors assigned?
    - Teams created and authors assigned?
    - Team leaders have access to their team dashboards?
    - Assigned at least two (2) users with admin access?
- Are my authors’ "My Stories" page displaying data as expected?
  
    - Ask a few authors to check their personal dashboards. Are all of their stories present in the dashboard? Are the analytics accurate?

[Back to top](https://docs.metricsfornews.com/en/knowledge/quality-assurance-guide#top)

---

### Dashboards

- Are my content categories set up to help me [find the stories that spark engagement](https://docs.metricsfornews.com/en/knowledge/find-the-stories-that-spark-engagement?hsLang=en)?
- Is data in my dashboards appearing as expected? Go through each dashboard (e.g., Stories, Topics, Teams, etc.) and review the groupings, content, and analytics.
- Have I set my featured metrics (i.e., the blue boxes)? Go to Settings \> under Admin settings, select [General app settings](https://app.metricsfornews.com/settings/account) \> set the “Featured metrics” and “Featured story metrics.” Remember to save your changes!
  
    - If, upon saving, you receive the “duplicate metrics” error, please be sure to select a unique option for each metric, including the default ones.

![Screenshot of the featured metrics aka blue boxes.](https://docs.metricsfornews.com/hs-fs/hubfs/Screenshot%202026-03-09%20at%201.50.40%20PM.png?width=670&height=151&name=Screenshot%202026-03-09%20at%201.50.40%20PM.png)

[Back to top](https://docs.metricsfornews.com/en/knowledge/quality-assurance-guide#top)

- [Metrics for News](https://docs.metricsfornews.com/en/knowledge/metrics-for-news?hsLang=en#main-content)

    - [New user? Start here!](https://docs.metricsfornews.com/en/knowledge/metrics-for-news?hsLang=en#new-user-start-here)
    - [Analyzing Engagement](https://docs.metricsfornews.com/en/knowledge/metrics-for-news?hsLang=en#analyzing-engagement)
    - [Tracking Topics](https://docs.metricsfornews.com/en/knowledge/metrics-for-news?hsLang=en#tracking-topics)
    - [Admins - Content](https://docs.metricsfornews.com/en/knowledge/metrics-for-news?hsLang=en#admins-content)
    - [Admins - Analytics](https://docs.metricsfornews.com/en/knowledge/metrics-for-news?hsLang=en#admins-analytics)
    - [Admins - Authors & Users](https://docs.metricsfornews.com/en/knowledge/metrics-for-news?hsLang=en#admins-authors-users)
    - [Admins - Settings](https://docs.metricsfornews.com/en/knowledge/metrics-for-news?hsLang=en#admins-settings)
- [Source Matters](https://docs.metricsfornews.com/en/knowledge/source-matters?hsLang=en#main-content)

    - [New user? Start here!](https://docs.metricsfornews.com/en/knowledge/source-matters?hsLang=en#new-user-start-here)
    - [Source Management](https://docs.metricsfornews.com/en/knowledge/source-matters?hsLang=en#source-management)
    - [Leaders](https://docs.metricsfornews.com/en/knowledge/source-matters?hsLang=en#leaders)
    - [Admins](https://docs.metricsfornews.com/en/knowledge/source-matters?hsLang=en#admins)

[![api-logo-rgb-1000px-w-72ppi](https://docs.metricsfornews.com/hs-fs/hubfs/api-logo-rgb-1000px-w-72ppi.png?width=187&height=100&name=api-logo-rgb-1000px-w-72ppi.png "api-logo-rgb-1000px-w-72ppi")](https://americanpressinstitute.org/?hsLang=en)

**Metrics for News** & **Source Matters** *Help Center*

Copyright © 2026, American Press Institute