You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
[Due for payment 2026-03-11] [CFI] Update empty receipt section in the expense RHP #79189
Problem: We've seen many users manually uploading receipts (mostly PDFs) that could have been emailed to receipts@ and scanned/automatically matched with card transactions.
Solution: Update the empty receipt section of the RHP to educate users on the different routes for adding receipts to Expensify:
Please re-state the problem that we are trying to solve in this issue.
Users are manually uploading receipts (mostly PDFs) to expenses when they could instead email them to receipts@expensify.com or text them to 47777 for automatic scanning and matching with card transactions. The empty receipt section in the expense RHP (Right Hand Panel) only shows a clickable icon without any educational content about these alternative submission methods. This results in users missing out on faster, more convenient ways to attach receipts to their expenses.
What is the root cause of that problem?
The ReceiptEmptyState component at src/components/ReceiptEmptyState.tsx currently only renders a receipt icon with a plus symbol overlay. It has no text labels explaining what users can do or informing them about alternative methods.
Meanwhile, a ReceiptAlternativeMethods component already exists at src/components/ReceiptAlternativeMethods.tsx that displays exactly what the issue is asking for:
"Other ways to add receipts:" header
"Download the app to scan from your phone" option (conditionally shown if user hasn't logged into mobile app)
"Add your number to text receipts to 47777" or "Text receipts to 47777 (US numbers only)" depending on whether the user has a phone number associated with their account
This component is currently only rendered in IOURequestStepScan (the dedicated receipt upload/scan page at src/pages/iou/request/step/IOURequestStepScan/index.tsx), but it is not shown in the expense RHP where users view individual expenses with empty receipt slots.
The MoneyRequestReceiptView component at src/components/ReportActionItem/MoneyRequestReceiptView.tsx renders ReceiptEmptyState when shouldShowReceiptEmptyState is true, but does not include the ReceiptAlternativeMethods component or any explanatory text.
What changes do you think we should make in order to solve the problem?
Modify ReceiptEmptyState to display text labels when shown in the money request view context:
Add "Add a receipt" title text below the icon (using existing translation receipt.addReceipt)
Add "or drag and drop one here" subtitle on desktop only (using existing translation receipt.desktopSubtitleSingle and isMobile() check from @libs/Browser)
Only show these labels when the component is in money request view mode (using existing isInMoneyRequestView prop) and not in thumbnail mode (using existing isThumbnail prop)
Modify MoneyRequestReceiptView to include the ReceiptAlternativeMethods component:
Import and render ReceiptAlternativeMethods below the ReceiptEmptyState section when shouldShowReceiptEmptyState is true
Only show on desktop, not mobile (using isMobile() from @libs/Browser, matching the existing pattern in IOURequestStepScan where shouldHideAlternativeMethods includes an isMobile() check)
All required translations already exist in the codebase (receipt.addReceipt, receipt.desktopSubtitleSingle, and all receipt.alternativeMethods* keys), and the ReceiptAlternativeMethods component is fully implemented with proper conditional logic for showing/hiding options based on user state.
BugZero Checklist: The PR adding this new feature has been merged! The following checklist (instructions) will need to be completed before the issue can be closed:
[@DylanDylann] Please propose regression test steps to ensure the new feature will work correctly on production in further releases.
[@trjExpensify] Link the GH issue for creating/updating the regression test once above steps have been agreed upon.
I don't think this is above usual scope complexity to implement it correctly without redundancy. Especially as we're talking about a copy change on the empty state and then avoiding pushing to a dupe screen.
Issue is ready for payment but no BZ is assigned. @mallenexpensify you are the lucky winner! Please verify the payment summary looks correct and complete the checklist. Thanks!
Activity
melvin-bot commentedon Jan 9, 2026
Triggered auto assignment to Contributor-plus team member for initial proposal review - @DylanDylann (
External)melvin-bot commentedon Jan 9, 2026
Triggered auto assignment to @trjExpensify (
NewFeature), see https://stackoverflowteams.com/c/expensify/questions/14418#:~:text=BugZero%20process%20steps%20for%20feature%20requests for more details. Please add this Feature request to a GH project, as outlined in the SO. Remember to draft any necessary HelpDot updates by following the instructions here.melvin-bot commentedon Jan 9, 2026
Triggered auto assignment to Design team member for new feature review - @dannymcclain (
NewFeature)MobileMage commentedon Jan 9, 2026
Proposal
Please re-state the problem that we are trying to solve in this issue.
Users are manually uploading receipts (mostly PDFs) to expenses when they could instead email them to receipts@expensify.com or text them to 47777 for automatic scanning and matching with card transactions. The empty receipt section in the expense RHP (Right Hand Panel) only shows a clickable icon without any educational content about these alternative submission methods. This results in users missing out on faster, more convenient ways to attach receipts to their expenses.
What is the root cause of that problem?
The
ReceiptEmptyStatecomponent atsrc/components/ReceiptEmptyState.tsxcurrently only renders a receipt icon with a plus symbol overlay. It has no text labels explaining what users can do or informing them about alternative methods.Meanwhile, a
ReceiptAlternativeMethodscomponent already exists atsrc/components/ReceiptAlternativeMethods.tsxthat displays exactly what the issue is asking for:This component is currently only rendered in
IOURequestStepScan(the dedicated receipt upload/scan page atsrc/pages/iou/request/step/IOURequestStepScan/index.tsx), but it is not shown in the expense RHP where users view individual expenses with empty receipt slots.The
MoneyRequestReceiptViewcomponent atsrc/components/ReportActionItem/MoneyRequestReceiptView.tsxrendersReceiptEmptyStatewhenshouldShowReceiptEmptyStateis true, but does not include theReceiptAlternativeMethodscomponent or any explanatory text.What changes do you think we should make in order to solve the problem?
Modify
ReceiptEmptyStateto display text labels when shown in the money request view context:receipt.addReceipt)receipt.desktopSubtitleSingleandisMobile()check from@libs/Browser)isInMoneyRequestViewprop) and not in thumbnail mode (using existingisThumbnailprop)Modify
MoneyRequestReceiptViewto include theReceiptAlternativeMethodscomponent:ReceiptAlternativeMethodsbelow theReceiptEmptyStatesection whenshouldShowReceiptEmptyStateis trueisMobile()from@libs/Browser, matching the existing pattern inIOURequestStepScanwhereshouldHideAlternativeMethodsincludes anisMobile()check)All required translations already exist in the codebase (
receipt.addReceipt,receipt.desktopSubtitleSingle, and allreceipt.alternativeMethods*keys), and theReceiptAlternativeMethodscomponent is fully implemented with proper conditional logic for showing/hiding options based on user state.35 remaining items
melvin-bot commentedon Mar 4, 2026
BugZero Checklist: The PR adding this new feature has been merged! The following checklist (instructions) will need to be completed before the issue can be closed:
nkdengineer commentedon Mar 8, 2026
@trjExpensify, I think the price should be increased to $500 since the requirement has increased with this PR. Let me know your thoughts. Thanks.
trjExpensify commentedon Mar 10, 2026
I don't think this is above usual scope complexity to implement it correctly without redundancy. Especially as we're talking about a copy change on the empty state and then avoiding pushing to a dupe screen.
melvin-bot commentedon Mar 11, 2026
Issue is ready for payment but no BZ is assigned. @mallenexpensify you are the lucky winner! Please verify the payment summary looks correct and complete the checklist. Thanks!
melvin-bot commentedon Mar 11, 2026
Payment Summary
Upwork Job
BugZero Checklist (@mallenexpensify)
melvin-bot commentedon Mar 11, 2026
Payment Summary
Upwork Job
BugZero Checklist (@mallenexpensify)
trjExpensify commentedon Mar 12, 2026
Forgoing a regression test as it's a visual empty state update.
Payment summary as follows:
Go ahead and request, closing!
JmillsExpensify commentedon Mar 18, 2026
$250 approved for @DylanDylann
twisterdotcom commentedon Mar 19, 2026
@nkdengineer has submitted payment for this report on ND here.
SO: https://stackoverflowteams.com/c/expensify/questions/7582
Zapier Logs
Run ID: 00040eee-22e2-a0f6-969b-1e456dc6f3a4