Rules - Unable to save empty merchant field

[vincdargento]

If you haven’t already, check out our contributing guidelines for onboarding and email contributors@expensify.com to request to join our Slack channel!

---

Version Number: 9.3.31-0
Reproducible in staging?: Yes
Reproducible in production?: N/A - new feature, doesn't exist in prod
If this was caught during regression testing, add the test name, ID and link from BrowserStack: #83005
Email or phone of affected tester (no customers): sodijsojosjsdoj@gmail.com
Issue reported by: Applause Internal Team
Bug source: Exploratory - Significant User Experience Deterioration
Device used: Mac 26.2 / Chrome
App Component: Workspace Settings

Action Performed:

Precondition:

• Rules are enabled.

1. Go to staging.new.expensify.com
2. Go to workspace settings > Rules.
3. Click Add merchant rule.
4. Click Merchant field under "Apply these updates".
5. Enter anything and save it.
6. Click the same Merchant field.
7. Clear the field and save it.

Expected Result:

User should be able to clear the field and save it in case they decide not to make any changes to merchant.

Actual Result:

User cannot clear Merchant field once it has been saved with value.
In order to clear it, user will need to close the RHP and restart the process.

Workaround:

Unknown

Platforms:

• Android: App
• Android: mWeb Chrome
• iOS: App
• iOS: mWeb Safari
• iOS: mWeb Chrome
• Windows: Chrome
• MacOS: Chrome / Safari

Screenshots/Videos

bug.mp4

View all open jobs on GitHub

Issue Owner

Current Issue Owner: @luacmartins

[melvin-bot]

You have been assigned to this deploy blocker because you recently merged this PR: #83005

[melvin-bot]

💬 A slack conversation has been started in #expensify-open-source

[melvin-bot]

Triggered auto assignment to @dylanexpensify (Bug), see https://stackoverflow.com/c/expensify/questions/14418 for more details. Please add this bug to a GH project, as outlined in the SO.

[github-actions]

👋 Friendly reminder that deploy blockers are time-sensitive ⏱ issues! Check out the open `StagingDeployCash` deploy checklist to see the list of PRs included in this release, then work quickly to do one of the following:

1. Identify the pull request that introduced this issue and revert it.
2. Find someone who can quickly fix the issue.
3. Fix the issue yourself.

[OSBotify]

Investigation Summary

Classification: Frontend bug
Causing PR: #81205 - "fix Expense - Merchant can be made empty by using Expense as Merchant in expense rule" by @situchan (High confidence)
Related PRs: #83005 - "Enable merchant rules v3" (exposed the issue by removing production gate)

Recommendation: ROLL FORWARD

The bug exists in validation logic added by PR #81205 (merged Feb 3), but was only exposed when PR #83005 removed the production gate for merchant rules. The issue is that the validation incorrectly prevents users from clearing the merchant field once a value has been saved.

Root Cause: The validation in src/components/Rule/TextBase.tsx calls isInvalidMerchantValue(trimmedValue) for non-required merchant fields. This function returns true for empty strings, which prevents users from clearing the field. The validation should only check for invalid values when the field is NOT empty.

Rolling forward with a fix is more appropriate than reverting because:

1. PR fix Expense - Merchant can be made empty by using Expense as Merchant in expense rule #81205 was merged over a month ago (Feb 3) and is not in this deploy
2. Multiple subsequent PRs have built on this code
3. The fix is straightforward: skip isInvalidMerchantValue check when the field is empty and not required

Labels: No label changes needed. This is reproducible only on staging (new feature), and it is a frontend bug that requires an App PR to fix. DeployBlockerCash should remain.

Detailed Analysis

Evidence

Looking at the issue reproduction steps:

• User fills the Merchant field under "Apply these updates" with a value
• Saves it successfully
• Tries to clear the field and save again
• Gets an "Invalid merchant" error

The video shows this behavior clearly - the user cannot submit when the merchant field is cleared.

Verification

The affected file is /home/runner/_work/App/App/src/components/Rule/TextBase.tsx, specifically the validation function starting at line 48.

PR #81205 added this validation code (lines 65-69):

} else if (fieldID === CONST.EXPENSE_RULES.FIELDS.RENAME_MERCHANT || fieldID === CONST.MERCHANT_RULES.FIELDS.MERCHANT) {
    if (isInvalidMerchantValue(trimmedValue)) {
        (errors as Record<string, string>)[fieldID] = translate("iou.error.invalidMerchant");
    }
}

The isInvalidMerchantValue function in src/libs/ValidationUtils.ts (line 775) is defined as:

function isInvalidMerchantValue(merchant?: string): boolean {
    return merchant === "" || merchant === CONST.TRANSACTION.PARTIAL_TRANSACTION_MERCHANT || merchant === CONST.TRANSACTION.DEFAULT_MERCHANT;
}

Notice it returns true when merchant is an empty string "".

Root Cause

The merchant field in AddMerchantPage is NOT marked as required (isRequired is not passed to RuleTextBase). However, the validation logic validates empty strings as "invalid" even for optional fields.

The correct behavior should be:

• If the field is empty and NOT required: allow it (no error)
• If the field is empty and IS required: show "field required" error
• If the field has a value: validate that value

The current code validates empty strings as "invalid merchant" instead of allowing them for optional fields. The validation should be:

} else if (fieldID === CONST.EXPENSE_RULES.FIELDS.RENAME_MERCHANT || fieldID === CONST.MERCHANT_RULES.FIELDS.MERCHANT) {
    if (trimmedValue && isInvalidMerchantValue(trimmedValue)) {  // Only check if not empty
        (errors as Record<string, string>)[fieldID] = translate("iou.error.invalidMerchant");
    }
}