# Customisation

Truecaller SDK provides you with capabilities to configure the following:

<figure><img src="https://3916632365-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJzE3kcOEptTlnx7Hgg25%2Fuploads%2FlaFG2xmhOyuNRXaxPju6%2FB.jpeg?alt=media&#x26;token=ab5338c8-42be-4478-baf3-31941a0aa7db" alt=""><figcaption></figcaption></figure>

Refer to the section below for details on all the customization capabilities and the possible values you may set:

```
TcSdkOptions.Builder(this, tcOAuthCallback)
       .consentMode(TcSdkOptions.CONSENT_MODE_BOTTOMSHEET) 
       .buttonShapeOptions(TcSdkOptions.BUTTON_SHAPE_ROUNDED)
       .footerType(TcSdkOptions.FOOTER_TYPE_ANOTHER_MOBILE_NO)
       .sdkOptions(TcSdkOptions.OPTION_VERIFY_ONLY_TC_USERS)
       .ctaText(TcSdkOptions.CTA_TEXT_ACCEPT)
       .heading(TcSdkOptions.LOGIN_TEXT_PREFIX_TO_GET_STARTED)
       .buttonColor(1111)
       .buttonTextColor(1111)
       .build()
```

**Consent Mode Style  \[ .consentMode() ]**&#x20;

To align the consent screen with your UX, which could either be centrally or bottom aligned, choose either of the consent screens, making the SDK integration more homogeneous with your app UX.&#x20;

| Consent Mode                | Value                                   |
| --------------------------- | --------------------------------------- |
| Consent Mode - Center PopUp | TcSdkOptions.CONSENT\_MODE\_POPUP       |
| Consent Mode - Bottomsheet  | TcSdkOptions.CONSENT\_MODE\_BOTTOMSHEET |

**Contextual header \[ .heading() ]**&#x20;

To provide the appropriate context of verification to the Truecaller user, use one of the below mentioned TruecallerSdkScope values to show the corresponding message to the user

|                                      |                                                                 |
| ------------------------------------ | --------------------------------------------------------------- |
| Log in to                            | TcSdkOptions.SDK\_CONSENT\_HEADING\_LOG\_IN\_TO                 |
| Sign up with                         | TcSdkOptions.SDK\_CONSENT\_HEADING\_SIGNUP\_WITH                |
| Sign in to                           | TcSdkOptions.SDK\_CONSENT\_HEADING\_SIGN\_IN\_TO                |
| Verify number with                   | TcSdkOptions.SDK\_CONSENT\_HEADING\_VERIFY\_NUMBER\_WITH        |
| Register with                        | TcSdkOptions.SDK\_CONSENT\_HEADING\_REGISTER\_WITH              |
| Get started with                     | TcSdkOptions.SDK\_CONSENT\_HEADING\_GET\_STARTED\_WITH          |
| Proceed with                         | TcSdkOptions.SDK\_CONSENT\_HEADING\_PROCEED\_WITH               |
| Verify with                          | TcSdkOptions.SDK\_CONSENT\_HEADING\_VERIFY\_WITH                |
| Verify profile with                  | TcSdkOptions.SDK\_CONSENT\_HEADING\_VERIFY\_PROFILE\_WITH       |
| Verify your profile with             | TcSdkOptions.SDK\_CONSENT\_HEADING\_VERIFY\_YOUR\_PROFILE\_WITH |
| Verify your phone number with        | TcSdkOptions.SDK\_CONSENT\_HEADING\_VERIFY\_PHONE\_NO\_WITH     |
| Verify your number with              | TcSdkOptions.SDK\_CONSENT\_HEADING\_VERIFY\_YOUR\_NO\_WITH      |
| Continue with                        | TcSdkOptions.SDK\_CONSENT\_HEADING\_CONTINUE\_WITH              |
| Complete order with                  | TcSdkOptions.SDK\_CONSENT\_HEADING\_COMPLETE\_ORDER\_WITH       |
| Place order with                     | TcSdkOptions.SDK\_CONSENT\_HEADING\_PLACE\_ORDER\_WITH          |
| Complete booking with                | TcSdkOptions.SDK\_CONSENT\_HEADING\_COMPLETE\_BOOKING\_WITH     |
| Checkout with                        | TcSdkOptions.SDK\_CONSENT\_HEADING\_CHECKOUT\_WITH              |
| Manage Details with                  | TcSdkOptions.SDK\_CONSENT\_HEADING\_MANAGE\_DETAILS\_WITH       |
| Manage your details with             | TcSdkOptions.SDK\_CONSENT\_HEADING\_MANAGE\_YOUR\_DETAILS\_WITH |
| Login to <\<APP\_NAME>> with one tap | TcSdkOptions.SDK\_CONSENT\_HEADING\_LOGIN\_TO\_WITH\_ONE\_TAP   |
| Subscribe to                         | TcSdkOptions.SDK\_CONSENT\_HEADING\_SUBSCRIBE\_TO               |
| Get updates from                     | TcSdkOptions.SDK\_CONSENT\_HEADING\_GET\_UPDATES\_FROM          |
| Continue reading on                  | TcSdkOptions.SDK\_CONSENT\_HEADING\_CONTINUE\_READING\_ON       |
| Get new updates from                 | TcSdkOptions.SDK\_CONSENT\_HEADING\_GET\_NEW\_UPDATES\_FROM     |
| Log in/ Signup with                  | TcSdkOptions.SDK\_CONSENT\_HEADING\_LOGIN\_SIGNUP\_WITH         |

**Button text options \[ .ctaTextPrefix() ]**&#x20;

To set the prefix on the CTA button

| Continue | TcSdkOptions.CTA\_TEXT\_CONTINUE |
| -------- | -------------------------------- |
| Proceed  | TcSdkOptions.CTA\_TEXT\_PROCEED  |
| Accept   | TcSdkOptions.CTA\_TEXT\_ACCEPT   |
| Confirm  | TcSdkOptions.CTA\_TEXT\_COFIRM   |

**Button shape \[ .buttonShapeOptions() ]**&#x20;

To chose the shape of the CTA button

| Round     | TcSdkOptions.BUTTON\_SHAPE\_ROUNDED   |
| --------- | ------------------------------------- |
| Rectangle | TcSdkOptions.BUTTON\_SHAPE\_RECTANGLE |

**Footer CTA text \[ .footerType() ]**&#x20;

To configure the text of the additional footer CTA present at the bottom

| Use another number     | TcSdkOptions.FOOTER\_TYPE\_CONTINUE        |
| ---------------------- | ------------------------------------------ |
| Use another method     | TcSdkOptions.FOOTER\_TYPE\_ANOTHER\_METHOD |
| Enter details manually | TcSdkOptions.FOOTER\_TYPE\_MANUALLY        |
| Later                  | TcSdkOptions.FOOTER\_TYPE\_LATER           |

**Dark Theme**

To set the consent screen in dark mode, you can call \
\
`TcSdk.getInstance().setTheme(OAuthThemeOptions.DARK)`

just before calling the \
\
`TcSdk.getInstance().getAuthorizationCode(this, launcher)`\
\
By default, the SDK is configured with the light theme. <br>

**Privacy policy :**&#x20;

To add your privacy policy link on the verification screen, you can configure the respective hyperlink from your developer account

**Terms of service:** To add your terms of service link on the verification screen, you can configure the respective hyperlink from your developer account

**Language:** You can optionally customize the consent screen in any of the supported languages. To do so, add the following line :

Copy

```
val locale = Locale("hi") // change language to Hindi
TcSdk.getInstance().setLocale(locale)
```

Currently supported languages:

| english   | en |
| --------- | -- |
| hindi     | hi |
| marathi   | mr |
| telugu    | te |
| malayalam | ml |
| urdu      | ur |
| punjabi   | pa |
| tamil     | ta |
| bengali   | bn |
| kannada   | kn |
| swahili   | sw |
| arabic    | ar |