From cac9d300969486ede473bd1f46f741e5008f27d9 Mon Sep 17 00:00:00 2001
From: "Alex Beaman (via MelvinBot)" <infra+melvinbot@expensify.com>
Date: Tue, 23 Jun 2026 22:21:52 +0000
Subject: [PATCH] Docs: document the inline Explain link on SmartScan failure
 messages

Co-authored-by: Alex Beaman <Beamanator@users.noreply.github.com>
---
 .../Troubleshoot-SmartScan-Issues.md            | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/docs/articles/new-expensify/reports-and-expenses/Troubleshoot-SmartScan-Issues.md b/docs/articles/new-expensify/reports-and-expenses/Troubleshoot-SmartScan-Issues.md
index b967980e5313..e08d82f13dd3 100644
--- a/docs/articles/new-expensify/reports-and-expenses/Troubleshoot-SmartScan-Issues.md
+++ b/docs/articles/new-expensify/reports-and-expenses/Troubleshoot-SmartScan-Issues.md
@@ -29,6 +29,23 @@ If SmartScan cannot confidently read these required fields, the scan will fail a
 
 ---
 
+## How to understand why a SmartScan failed
+
+When a scan fails, an **Explain** link appears after the failure message in the transaction thread.
+
+1. Open the transaction thread for the expense with the failed scan.
+2. Select **Explain** after the "Receipt scanning failed" message.
+
+A thread opens and Concierge replies with a field-aware explanation that references the specific fields it couldn't read, so you know exactly what to fix before retrying or entering the details manually.
+
+<!-- SCREENSHOT:
+Suggestion: Transaction thread showing the "Receipt scanning failed — missing ... Enter details manually." message with the inline Explain link beside it.
+Location: Under "How to understand why a SmartScan failed".
+Purpose: Show users where the Explain link appears on a failed scan message.
+-->
+
+---
+
 ## How to fix when SmartScan fails to complete a scan
 
 SmartScan may fail if the receipt image is unreadable, or if the image is missing a clear expense date or amount.