Tips Customization

Capture Tips Customization

The specific “tips” of the Capture Tips page can be customized.

For each tip, the title, description and icon can be overridden. Some tips have a receipt and invoice variation. The appropriate variation will be displayed based on the provided Capture configuration.

The following section describes how each tip can be customized on each platform. Below that section, the summary of specific Android and iOS keys for each tip is provided.

How to Customize Tips

  • Follow the Localization guide to change the strings specified below
  • Follow the Images section in iOS-specific section of Global Theme to change the images specified below.

To override any string resources mentioned below, add the exact string key to your own strings.xml file. For example, for the string key sb__tips_description_flattenreceipt, add the following to override it:

<string name="sb__tips_description_flattenreceipt">My tip description</string>

To override and drawable resources mentioned below, create a new drawable with the exact name as the one that you wish to override.

The correct resources to override for each tip are listed above this section.

Keys to Override

Capture has four tips, all of which can be customized. Here’s the summary of the tips and their keys

General Tip 1

Default: “Flatten receipt / invoice”

ItemAndroid KeysiOS Keys
Title (receipt)sb__tips_title_flattenreceiptsblCaptureTipsScreenFlattenReceiptTitle
Title (invoice)sb__tips_title_flattenreceipt_invoicesblCaptureTipsScreenFlattenInvoiceTitle
Description (receipt)sb__tips_description_flattenreceiptsblCaptureTipsScreenFlattenReceiptDescription
Description (invoice)sb__tips_description_flattenreceipt_invoicesblCaptureTipsScreenFlattenInvoiceDescription
Iconsb__tips_ic_flattencaptureTipsFlatenIcon

General Tip 2

Default: “Hold steady”

ItemAndroid KeysiOS Keys
Title (receipt)sb__tips_title_holdsteadysblCaptureTipsScreenHoldSteadyReceiptTitle
Title (invoice)sb__tips_title_holdsteady_invoicesblCaptureTipsScreenHoldSteadyInvoiceTitle
Description (receipt)sb__tips_description_holdsteadysblCaptureTipsScreenHoldSteadyReceiptDescription
Description (invoice)sb__tips_description_holdsteady_invoicesblCaptureTipsScreenHoldSteadyInvoiceDescription
Iconsb__tips_ic_steadycaptureTipsSteadyIcon

Flash Tip

Conditional: will not be shown if a flash/torch was disabled via the feature flag

ItemAndroid KeyiOS Key
Titlesb__tips_title_makeitbrightsblCaptureTipsScreenMakeItBrightTitle
Descriptionsb__tips_description_makeitbrightsblCaptureTipsScreenMakeItBrightDescription
Iconsb__tips_ic_brightcaptureTipsBrightIcon

Long Receipt Tip

Conditional: will not be shown if long receipt capture was disabled via the feature flag

ItemAndroid KeyiOS Key
Titlesb__tips_title_longreceiptsblCaptureTipsScreenLongReceiptTitle
Descriptionsb__tips_description_longreceiptsblCaptureTipsScreenLongReceiptDescription
Iconsb__tips_ic_longreceiptcaptureTipsLongIcon