Set Document Name Matching Policy
Start with Balanced mode. Most hotels complete setup in under 3 minutes.
This guide helps you control how strictly AVA compares reservation names with passport or ID names.
Where to Find It
Settings → Security → General Settings → Document Name MatchingQuick Reference
| Setting | What It Controls | Typical Outcome |
|---|---|---|
| Strict | Highest match strictness | More guests go to front desk review |
| Balanced | Default match strictness | Good security with smoother self check-in |
| Lenient | Lower match strictness | More abbreviated names pass automatically |
| Custom | Manual thresholds and rules | Outcome depends on your configured values |
Set the Matching Mode
-
In Document Name Matching, choose a mode
-
Review the scenario preview cards
-
Click Save General Settings
✓ Your selected policy applies to new check-in attempts.
The preview cards now use the standard curated scenarios. Strict, Balanced, and Lenient show the same example list.
Tune Custom Mode
Use Custom mode when your team has a defined review SOP.
- Choose Custom
- Set Base similarity threshold (80-95)
- Choose whether to allow:
- Initial + surname prefix matching
- Alias name matching
- Set abbreviation controls:
- Minimum surname prefix length (3-6)
- Minimum surname coverage (0.30-0.80)
- Require two tokens
- Require single-character initial
- Click Save General Settings
Automatic Safety Rules
AVA normalizes document matching values when you save:
- Invalid mode values reset to Balanced
- Custom threshold must stay between 80-95
- Minimum surname prefix length must stay between 3-6
- Minimum surname coverage must stay between 0.30-0.80
"true"and"false"text values are converted to real toggles
✓ If you enter out-of-range values, AVA saves corrected values.
Common Examples
| Name Pair | Strict | Balanced | Lenient |
|---|---|---|---|
| "John Michael Doe" vs "John Michael Doe" | ✓ Pass | ✓ Pass | ✓ Pass |
| "M Taka" vs "Mitsui Takafumi" | ❌ Review | ✓ Pass | ✓ Pass |
| "K Taka" vs "Mitsui Takafumi" | ❌ Review | ❌ Review | ❌ Review |
| "A Kumar" vs "Arun Kumar" | ❌ Review | ✓ Pass | ✓ Pass |
| Alias or married name case | ❌ Review | ✓ Pass | ✓ Pass |
Lenient mode can reduce front desk workload, but it also accepts more borderline name patterns.
Troubleshooting
Too many guests are sent to review
What you see: Many valid guests are redirected to staff review.
Fix:
- Switch Strict to Balanced
- In Custom, lower threshold slightly
- Enable abbreviation matching if OTA names are often shortened
Too many abbreviated names are passing
What you see: You want tighter screening for short names.
Fix:
- Switch Lenient to Balanced or Strict
- Increase threshold in Custom
- Increase surname prefix length or coverage
Changes do not appear to apply
What you see: Results look unchanged after editing.
Fix:
- Click Save General Settings again
- Refresh the page
- Test with a new check-in flow
Custom values changed after saving
What you see: A saved custom value looks different from what you entered.
Fix:
- Re-open Document Name Matching
- Compare your values against allowed ranges
- Use values inside the range and save again
Still Stuck?
Contact success@vouch-technologies.com if:
- ❌ Name matching results stay inconsistent after retries
- ❌ Settings save successfully but behavior does not change
- ❌ You need help tuning custom values for local compliance rules
Helpful details to include:
- Your selected mode
- Custom values (if used)
- 2-3 example reservation vs document name pairs