# Customisation

Truecaller SDK provides you with capabilities to configure the following :

<figure><img src="/files/YZGaFYMAYMs3JAuEpCgi" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
If you are already using Truecaller SDK with pop-up variant of the verification screen, you can upgrade to the bottom sheet layout by simply making changes to the configuration options in your **TruecallerSdkScope** object. Refer to the below section for details on all the customisation capabilities and the possible values you may set.
{% endhint %}

```
TruecallerSdkScope trueScope = new TruecallerSdkScope.Builder(this, sdkCallback)
        .consentMode(TruecallerSdkScope.CONSENT_MODE_BOTTOMSHEET)
        .buttonColor(Color.parseColor("<<YOUR_DESIRED_COLOR_HEX_CODE>>"))
        .buttonTextColor(Color.parseColor("<<YOUR_DESIRED_COLOR_HEX_CODE>>"))
        .loginTextPrefix(TruecallerSdkScope.LOGIN_TEXT_PREFIX_TO_GET_STARTED)
        .loginTextSuffix(TruecallerSdkScope.LOGIN_TEXT_SUFFIX_PLEASE_VERIFY_MOBILE_NO)
        .ctaTextPrefix(TruecallerSdkScope.CTA_TEXT_PREFIX_USE)
        .buttonShapeOptions(TruecallerSdkScope.BUTTON_SHAPE_ROUNDED)
        .privacyPolicyUrl("<<YOUR_PRIVACY_POLICY_LINK>>")
        .termsOfServiceUrl("<<YOUR_PRIVACY_POLICY_LINK>>")
        .footerType(TruecallerSdkScope.FOOTER_TYPE_NONE)
        .consentTitleOption(TruecallerSdkScope.SDK_CONSENT_TITLE_LOG_IN)
        .sdkOptions(TruecallerSdkScope.SDK_OPTION_WIHTOUT_OTP)
.build();          
```

**Contextual text prefix \[** .loginTextPrefix() **]** To provide appropriate context of verification to the Truecaller use&#x72;**,** use one of the below mentioned TruecallerSdkScope values to show the corresponding message to the user.

| **Text to use**               | **TruecallerSdkScope value**                                              |
| ----------------------------- | ------------------------------------------------------------------------- |
| To get started                | TruecallerSdkScope.LOGIN\_TEXT\_PREFIX\_TO\_GET\_STARTED                  |
| To continue                   | TruecallerSdkScope.LOGIN\_TEXT\_PREFIX\_TO\_CONTINUE                      |
| To place order                | TruecallerSdkScope.LOGIN\_TEXT\_PREFIX\_TO\_PLACE\_ORDER                  |
| To complete your order        | TruecallerSdkScope.LOGIN\_TEXT\_PREFIX\_TO\_COMPLETE\_YOUR\_PURCHASE      |
| To checkout                   | TruecallerSdkScope.LOGIN\_TEXT\_PREFIX\_TO\_CHECKOUT                      |
| To complete your booking      | TruecallerSdkScope.LOGIN\_TEXT\_PREFIX\_TO\_COMPLETE\_YOUR\_BOOKING       |
| To proceed with your booking  | TruecallerSdkScope.LOGIN\_TEXT\_PREFIX\_TO\_PROCEED\_WITH\_YOUR\_BOOKING  |
| To continue with your booking | TruecallerSdkScope.LOGIN\_TEXT\_PREFIX\_TO\_CONTINUE\_WITH\_YOUR\_BOOKING |
| To get details                | TruecallerSdkScope.LOGIN\_TEXT\_PREFIX\_TO\_GET\_DETAILS                  |
| To view more                  | TruecallerSdkScope.LOGIN\_TEXT\_PREFIX\_TO\_VIEW\_MORE                    |
| To continue reading           | TruecallerSdkScope.LOGIN\_TEXT\_PREFIX\_TO\_CONTINUE\_READING             |
| To proceed                    | TruecallerSdkScope.LOGIN\_TEXT\_PREFIX\_TO\_PROCEED                       |
| For new updates               | TruecallerSdkScope.LOGIN\_TEXT\_PREFIX\_FOR\_NEW\_UPDATES                 |
| To get updates                | TruecallerSdkScope.LOGIN\_TEXT\_PREFIX\_TO\_GET\_UPDATES                  |
| To subscribe                  | TruecallerSdkScope.LOGIN\_TEXT\_PREFIX\_TO\_SUBSCRIBE                     |
| To subscribe and get updates  | TruecallerSdkScope.LOGIN\_TEXT\_PREFIX\_TO\_SUBSCRIBE\_AND\_GET\_UPDATES  |

**Contextual text suffix \[** .loginTextSuffix() **]** To provide appropriate context of verification to the Truecaller user and set the suffix string

| Suffix string               | **TruecallerSdkScope value**                                       |
| --------------------------- | ------------------------------------------------------------------ |
| please login                | TruecallerSdkScope.LOGIN\_TEXT\_SUFFIX\_PLEASE\_LOGIN              |
| please signup               | TruecallerSdkScope.LOGIN\_TEXT\_SUFFIX\_PLEASE\_SIGNUP             |
| please login/ signup        | TruecallerSdkScope.LOGIN\_TEXT\_SUFFIX\_PLEASE\_LOGIN\_SIGNUP      |
| please register             | TruecallerSdkScope.LOGIN\_TEXT\_SUFFIX\_PLEASE\_REGISTER           |
| please sign in              | TruecallerSdkScope.LOGIN\_TEXT\_SUFFIX\_PLEASE\_SIGN\_IN           |
| please verify mobile number | TruecallerSdkScope.LOGIN\_TEXT\_SUFFIX\_PLEASE\_VERIFY\_MOBILE\_NO |

**Button text options \[** .ctaTextPrefix() **]** To set the prefix on the CTA button

| **Button text to use** | TruecallerSdkScope value                             |
| ---------------------- | ---------------------------------------------------- |
| Use                    | TruecallerSdkScope.CTA\_TEXT\_PREFIX\_USE            |
| Continue with          | TruecallerSdkScope.CTA\_TEXT\_PREFIX\_CONTINUE\_WITH |
| Proceed with           | TruecallerSdkScope.CTA\_TEXT\_PREFIX\_PROCEED\_WITH  |

**Button shape \[** .buttonShapeOptions() **]** To chose the shape of the CTA button

| Button shape | TruecallerSdkScope value                    |
| ------------ | ------------------------------------------- |
| Round        | TruecallerSdkScope.BUTTON\_SHAPE\_ROUNDED   |
| Rectangle    | TruecallerSdkScope.BUTTON\_SHAPE\_RECTANGLE |

**Footer CTA text \[** .footerType() **]** To configure the text of the additional footer CTA present at the bottom

| Footer CTA string      | TruecallerSdkScope value                         |
| ---------------------- | ------------------------------------------------ |
| Use another number     | TruecallerSdkScope.FOOTER\_TYPE\_CONTINUE        |
| Use another method     | TruecallerSdkScope.FOOTER\_TYPE\_ANOTHER\_METHOD |
| Enter details manually | TruecallerSdkScope.FOOTER\_TYPE\_MANUALLY        |
| Later                  | TruecallerSdkScope.FOOTER\_TYPE\_LATER           |

**Privacy policy text \[** .privacyPolicyUrl() **]** To add your privacy policy link on the verification screen ( optional ), you can configure the respective hyperlink as mentioned below

Copy

```
.privacyPolicyUrl("<<YOUR_PRIVACY_POLICY_LINK>>")
```

**Terms of service text \[ .termsOfServiceUrl() ]** To add your terms of service link on the verification screen ( optional ), you can configure the respective hyperlink as mentioned below

Copy

```
.termsOfServiceUrl("<<YOUR_TERMS_OF_SERVICE_LINK>>")
```

**Language** To customise the profile dialog in any of the supported Indian languages To do so, add the following lines before calling the "getUserProfile()" method as mentioned in the previous step

Copy

```
Locale locale = new Locale("ru");
TruecallerSDK.getInstance().setLocale(locale);
```

Currently supported languages :

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

{% hint style="info" %}
*NOTE : In case the input locale is not supported, the profile will by default be shown in English language.*
{% endhint %}


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.truecaller.com/truecaller-sdk/android/sdk-v2.8.0-deprecating-soon/integrating-with-your-app/customisation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.