---
title: "Localizing Strings in Your Replacement UI"
slug: "s3suite94-localizing-strings-in-your-replacement-ui"
updated: 2026-10-27T18:41:54Z
published: 2026-10-27T18:41:54Z
canonical: "docs.onespan.com/s3suite94-localizing-strings-in-your-replacement-ui"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onespan.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Localizing Strings in Your Replacement UI

If you replace any of the default UI classes as described above, you can still use a JSON UI configuration file to specify custom strings for localization. Here are the steps:

1. Prepare and store the JSON UI configuration file and the HTML for your replacement UI. Ensure that the HTML for your replacement UI contains the data-tag attribute whose value tells which key in the UI configuration file's strings object corresponds to the localized word. For details on this step, see [Localizing Your Replacement UI with the Web App SDK](/dpoa/docs/s3suite94-localizing-your-replacement-ui-with-the-web-app-sdk).
2. From your JavaScript app, call NNLUiConfig.addUiConfig() or NNLUiConfig.downloadUiConfig() to [specify the JSON UI configuration file](/dpoa/docs/s3suite94-replaceui-replacetheuiintheiosappsdkcustomizing-strings-styles-images-and-more) you are using.
3. Apply your JSON UI configuration to a specific view by calling ViewWrapper.onShow():

```javascript
var my_view = document.getElementById("my_view");
new ViewWrapper(my_view).onShow();
```