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)
JA (Japanese)
TH (Thai)
ZH_CN (Simplified Chinese)
Zh_TW (Traditional Chinese)
KO (Korean)

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

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": "[email protected]",
  "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(
    signerName: "David",
    signerType: SignerType.Signer,
    signerEmail: "[email protected]",
    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 boldsign

configuration = boldsign.Configuration(host = "https://api.boldsign.com", api_key = "YOUR_API_KEY")

with boldsign.ApiClient(configuration) as api_client:

    document_api = boldsign.DocumentApi(api_client)

    send_for_sign = boldsign.SendForSign(
        files = ["YOUR_FILE_PATH"],
        signers = [
            boldsign.DocumentSigner(
                name = "Hanky",
                emailAddress = "[email protected]",
                signerOrder = 1,
                signerType = "Signer",
                formFields = [
                    boldsign.FormField(
                        name = "Sign",
                        fieldType = "Signature",
                        font = "Helvetica",
                        pageNumber = 1,
                        isRequired = True,
                        bounds = boldsign.Rectangle(x = 50, y = 50, width = 100, height = 150),
                    )
                ],
                privateMessage = "This is private message for signer",
                locale = "FR"
            )
        ],
        documentInfo = [
            boldsign.DocumentInfo(
                title = "Document SDK API", 
                description = "Testing document from SDK integration test case",
                locale = "FR"
            )
        ]
    )

    document_created = document_api.send_document(send_for_sign)

<?php require_once "vendor/autoload.php";

$config = new BoldSign\Configuration();
$config->setHost("https://api.boldsign.com");
$config->setApiKey('YOUR_API_KEY');

$document_api = new BoldSign\Api\DocumentApi($config);

$field = new BoldSign\Model\FormField();
$field->setFieldType('Signature');
$field->setPageNumber(1);
$rectangle = new BoldSign\Model\Rectangle();
$rectangle->setX(100);
$rectangle->setY(100);
$rectangle->setWidth(200);
$rectangle->setHeight(200);
$field->setBounds($rectangle);
$field->setIsRequired(true);

$signer = new BoldSign\Model\DocumentSigner();
$signer->setName("hanky");
$signer->setEmailAddress("[email protected]");
$signer->setSignerType('Signer');
$signer->setFormFields([$field]);
$signer->setLocale('FR');

$docInfo = new BoldSign\Model\DocumentInfo();
$docInfo->setTitle("string");
$docInfo->setDescription("string");
$docInfo->setLocale('FR');

$send_for_sign = new BoldSign\Model\SendForSign();
$send_for_sign->setFiles(["{Your file path}"]);
$send_for_sign->setSigners([$signer]);
$send_for_sign->setDisableEmails(true);
$send_for_sign->setDocumentInfo([$docInfo]);

$document_created = $document_api->sendDocument($send_for_sign);

import java.io.File;
import java.util.Arrays;

import com.boldsign.ApiClient;
import com.boldsign.ApiException;
import com.boldsign.Configuration;
import com.boldsign.api.DocumentApi;
import com.boldsign.model.DocumentCreated;
import com.boldsign.model.DocumentInfo;
import com.boldsign.model.DocumentSigner;
import com.boldsign.model.FormField;
import com.boldsign.model.Rectangle;
import com.boldsign.model.SendForSign;

ApiClient client = Configuration.getDefaultApiClient();
client.setBasePath("https://api.boldsign.com");
client.setApiKey("YOUR_API_KEY");
DocumentApi documentApi = new DocumentApi(client);

FormField signatureField = new FormField();
signatureField.setFieldType(FormField.FieldTypeEnum.SIGNATURE);
signatureField.setPageNumber(1);
Rectangle bounds = new Rectangle();
bounds.setX(100f);
bounds.setY(100f);
bounds.setWidth(200f);
bounds.setHeight(200f);
signatureField.setBounds(bounds);
signatureField.setIsRequired(true);

DocumentSigner signer = new DocumentSigner();
signer.setName("hanky");
signer.setEmailAddress("[email protected]");
signer.setSignerType(DocumentSigner.SignerTypeEnum.SIGNER);
signer.setFormFields(Arrays.asList(signatureField));
signer.setLocale(DocumentSigner.LocaleEnum.EN);

DocumentInfo docInfo = new DocumentInfo();
docInfo.setTitle("string");
docInfo.setDescription("string");
docInfo.setLocale(DocumentInfo.LocaleEnum.EN);

SendForSign sendForSign = new SendForSign();
sendForSign.setFiles(Arrays.asList(new File("YOUR_FILE_PATH")));
sendForSign.setSigners(Arrays.asList(signer));
sendForSign.setDisableEmails(true);
sendForSign.setDocumentInfo(Arrays.asList(docInfo));

DocumentCreated documentCreated = documentApi.sendDocument(sendForSign);

import * as boldsign from 'boldsign';
import * as fs from 'fs';

const documentApi = new boldsign.DocumentApi("https://api.boldsign.com");
documentApi.setApiKey('YOUR_API_KEY');


const signatureField = new boldsign.FormField();
signatureField.fieldType = boldsign.FormField.FieldTypeEnum.Signature;
signatureField.pageNumber = 1;
signatureField.bounds = new boldsign.Rectangle();
signatureField.bounds.x = 50;
signatureField.bounds.y = 50;
signatureField.bounds.width = 200;
signatureField.bounds.height = 25;
signatureField.isRequired = true;

const signer = new boldsign.DocumentSigner();
signer.name = 'hanky';
signer.emailAddress = '[email protected]';
signer.signerType = boldsign.DocumentSigner.SignerTypeEnum.Signer;
signer.formFields = [signatureField];
signer.locale = boldsign.DocumentSigner.LocaleEnum.Fr;

const docInfo = new boldsign.DocumentInfo();
docInfo.locale = boldsign.DocumentInfo.LocaleEnum.Fr;
docInfo.title = 'Document_title';
docInfo.description = 'Document_description';

const sendForSign = new boldsign.SendForSign();
sendForSign.files = [fs.createReadStream('YOUR_FILE_PATH')];
sendForSign.signers = [signer];
sendForSign.disableEmails = true;
sendForSign.documentInfo = [docInfo];

const doucment_created = documentApi.sendDocument(sendForSign);

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.

3. Integrate the generated link in an iFrame

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.