Camera UI Customization

All visible strings in the Paper Receipt camera UI are defined as Android string resources. Override them in your app's res/values/strings.xml to customize copy, or add a locale-specific file to provide translations. Redeclaring a key by name in your own app wins over the SDK's value — there is no registration step.

String Resource Reference

String key	Default (English)
scan_characteristics_option_date	Date
scan_characteristics_option_total	Total
scan_characteristics_option_merchant	Merchant
scan_characteristics_option_subtotal	Subtotal
scan_characteristics_option_taxes	Taxes
scan_characteristics_option_time	Time
scan_characteristics_option_store_address	Store Address
scan_characteristics_option_store_city	Store City
scan_characteristics_option_store_country	Store Country
scan_characteristics_option_store_state	Store State
scan_characteristics_option_store_zip	Store Zip
scan_characteristics_option_store_phone	Store Phone
recognizer_camera_long_receipt_add_photos_hint	Long receipt? Take multiple photos.
recognizer_align_image_hint	Start next photo here.
recognizer_finding_receipt_suggestion	Finding your receipt…
recognizer_blurry_image_tooltip	The image is a bit blurry. Try retaking the photo for a clearer result.
recognizer_missing_data_tooltip †	No receipt detected. Please try again.
recognizer_permission_dialog_title	Camera access needed
recognizer_permission_dialog_message	This app needs access to your camera to continue.
recognizer_grant_access	Grant Access
recognizer_permission_dialog_title_permanently_denied	Camera permission required
recognizer_permission_dialog_message_permanently_denied	Camera access is currently disabled. Enable it in Settings to continue.
recognizer_permission_dialog_positive_button_permanently_denied	Go to Settings
recognizer_permission_dialog_negative_button	Cancel

^† Only shown when TooltipCharacteristics.Builder().displayDataMissingTooltip(true) is set. It defaults to false, so this string does not render unless you opt in — see Configuring tooltips.

Keys removed in Paper Receipt SDK 2.3.1

If you override any of these, the override is now unused and can be deleted. Removing a translation for a key the SDK no longer defines has no effect on your build.

recognizer_receipt_edge · recognizer_camera_initial_instruction · recognizer_move_closer_suggestion · recognizer_move_further_suggestion · recognizer_blurry_image_btn

The default English text also changed for recognizer_blurry_image_tooltip, recognizer_camera_long_receipt_add_photos_hint, and recognizer_missing_data_tooltip. If you translated the old wording, review those three.

Adding a Translation

1. Right-click the res folder in Android Studio → New → Android Resource File.
2. Set the Resource type to Values.
3. Under Available qualifiers, select Locale, choose your target language and optional region, then click OK.
4. Android Studio creates a file at res/values-<locale>/strings.xml. Add only the keys you want to override — any key omitted falls back to the default English value.

Example — German (res/values-de/strings.xml):

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string name="scan_characteristics_option_date">Datum</string>
    <string name="scan_characteristics_option_total">Gesamt</string>
    <string name="scan_characteristics_option_merchant">Händler</string>
    <string name="scan_characteristics_option_subtotal">Zwischensumme</string>
    <string name="scan_characteristics_option_taxes">Steuern</string>
    <string name="scan_characteristics_option_time">Zeit</string>
    <string name="scan_characteristics_option_store_address">Adresse des Geschäfts</string>
    <string name="scan_characteristics_option_store_city">Stadt des Geschäfts</string>
    <string name="scan_characteristics_option_store_country">Land des Geschäfts</string>
    <string name="scan_characteristics_option_store_state">Staat des Geschäfts</string>
    <string name="scan_characteristics_option_store_zip">Postleitzahl des Geschäfts</string>
    <string name="scan_characteristics_option_store_phone">Telefon des Geschäfts</string>
    <string name="recognizer_camera_long_receipt_add_photos_hint">Lange Quittung? Machen Sie mehrere Fotos.</string>
    <string name="recognizer_align_image_hint">Beginnen Sie hier mit dem nächsten Foto.</string>
    <string name="recognizer_finding_receipt_suggestion">Quittung wird gesucht…</string>
    <string name="recognizer_blurry_image_tooltip">Das Bild ist etwas unscharf. Machen Sie das Foto für ein klareres Ergebnis erneut.</string>
    <string name="recognizer_missing_data_tooltip">Keine Quittung erkannt. Bitte versuchen Sie es erneut.</string>
    <string name="recognizer_permission_dialog_title">Kamerazugriff erforderlich</string>
    <string name="recognizer_permission_dialog_message">Diese App benötigt Zugriff auf Ihre Kamera, um fortzufahren.</string>
    <string name="recognizer_grant_access">Zugriff gewähren</string>
    <string name="recognizer_permission_dialog_title_permanently_denied">Kameraerlaubnis erforderlich</string>
    <string name="recognizer_permission_dialog_message_permanently_denied">Der Kamerazugriff ist derzeit deaktiviert. Aktivieren Sie ihn in den Einstellungen, um fortzufahren.</string>
    <string name="recognizer_permission_dialog_positive_button_permanently_denied">Gehen Sie zu Einstellungen</string>
    <string name="recognizer_permission_dialog_negative_button">Abbrechen</string>
</resources>

For more information, see Android's official Localize your app guide.