> For the complete documentation index, see [llms.txt](https://docs.caf.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.caf.io/caf-sdk/react-native/document-smart-capture/text-customization.md).

# Text Customization

The strings the Smart Capture flow renders — instructions, buttons, error messages and accessibility labels — can be replaced with your own wording, without forking the SDK.

{% hint style="warning" %}
In React Native the flow config is TypeScript, but text is customized per platform:

* Android: override string resources in `android/app/src/main/res/`. `customLocalization` is ignored.
* iOS: pass `customLocalization` (your `.strings` table name) on `CerttaSmartCaptureConfiguration`.
  {% endhint %}

{% tabs %}
{% tab title="Android" %}

## Overview

Every text shown in the Smart Capture flow is a normal Android string resource with a fixed resource ID. You ship your own wording by declaring a string with the same name in the React Native Android app module. You only include the keys you actually want to change; everything else keeps the SDK’s own translation.

This works because of how Android merges resources: when your app and the Smart Capture library both declare a string with the same name, your app’s resource wins at build time. No runtime API — `customLocalization` on the TypeScript config does nothing on Android.

Resource IDs are internal to the current native SDK version and may change between releases. Re-check this list after upgrading.

### API

Android does not use a TypeScript field for strings. Customization is the resource name:

| Mechanism                | Where                                                                 | Description                                                            |
| ------------------------ | --------------------------------------------------------------------- | ---------------------------------------------------------------------- |
| String resource override | `android/app/src/main/res/values/strings.xml` (or `values-<locale>/`) | Declare a `<string>` (or `<plurals>`) with the same `name` as the SDK. |

When you don’t declare a given name, the SDK uses its own string.

```xml
<!-- android/app/src/main/res/values/strings.xml -->
<resources>
    <string name="certta_smart_capture_instructions_title">Get your ID ready</string>
    <string name="certta_smart_capture_select_validation_type_capture_title">Open camera</string>
</resources>
```

Everything else on those screens keeps the SDK’s own wording.

### Adding your strings

1. Create or reuse `strings.xml` in the Android app module — `android/app/src/main/res/values/` and, for each locale, `values-<locale>/`.
2. Add only the keys you want to override. Omitted keys are not an error and do not render a raw key on screen.
3. Rebuild the app. Your resources replace the SDK defaults automatically.

```xml
<!-- android/app/src/main/res/values-pt/strings.xml -->
<resources>
    <string name="certta_smart_capture_camera_intro_hint">Escaneie seu documento agora</string>
</resources>
```

### Resolution order

For each key, Android resolves in this order:

1. Your app’s string with that resource ID, in the locale folder that matches the device language.
2. Your app’s string with that ID in the default `values/` folder (if you overrode it there).
3. The SDK’s own table for the device language.
4. The SDK default, which is English.

Partial overrides are supported and recommended. Declaring a name that the SDK doesn’t use is ignored.

The SDK ships English, Spanish and Portuguese. On a device whose language is none of these, the SDK’s text is shown in English.

### Localization

The language shown follows the device locale against the resource folders your app packages. Smart Capture does not expose a language switch of its own.

| Locale                     | Resource folder |
| -------------------------- | --------------- |
| English (default/fallback) | `values/`       |
| Spanish                    | `values-es/`    |
| Portuguese                 | `values-pt/`    |

#### Adding a language the SDK does not ship

Create `values-<locale>/strings.xml` in the Android app module and override the keys the user will see. Keys you omit fall back to English, so translate every key that should appear in that language.

```xml
<!-- android/app/src/main/res/values-fr/strings.xml -->
<resources>
    <string name="certta_smart_capture_instructions_title">Préparez votre document</string>
    <!-- remaining certta_smart_capture_* keys -->
</resources>
```

{% hint style="info" %}
See Android’s [Localization guide — Creating alternative resources](https://developer.android.com/guide/topics/resources/localization#creating-alternatives).
{% endhint %}

### Format specifiers

{% hint style="warning" %}
Some values contain format placeholders — `%s`, `%1$d`, `{doc}` — or ICU plurals / select (gender) blocks, e.g.&#x20;
{% endhint %}

`certta_smart_capture_camera_wrong_document_back_expected_hint`. Your replacement must keep the same placeholders and structure. Dropping them, or changing plural `<item>` quantities, produces wrong output at runtime.

### Key reference

All keys are prefixed `certta_smart_capture_` to avoid collisions. Values shown are the English defaults.

#### Capture instructions

```xml
<string name="certta_smart_capture_camera_intro_hint">Scan your document</string>
<string name="certta_smart_capture_camera_center_document_hint">Center the document</string>
<string name="certta_smart_capture_camera_come_closer_hint">Come closer</string>
<string name="certta_smart_capture_camera_step_back_hint">Step back a bit</string>
<string name="certta_smart_capture_camera_ask_to_frozen_hint">Capturing… Hold still</string>
<string name="certta_smart_capture_camera_manual_capture_announcement">Automatic capture ended. You can take the photo manually.</string>
<string name="certta_smart_capture_camera_turn_document_hint">Turn the document over</string>
<string name="certta_smart_capture_camera_uploading_document">Sending the document…</string>
<string name="certta_smart_capture_camera_captured_with_success">Document successfully validated.</string>
<string name="certta_smart_capture_camera_generic_error_message">Could not validate. Please try again.</string>
<string name="certta_smart_capture_camera_photo_content_description">Capture photo</string>
<string name="certta_smart_capture_camera_or_last_param">" or "</string>
<string name="certta_smart_capture_camera_error_prefix">Alert: </string>
```

#### Invalid document messages

```xml
<string name="certta_smart_capture_camera_doc_not_accepted_alert_error">Use %s</string>
<string name="certta_smart_capture_camera_wrong_document_back_expected_hint">Capture the back of the {doc}</string>
<string name="certta_smart_capture_camera_wrong_document_front_expected_hint">Capture the front of the {doc}</string>
```

#### Document type names

```xml
<string name="certta_smart_capture_cnh">CNH</string>
<string name="certta_smart_capture_rg">RG</string>
<string name="certta_smart_capture_cin">CIN</string>
<string name="certta_smart_capture_rnm">RNM</string>
<string name="certta_smart_capture_rne">RNE</string>
<string name="certta_smart_capture_ctps">CTPS</string>
<string name="certta_smart_capture_crlv">CRLV</string>
<string name="certta_smart_capture_passport">Passport</string>
<string name="certta_smart_capture_any_document">Any document</string>
```

#### Document accessibility labels

```xml
<string name="certta_smart_capture_doc_cnh_content_description">National Driver\'s License (CNH)</string>
<string name="certta_smart_capture_doc_cin_content_description">National Identity Card (CIN)</string>
<string name="certta_smart_capture_doc_rg_content_description">General Registry Identity Card (RG)</string>
<string name="certta_smart_capture_doc_rnm_content_description">National Migration Registry (RNM)</string>
<string name="certta_smart_capture_doc_ctps_content_description">Work and Social Security Booklet (CTPS)</string>
<string name="certta_smart_capture_doc_crlv_content_description">Vehicle Registration Certificate (CRLV)</string>
<string name="certta_smart_capture_doc_rne_content_description">National Foreigner Registry (RNE)</string>
```

#### Capture preview

```xml
<string name="certta_smart_capture_preview_title">Check your photo</string>
<string name="certta_smart_capture_preview_hint">"Check that it is clear and without reflections. "</string>
<string name="certta_smart_capture_preview_take_picture_again">Photograph again</string>
<string name="certta_smart_capture_preview_send_picture">Send capture</string>
```

#### Instructions carousel — shared

```xml
<string name="certta_smart_capture_instructions_title">Prepare your document</string>
<string name="certta_smart_capture_instructions_description">Takes less than 1 minute.</string>
<string name="certta_smart_capture_instructions_skip_tips">Skip tips</string>
<string name="certta_smart_capture_instructions_next_tips">Next tip</string>
<string name="certta_smart_capture_instructions_tab_content_description">Tip %1$d of %2$d</string>
<plurals name="certta_smart_capture_instructions_accepted_documents_format">
    <item quantity="one">%2$s is accepted</item>
    <item quantity="other">%s and %s are accepted</item>
</plurals>
```

#### Instructions carousel — capture mode

```xml
<string name="certta_smart_capture_instructions_capture_1_title">Start with any side</string>
<string name="certta_smart_capture_instructions_capture_1_description">Front, back, or open document. We identify the side automatically.</string>
<string name="certta_smart_capture_instructions_capture_2_title">Keep the edges visible</string>
<string name="certta_smart_capture_instructions_capture_2_description">Fit all four corners of the document and avoid tilting your phone.</string>
<string name="certta_smart_capture_instructions_capture_3_title">Ensure clarity</string>
<string name="certta_smart_capture_instructions_capture_3_description">Avoid reflections and shadows. Legible data speeds up your approval.</string>
```

#### Instructions carousel — upload mode

```xml
<string name="certta_smart_capture_instructions_upload_1_title">Upload image or PDF</string>
<string name="certta_smart_capture_instructions_upload_1_description">Upload photos from your gallery or digital files saved on your device.</string>
<string name="certta_smart_capture_instructions_upload_2_title">Upload one or two files</string>
<string name="certta_smart_capture_instructions_upload_2_description">Upload the complete document or select both front and back at once.</string>
```

#### Validation method selection

```xml
<string name="certta_smart_capture_select_validation_type_title">Choose how to validate your document</string>
<string name="certta_smart_capture_select_validation_type_upload_title">Attach document</string>
<string name="certta_smart_capture_select_validation_type_upload_description">Upload document files you have on your device</string>
<string name="certta_smart_capture_select_validation_type_capture_title">Take photo</string>
<string name="certta_smart_capture_select_validation_type_capture_description">Photograph your document now</string>
<string name="certta_smart_capture_validation_type_toolbar_navigate_up">Navigate up</string>
```

#### Camera help sheet

```xml
<string name="certta_smart_capture_camera_help_title">Need help?</string>
<string name="certta_smart_capture_camera_help_instruction_title_1">Frame the edges</string>
<string name="certta_smart_capture_camera_help_instruction_description_1">Do not let the document leave the screen.</string>
<string name="certta_smart_capture_camera_help_instruction_title_2">Avoid reflections</string>
<string name="certta_smart_capture_camera_help_instruction_description_2">Look for a place with indirect light.</string>
<string name="certta_smart_capture_camera_help_instruction_title_3">Legible data</string>
<string name="certta_smart_capture_camera_help_instruction_description_3">Make sure the data is legible.</string>
<string name="certta_smart_capture_camera_help_instruction_hint">Or, if you prefer, attach the document file.</string>
<string name="certta_smart_capture_camera_help_confirm_button">Keep taking photos</string>
```

#### Permission denied screen

```xml
<string name="certta_smart_capture_permission_denied_title">Camera access required.</string>
<string name="certta_smart_capture_permission_denied_description">To continue, you need to manually allow access in your phone settings.</string>
<string name="certta_smart_capture_permission_denied_instructions"><![CDATA[1. Tap the <b>Open settings</b> button below to open Settings.<br>2. On the screen that opens, tap <b>Permissions</b>.<br>3. Select <b>Camera</b>, choose <b>Allow only while using the app</b>, and return to the app.]]></string>
<string name="certta_smart_capture_permission_denied_instructions_title">Step by step</string>
<string name="certta_smart_capture_permission_denied_instructions_config_button">Open Settings</string>
```

#### Upload review screen

```xml
<string name="certta_smart_capture_upload_title">Check your document</string>
<string name="certta_smart_capture_upload_first_file_title">First file</string>
<string name="certta_smart_capture_upload_second_file_title">Second file (optional)</string>
<string name="certta_smart_capture_upload_attach">Attach document</string>
<string name="certta_smart_capture_upload_none_document_attached">No document attached</string>
<string name="certta_smart_capture_upload_document_hint">Attach one file with the complete document or two files for the front and back.</string>
<string name="certta_smart_capture_upload_document_send_doc">Send document</string>
<string name="certta_smart_capture_upload_add_back_to_complete"><![CDATA[Add the <b>back of {doc}</b> to complete the upload.]]></string>
<string name="certta_smart_capture_upload_add_front_to_complete"><![CDATA[Add the <b>front of {doc}</b> to complete the upload.]]></string>
<string name="certta_smart_capture_upload_eye_content_description">View %s</string>
<string name="certta_smart_capture_upload_remove_content_description">Delete %s</string>
```

#### Upload — delete file sheet

```xml
<string name="certta_smart_capture_upload_remove_confirmation_title">Do you want to delete the file?</string>
<string name="certta_smart_capture_upload_remove_confirmation_message">If you confirm the deletion, you will need to add a file again. Are you sure?</string>
<string name="certta_smart_capture_upload_remove_confirmation_delete">Delete file</string>
<string name="certta_smart_capture_upload_remove_confirmation_keep">Keep file</string>
```

#### Upload — validation alerts

```xml
<string name="certta_smart_capture_upload_files_limit_error_title">File limit</string>
<string name="certta_smart_capture_upload_files_limit_error_message">Select a maximum of 2 files.</string>
<string name="certta_smart_capture_upload_files_limit_error_confirm_button">Got it</string>
<string name="certta_smart_capture_upload_file_size_error">Use files with a maximum of 10 MB.</string>
<string name="certta_smart_capture_upload_preview_error">Could not open file preview. Please try again.</string>
<string name="certta_smart_capture_upload_generic_error">Could not validate your document. Try again.</string>
<string name="certta_smart_capture_upload_first_file_format_error"><![CDATA[<b>First file</b>: ]]></string>
<string name="certta_smart_capture_upload_second_file_format_error"><![CDATA[<b>Second file</b>: ]]></string>
```

#### Success screen

```xml
<string name="certta_smart_capture_success_title">All set!</string>
<string name="certta_smart_capture_success_description_text">"You have successfully completed all the steps!"</string>
```

#### Shared / generic

```xml
<string name="certta_smart_capture_close_button">Close</string>
<string name="certta_smart_capture_continue_text">Continue</string
```

{% endtab %}

{% tab title="iOS" %}

## Overview

The strings the Smart Capture flow renders — instructions, buttons, error messages and most VoiceOver labels — can be replaced with your own wording, without forking the SDK.

You ship a `.strings` table in the iOS app target and tell the SDK its name via TypeScript. You only include the keys you actually want to change; everything else keeps the SDK’s own translation.

Two pieces of text are outside this table: the document type abbreviations (RG, CNH, RNE, CTPS, CRLV) and the camera-denied screen, which is shared with other CAF products. Neither can be changed through `customLocalization`.

### API

React Native exposes one optional field on `CerttaSmartCaptureConfiguration`:

| Parameter            | Type     | Default | Description                                                                                                          |
| -------------------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------------- |
| `customLocalization` | `string` | `null`  | Name of your `.strings` table — the filename without the extension. Loaded from the main app bundle (`Bundle.main`). |

When `customLocalization` is omitted, the SDK uses its own strings.

```typescript
import {
  CerttaAcceptedDocumentType,
  type CerttaSmartCaptureConfiguration,
} from '@caf.io/react-native-sdk';

const config: CerttaSmartCaptureConfiguration = {
  acceptedDocuments: [
    CerttaAcceptedDocumentType.IDENTITY_CARD,
    CerttaAcceptedDocumentType.DRIVER_LICENSE,
  ],
  customLocalization: 'MySmartCapture',
};

await open(config);
```

### Adding your strings table

1. Create a `.strings` file in the iOS app target — for example `MySmartCapture.strings` — and place it under the `<language>.lproj/` directory of each locale you support (`ios/<App>/en.lproj/`, `ios/<App>/pt-BR.lproj/`, …).
2. Add only the keys you want to override. Omitted keys are not an error and do not render a raw key on screen.
3. Pass the filename without the extension as `customLocalization`.

```
/* ios/<App>/en.lproj/MySmartCapture.strings */
"smart_capture.instructions.title" = "Get your ID ready";
"smart_capture.instructions.capture.cta" = "Open camera";
```

Everything else on the instructions screen keeps the SDK’s own wording.

### Resolution order

For each key, the SDK resolves in this order:

1. Your `customLocalization` table in the main app bundle.
2. The SDK’s own table for the device language.
3. The default value compiled into the SDK, which is Brazilian Portuguese.

Partial tables are supported and recommended. Passing a table name that does not exist is also safe — every key falls back to the SDK’s own text.

The SDK ships English, Spanish and Brazilian Portuguese. On a device whose preferred languages include none of these, the SDK’s text is shown in Brazilian Portuguese.

### Localization

The SDK resolves strings through the standard iOS lookup, so the language shown follows the user’s preferred languages as negotiated against the localizations your app declares — Smart Capture does not expose a language switch of its own.

Your custom table is resolved per locale in exactly the same way: a key is read from the `<language>.lproj/` directory matching the resolved language, falling back to your table’s development region, then to the SDK’s own text.

#### Adding a language the SDK does not ship

Create the `.lproj` directory for that language in the iOS app, add your table there, and make sure the language is listed in the app’s localizations. Keys you omit fall back to Brazilian Portuguese, so translate every key the user will see.

```
/* ios/<App>/fr.lproj/MySmartCapture.strings */
"smart_capture.instructions.title" = "Préparez votre document";
```

#### Replacing a language the SDK does ship

There is no way to remove a bundled translation. To change a shipped language’s wording, override the keys for that locale in your own table.

### Format specifiers

Some values contain format specifiers such as `%@`, `%d`, or `%1$d`. Your replacement must keep the same specifiers. Dropping them, or reordering them without positional syntax, produces wrong output.

`.stringsdict` plural rules are not consulted. Plural variations must be handled by the keys listed below.

### Upload file type messages

| Key                                                          | Used when                                                               |
| ------------------------------------------------------------ | ----------------------------------------------------------------------- |
| `smart_capture.upload.file_invalid_extension.message`        | `allowedUploadTypes` is unset, empty, or lists all five formats.        |
| `smart_capture.upload.file_invalid_extension.message_format` | `allowedUploadTypes` narrows the set; `%@` receives the extension list. |
| `smart_capture.list.or`                                      | Disjunctive connective used to join the list (and document type lists). |

### Key reference

All keys are prefixed `smart_capture.` to avoid collisions. Values shown are the English defaults.

A ready-to-copy `.strings` file is published alongside the native SDK: [SmartCapture/SmartCaptureLocalizable.strings](https://github.com/combateafraude/caf-ios-sdk/blob/main/SmartCapture/SmartCaptureLocalizable.strings). Start from it, then delete the keys you do not intend to override.

####

#### Capture instructions

```
"smart_capture.instruction.center_document" = "Center the document";
"smart_capture.instruction.scan_document" = "Scan your document";
"smart_capture.instruction.move_closer" = "Move closer";
"smart_capture.instruction.move_away" = "Move away a little";
"smart_capture.instruction.keep_phone_still" = "Capturing... Keep it that way";
"smart_capture.instruction.manual_capture_available" = "Or tap the button to capture";
"smart_capture.instruction.turn_document_back" = "Turn the document";
"smart_capture.instruction.capture_retry" = "Unable to capture. Please try again.";
"smart_capture.instruction.uploading_document" = "Uploading document...";
"smart_capture.instruction.document_validated_success" = "Document validated successfully";
```

#### Invalid document messages

```
"smart_capture.invalid_document.generic" = "Document not accepted. Please try again.";
"smart_capture.invalid_document.single_allowed" = "Use %@";
"smart_capture.invalid_document.multiple_allowed" = "Use %@";
"smart_capture.invalid_document.recapture_expected_back" = "Capture the back side of the %@.";
"smart_capture.invalid_document.recapture_expected_front" = "Capture the front side of the %@.";
```

#### Document type names

```
"smart_capture.document.any" = "Any document";
"smart_capture.document.passport" = "Passport";
```

The other document types are shown by their Brazilian abbreviations — RG, CNH, RNE, CTPS and CRLV — which are not customizable. Their VoiceOver names are under Accessibility — document names.

#### Capture preview

```
"smart_capture.preview.title" = "Check your photo";
"smart_capture.preview.description" = "Check if it is sharp and free of glare.";
"smart_capture.preview.retake" = "Take photo again";
"smart_capture.preview.confirm" = "Send capture";
```

#### Instructions carousel — shared

```
"smart_capture.instructions.title" = "Prepare your document";
"smart_capture.instructions.subtitle" = "It takes less than 1 minute.";
"smart_capture.instructions.accepted_docs_format" = "%@ are accepted";
"smart_capture.instructions.accepted_docs_single_format" = "%@ is accepted";
"smart_capture.instructions.skip_tips" = "Skip tips";
"smart_capture.instructions.next_tip" = "Next tip";
"smart_capture.list.or" = "or";
```

#### Instructions carousel — capture mode

```
"smart_capture.instructions.capture.page1.title" = "Start from any side";
"smart_capture.instructions.capture.page1.description" = "Front, back, or open document. We identify the side automatically.";
"smart_capture.instructions.capture.page2.title" = "Keep the edges visible";
"smart_capture.instructions.capture.page2.description" = "Frame all four corners of the document and avoid tilting your phone.";
"smart_capture.instructions.capture.page3.title" = "Ensure clarity";
"smart_capture.instructions.capture.page3.description" = "Avoid reflections and shadows. Legible data speeds up your approval.";
"smart_capture.instructions.capture.cta" = "Take photo";
```

#### Instructions carousel — upload mode

```
"smart_capture.instructions.upload.page1.title" = "Send image or PDF";
"smart_capture.instructions.upload.page1.description" = "You can send photos from the gallery or PDF files.";
"smart_capture.instructions.upload.page2.title" = "Send one or more files";
"smart_capture.instructions.upload.page2.description" = "Send the complete document or select the front and back at once.";
"smart_capture.instructions.upload.cta" = "Attach document";
```

#### Validation method selection

```
"smart_capture.validation_method.title" = "Choose how to validate your document";
"smart_capture.validation_method.take_photo" = "Take photo";
"smart_capture.validation_method.take_photo.subtitle" = "Photograph your document now";
"smart_capture.validation_method.attach_document" = "Attach document";
"smart_capture.validation_method.attach_document.subtitle" = "Send files of the document you have on your device";
```

#### Upload source selection

```
"smart_capture.upload.source_selection.title" = "Select where to choose the document from";
"smart_capture.upload.source_selection.documents" = "Files";
"smart_capture.upload.source_selection.gallery" = "Gallery";
"smart_capture.upload.source_selection.cancel" = "Cancel";
```

#### Camera help sheet

```
"smart_capture.camera.help.sheet_title" = "Need help?";
"smart_capture.camera.help.tip1_title" = "Frame the edges";
"smart_capture.camera.help.tip1_description" = "Don't let the document go off screen.";
"smart_capture.camera.help.tip2_title" = "Avoid reflections";
"smart_capture.camera.help.tip2_description" = "Find a place with indirect lighting.";
"smart_capture.camera.help.tip3_title" = "Legible data";
"smart_capture.camera.help.tip3_description" = "Make sure the data is legible.";
"smart_capture.camera.help.footer" = "Or, if you prefer, attach the document file.";
"smart_capture.camera.help.continue_button" = "Continue taking photo";
"smart_capture.camera.help.attach_button" = "Attach document";
```

#### Upload review screen

```
"smart_capture.upload.review.title" = "Check your document";
"smart_capture.upload.review.title.complete" = "Complete your document";
"smart_capture.upload.review.empty.title" = "No documents attached";
"smart_capture.upload.review.empty.description" = "Attach one file with the full document or two files (front and back).";
"smart_capture.upload.review.first_file" = "First file";
"smart_capture.upload.review.second_file" = "Second file (optional)";
"smart_capture.upload.review.attach" = "Attach document";
"smart_capture.upload.review.side.front" = "Front";
"smart_capture.upload.review.side.back" = "Back";
"smart_capture.upload.review.send" = "Send document";
"smart_capture.upload.review.warning.format" = "Add %@ to complete the submission.";
"smart_capture.upload.review.warning.back_of_format" = "the back of the %@";
"smart_capture.upload.review.warning.back_of_format_masculine" = "the back of the %@";
"smart_capture.upload.review.warning.front_of_format" = "the front of the %@";
"smart_capture.upload.review.warning.front_of_format_masculine" = "the front of the %@";
"smart_capture.upload.review.first_file_prefix" = "First file: ";
"smart_capture.upload.review.second_file_prefix" = "Second file: ";
"smart_capture.upload.review.file_invalid" = "We couldn't validate this file. Attach another document.";
```

#### Upload — delete file sheet

```
"smart_capture.upload.review.delete.title" = "Delete file?";
"smart_capture.upload.review.delete.description" = "If you confirm the deletion, you will need to attach a file again. Are you sure?";
"smart_capture.upload.review.delete.confirm" = "Delete file";
"smart_capture.upload.review.delete.cancel" = "Keep file";
```

#### Upload — validation alerts

```
"smart_capture.upload.max_files.alert.title" = "File limit";
"smart_capture.upload.max_files.alert.message_format" = "Select at most %d files.";
"smart_capture.upload.max_files.alert.message_singular" = "Select at most 1 file.";
"smart_capture.upload.max_files.alert.ok" = "Got it";
"smart_capture.upload.file_too_large.message" = "Use files with at most 10 MB.";
"smart_capture.upload.file_invalid_extension.message" = "Use the extensions: png, jpeg, heif, heic or pdf.";
"smart_capture.upload.file_invalid_extension.message_format" = "Use the extensions: %@.";
```

#### Upload — send failure

```
"smart_capture.upload.send_error.title" = "Something went wrong";
"smart_capture.upload.send_error.description" = "Something went wrong while sending your document. Try attaching it again.";
"smart_capture.upload.send_error.retry" = "Try again";
```

#### Accessibility — capture and preview

```
"smart_capture.accessibility.announcement.photo_captured" = "Photo captured";
"smart_capture.accessibility.camera.screen" = "Document capture screen";
"smart_capture.accessibility.close_button.label" = "Close";
"smart_capture.accessibility.close_button.hint" = "Closes the capture screen";
"smart_capture.accessibility.error_banner_close_button.hint" = "Hides only the error message";
"smart_capture.accessibility.capture_button.label" = "Capture photo";
"smart_capture.accessibility.capture_button.hint" = "Captures the document image";
"smart_capture.accessibility.preview.screen" = "Document preview screen";
"smart_capture.accessibility.preview.image.label" = "Preview of the captured document";
"smart_capture.accessibility.preview.back_button.label" = "Back";
"smart_capture.accessibility.help_button.label" = "Help";
"smart_capture.accessibility.help_button.hint" = "Opens tips to capture the document";
"smart_capture.accessibility.camera.help.tip_position_format" = "Tip %1$d of %2$d";
```

#### Accessibility — instructions and validation method

```
"smart_capture.accessibility.instructions.screen" = "Document capture instructions screen";
"smart_capture.accessibility.instructions.back_button.label" = "Back";
"smart_capture.accessibility.instructions.back_button.hint" = "Returns to the previous screen";
"smart_capture.accessibility.instructions.carousel_live_region" = "%@. %@. Tip %d of %d.";
"smart_capture.accessibility.instructions.carousel.hint" = "Swipe up or down to see the other tips";
"smart_capture.accessibility.instructions.skip_tips.hint" = "Skips the tips and goes directly to the action";
"smart_capture.accessibility.instructions.next_tip.hint" = "Advances to the next tip";
"smart_capture.accessibility.validation_method.screen" = "Validation method selection screen";
```

#### Accessibility — upload

```
"smart_capture.accessibility.upload.review.back_button.label" = "Back";
"smart_capture.accessibility.upload.review.back_button.hint" = "Returns to the previous screen";
"smart_capture.accessibility.upload.review.send_button.hint" = "Submits the attached document files for validation";
"smart_capture.accessibility.upload.slot.preview_button.label" = "Preview";
"smart_capture.accessibility.upload.slot.preview_button.hint" = "Opens a full-screen preview of this file";
"smart_capture.accessibility.upload.slot.delete_button.label" = "Delete";
"smart_capture.accessibility.upload.slot.delete_button.hint" = "Removes this file from the submission";
"smart_capture.accessibility.upload.slot.empty.hint" = "Opens file picker to select a document";
"smart_capture.accessibility.upload.slot.sent_state" = "sent, not editable";
"smart_capture.accessibility.upload.slot.preview_button_format" = "Preview %@";
"smart_capture.accessibility.upload.slot.delete_button_format" = "Delete %@";
"smart_capture.accessibility.upload.failure.back_button.label" = "Back";
"smart_capture.accessibility.upload.failure.back_button.hint" = "Cancels the upload and returns to the previous screen";
"smart_capture.accessibility.upload.failure.retry_button.hint" = "Tries sending the document again";
"smart_capture.accessibility.upload.preview.close_button.label" = "Close";
"smart_capture.accessibility.upload.preview.close_button.hint" = "Closes the file preview";
"smart_capture.accessibility.upload.preview.image_label_format" = "Preview of %@";
"smart_capture.accessibility.upload.preview.pdf_label_singular_format" = "Preview of %@, PDF, 1 page";
"smart_capture.accessibility.upload.preview.pdf_label_plural_format" = "Preview of %@, PDF, %d pages";
```

#### Accessibility — document names

```
"smart_capture.accessibility.warning.prefix" = "Warning";
"smart_capture.accessibility.error.prefix" = "Error";
"smart_capture.accessibility.send_button.disabled_value" = "Disabled. Attach the missing files to send.";
"smart_capture.accessibility.document.identity_card" = "Identity Card (RG)";
"smart_capture.accessibility.document.driver_license" = "Driver License (CNH)";
"smart_capture.accessibility.document.residence_identity_card" = "Residence Identity Card (RNE)";
"smart_capture.accessibility.document.employment_card" = "Employment Card (CTPS)";
"smart_capture.accessibility.document.vehicle_license" = "Vehicle
```

{% endtab %}
{% endtabs %}

<br>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.caf.io/caf-sdk/react-native/document-smart-capture/text-customization.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
