Skip to content

[Due for payment 2026-03-11] [CFI] Update empty receipt section in the expense RHP #79189

Closed

Description

@garrettmknight

Coming from this conversation in migrate.

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:

Image
Issue OwnerCurrent Issue Owner: @trjExpensify

Activity

  1. added
    ExternalAdded to denote the issue can be worked on by a contributor
    NewFeatureSomething to build that is a new item.
    on Jan 9, 2026
  2. added
    Help WantedApply this label when an issue is open to proposals by contributors
    on Jan 9, 2026
  3. melvin-bot commented on Jan 9, 2026

    @melvin-bot

    Triggered auto assignment to Contributor-plus team member for initial proposal review - @DylanDylann (External)

  4. melvin-bot commented on Jan 9, 2026

    @melvin-bot

    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.

  5. melvin-bot commented on Jan 9, 2026

    @melvin-bot

    Triggered auto assignment to Design team member for new feature review - @dannymcclain (NewFeature)

  6. MobileMage commented on Jan 9, 2026

    @MobileMage
    Contributor

    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 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)
    • "Forward receipts to receipts@expensify.com" with a mailto link
    • "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?

    1. 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)
    2. 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.

  7. 35 remaining items

  8. melvin-bot commented on Mar 4, 2026

    @melvin-bot

    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.
  9. nkdengineer commented on Mar 8, 2026

    @nkdengineer
    Contributor

    @trjExpensify, I think the price should be increased to $500 since the requirement has increased with this PR. Let me know your thoughts. Thanks.

  10. trjExpensify commented on Mar 10, 2026

    @trjExpensify
    Contributor

    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.

  11. melvin-bot commented on Mar 11, 2026

    @melvin-bot

    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!

  12. melvin-bot commented on Mar 11, 2026

    @melvin-bot

    Payment Summary

    Upwork Job

    BugZero Checklist (@mallenexpensify)

    • (if NewFeature) I have created a PR for any necessary HelpDot updates, or I confirmed no updates are necessary.
    • I have verified the correct assignees and roles are listed above and updated the necessary manual offers
    • I have verified that there are no duplicate or incorrect contracts on Upwork for this job (https://www.upwork.com/ab/applicants//hired)
    • I have verified the PR was not reverted
    • I have applied any discounts due to bugs/regressions introduced by this PR
    • I have paid out the Upwork contracts or cancelled the ones that are incorrect
    • I have verified the payment summary above is correct
  13. melvin-bot commented on Mar 11, 2026

    @melvin-bot

    Payment Summary

    Upwork Job

    BugZero Checklist (@mallenexpensify)

    • (if NewFeature) I have created a PR for any necessary HelpDot updates, or I confirmed no updates are necessary.
    • I have verified the correct assignees and roles are listed above and updated the necessary manual offers
    • I have verified that there are no duplicate or incorrect contracts on Upwork for this job (https://www.upwork.com/ab/applicants//hired)
    • I have verified the PR was not reverted
    • I have applied any discounts due to bugs/regressions introduced by this PR
    • I have paid out the Upwork contracts or cancelled the ones that are incorrect
    • I have verified the payment summary above is correct
  14. trjExpensify commented on Mar 12, 2026

    @trjExpensify
    Contributor

    Forgoing a regression test as it's a visual empty state update.

    Payment summary as follows:

    Go ahead and request, closing!

  15. JmillsExpensify commented on Mar 18, 2026

    @JmillsExpensify
    Contributor

    $250 approved for @DylanDylann

  16. twisterdotcom commented on Mar 19, 2026

    @twisterdotcom
    Contributor

    @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
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Labels

Awaiting PaymentAuto-added when associated PR is deployed to productionDailyKSv2ExternalAdded to denote the issue can be worked on by a contributorNewFeatureSomething to build that is a new item.

Type

No type

Projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions