Set Language for Embedded Sign Page

BoldSign offers robust support for multiple languages within embedded sign requests, allowing users to interact with the system in their preferred language. This enhanced user experience fosters better understanding and engagement.

Language support

BoldSign supports a range of languages, that are:

  • EN (English)
  • FR (French)
  • NO (Norwegian)
  • DE (German)
  • ES (Spanish)
  • BG (Bulgarian)
  • CS (Czech)
  • DA (Danish)
  • IT (Italian)
  • NL (Dutch)
  • PL (Polish)
  • PT (Portuguese)
  • RO (Romanian)
  • RU (Russian)
  • SV (Swedish)

1. Send a document to the signer with preffered language

To ensure that signers complete the signing process in their preferred language, follow these steps:

Here are example codes you can use to do this:

Code snippet to disable email notifications

curl -X 'POST' \
  'https://api.boldsign.com/v1/document/send' \
  -H 'accept: application/json' \
  -H 'X-API-KEY: {your API key}' \
  -H 'Content-Type: multipart/form-data' \
  -F 'Signers={
  "name": "hanky",
  "emailAddress": "hankyWhites@gmail.com",
  "signerType": "Signer",
  "signerRole": "Signer",
  "formFields": [
    {
      "id": "signature",
      "name": "signature",
      "fieldType": "Signature",
      "pageNumber": 1,
      "bounds": {
        "x": 100,
        "y": 100,
        "width": 200,
        "height": 200
      },
      "isRequired": true
}
  ],
  "locale": "FR"
}' \
  -F 'Files={your file}' \
  -F 'DisableEmails=true' \
  -F 'DocumentInfo={
  "locale": "FR",
  "title": "string",
  "description": "string"
  }' \
var apiClient = new ApiClient("https://api.boldsign.com", "{Your API key}");
var documentClient = new DocumentClient(apiClient);

var documentFilePath = new DocumentFilePath
{
    ContentType = "application/pdf",
    FilePath = "{Your File path}"
};

var filesToUpload = new List<IDocumentFile>
{
    documentFilePath,
};

var signatureField = new FormField(
    id: "sign",
    isRequired: true,
    type: FieldType.Signature,
    pageNumber: 1,
    bounds: new Rectangle(x: 100, y: 100, width: 100, height: 50));

var formFieldCollections = new List<FormField>()
{
    signatureField
};

var signer = new DocumentSigner(
    name: "David",
    emailAddress: "david@cubeflakes.com",
    formFields: formFieldCollections,
    locale: Locales.FR);

var documentSigners = new List<DocumentSigner>()
{
    signer
};

var documentInfo = new DocumentInfo(
    locale: Locales.FR,
    title: "string",
    description: "string"
);

var documentInfos = new List<DocumentInfo>()
{
    documentInfo
};

var sendForSign = new SendForSign()
{
    DisableEmails = true,
    Signers = documentSigners,
    Files = filesToUpload,
    DocumentInfo = documentInfos
};
var documentCreated = documentClient.SendDocument(sendForSign);
Console.WriteLine(documentCreated.DocumentId);
import requests
import json

url = "https://api.boldsign.com/v1/document/send"

signer_data = {
    "name": "hanky",
    "emailAddress": "hankyWhites@gmail.com",
    "signerType": "Signer",
    "signerRole": "Signer",
    "formFields": [
        {
            "id": "signature",
            "name": "signature",
            "fieldType": "Signature",
            "pageNumber": 1,
            "bounds": {
                "x": 100,
                "y": 100,
                "width": 200,
                "height": 200
            },
            "isRequired": True
        }
    ],
    "locale": "FR"
}

payload = {
    'Signers': json.dumps(signer_data),
    'DisableEmails': True,
    'DocumentInfo': json.dumps({
        "locale": "FR",
        "title": "string",
        "description": "string"
    })
}

files = [
    ('Files', ('{Your file name}', open('{Your file path}', 'rb'), 'application/pdf'))
]

headers = {
    'accept': 'application/json',
    'X-API-KEY': '{Your API key}'
}

response = requests.post(url, headers=headers, data=payload, files=files)

print(response.text)
const axios = require('axios');
const FormData = require('form-data');
const fs = require('fs');
let data = new FormData();
data.append('Signers', '{\r\n  "name": "hanky",\r\n  "emailAddress": "hankyWhites@gmail.com",\r\n  "signerType": "Signer",\r\n  "signerRole": "Signer",\r\n  "formFields": [\r\n    {\r\n      "id": "signature",\r\n      "name": "signature",\r\n      "fieldType": "Signature",\r\n      "pageNumber": 1,\r\n      "bounds": {\r\n        "x": 100,\r\n        "y": 100,\r\n        "width": 200,\r\n        "height": 200\r\n      },\r\n      "isRequired": true\r\n}\r\n  ],\r\n  "locale": "FR"\r\n}');
data.append('Files', fs.createReadStream('{Your file path}'));
data.append('DisableEmails', 'true');
data.append('DocumentInfo', '{\r\n  "locale": "FR",\r\n  "title": "string",\r\n  "description": "string"\r\n  }');

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://api.boldsign.com/v1/document/send',
  headers: { 
    'accept': 'application/json', 
    'X-API-KEY': '{Your API key}', 
    ...data.getHeaders()
  },
  data : data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

Replace the values (Files, Signers, etc.) with the actual values. Set the Locale field to your desired language code. Also, provide DocumentInfo with the necessary information if you want to send the document in different languages other than EN. In case you want the signature process to occur within your application, set DisableEmails to true.

Upon execution, the document will be created, and a document ID will be generated.

2. Configure UI for embedded sign request

Design a user interface (UI) within your application that collects necessary information for the embedded sign request. This information serves as the basis for signing the document. For integrating the embedded sign page in your application, refer to this article Embedded Sign Request guide.

After generating the embed link, integrate it into an iFrame within your application. This iFrame empowers your application users to sign the document with the preferred language, the signer can also change the language on the signing page of the document by using the drop-down menu located in the top right corner.

Step 1

By following these steps, you provide users with the flexibility to sign documents in their desired language, enhancing their overall experience and ensuring clarity during the signing process.