> For the complete documentation index, see [llms.txt](https://matterhorn-doc.mometic.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://matterhorn-doc.mometic.com/keep-research-current/troubleshooting.md).

# Troubleshooting

Resolve common Matterhorn questions about missing companies, unavailable ML predictions, unchanged rankings, stale reviews, and citation warnings.

| What you see                                  | What to check first                                                                                                           |
| --------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| Research could not be loaded                  | Open the running application and use **Retry** when offered                                                                   |
| Could not refresh research                    | Previous results remain visible; use **Retry**, then check their dates                                                        |
| No company matches                            | Clear all active Companies filters, check the ticker, then consider Analyze                                                   |
| A company exists but has no score             | Inspect evidence readiness and whether any applicable component is measurable                                                 |
| ML unavailable for one company                | It may be outside the frozen bundle or have an identity/share-class mismatch                                                  |
| ML turns off after loading                    | Read the header help message; the bundle may have failed integrity or identity checks                                         |
| ML ranks do not move after Analyze            | Source refresh and new ML publication are separate steps                                                                      |
| A chart has a missing axis                    | Hover the legend; missing coverage is deliberately shown as a gap                                                             |
| Comparison still shows five axes              | Confirm ML enhanced is on, then reopen Compare                                                                                |
| A section still looks standard in ML mode     | Check the [mode-change table](/understand-the-scores/ml-enhanced.md); not every section changes                               |
| Ask is missing                                | Select **Show** above Top 10 on Overview; it starts collapsed                                                                 |
| A theme company list differs from Top 10      | Theme lists sort matching companies by opportunity score, or ML score when enabled; standard Top 10 uses an adjusted ordering |
| Ask returns records rather than prose         | A language model may be unavailable; retrieval can still work                                                                 |
| Analyst review looks old                      | Check its timestamp and use **Run review** for a refreshed dossier-based review                                               |
| Citation warning persists                     | Inspect the specific fact and claim; do not treat the prose as verified                                                       |
| Watchlist differs on another device           | Pins are browser-local and not account-synchronized                                                                           |
| History figures differ from the main ML score | The **Matterhorn score · 7 days** line tracks the underlying standard score, separately from the frozen ML prediction         |
| Demand growth looks extreme                   | Check scope, period, denominator, and current-versus-total balances                                                           |
| Data seems stale although a job succeeded     | Check the reporting period in Evidence or Filings, the review timestamp, and the ML data date separately                      |

## Recover a research view that did not load

Use the running Matterhorn application, rather than opening a downloaded HTML file. If the page says it was opened as a file, select **Open Matterhorn**.

A failed initial load shows an error instead of leaving the Overview loading indicators running. A failed refresh keeps existing results visible and offers **Retry**. Retrying reloads stored research; it does not fetch new filings or retrain the model. Check the displayed dates after recovery.

## Report a useful issue

Include the ticker, scoring mode, date shown, panel name, expected interpretation, and what appeared instead. For evidence issues, include the metric, fact ID if present, and source link. A cropped screenshot is helpful; omit credentials and unrelated personal information.

> **Pro Tip — Make the discrepancy reproducible.** “AMD, ML on, September 5 snapshot, valuation axis missing while the ordinary checklist has EV/sales” is specific enough to explain or investigate. “The model is wrong” is not yet a testable issue.

Related: [refreshing research](/keep-research-current/refresh-and-freshness.md), [FAQ](/reference/faq.md).