> For the complete documentation index, see [llms.txt](https://docs.complycube.com/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.complycube.com/documentation/product-guides/compliance-studio/smart-forms/question-types-and-configuration.md).

# Question types and configuration

Configure Smart Form fields, validation, risk scores, calculations, tables, and document capture for KYC and KYB questionnaires.

### Question settings

Each question has an ID, title, description, placeholder, guidance, required status, and visibility settings. Use guidance for an explanation behind an information icon or a **Learn more** link. You can customize the link text.

Where supported, values such as currency, country, and document type can be selected by the customer, given a default, or fixed and hidden from view.

<div data-with-frame="true"><figure><img src="https://1615271746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKyFKMqftsmT6qln9zo5y%2Fuploads%2Fvx7mktAqynEHwlnnZp5P%2Fsmart_forms_content_picker.png?alt=media&amp;token=1e17f23e-bdc8-4d02-afba-feb7d34ed5ca" alt=""><figcaption><p>Smart Forms -  Choose the question type that matches the information you need.</p></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="https://1615271746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKyFKMqftsmT6qln9zo5y%2Fuploads%2FdL7jp8Pn6KWiHX97Doy5%2Fsmart_forms_guidance_link.png?alt=media&amp;token=26dcfe16-03b4-46c8-86ad-c3f5f1c0783a" alt=""><figcaption><p>Smart Forms - Add contextual guidance without extending the question label.</p></figcaption></figure></div>

### Supported question types

| Question type          | Configuration and behavior                                                                                                                                                        | Risk scoring |
| ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ |
| Short Answer           | Minimum and maximum length, up to 255 characters. Supports patterns and presets such as GOV.UK share codes and tax numbers.                                                       | No           |
| Paragraph              | Multiline text, with minimum and maximum length up to 4,000 characters.                                                                                                           | No           |
| Email                  | Email address validation.                                                                                                                                                         | No           |
| URL                    | Web address validation.                                                                                                                                                           | No           |
| Number                 | Minimum, maximum, decimal places, percentage display, or a calculated value.                                                                                                      | No           |
| Amount                 | Monetary amount with a fixed or customer-selected currency; minimum and maximum values.                                                                                           | No           |
| Choose one             | One option, with an optional Other text response. Uses radio buttons for up to three options and on phones; otherwise a dropdown.                                                 | Per option   |
| Choose multiple        | Multiple options, with minimum and maximum selections and an optional Other response.                                                                                             | Per option   |
| Yes / No               | Yes/No choice, checkbox, or switch. Checkboxes and switches start as No.                                                                                                          | No           |
| Phone Number           | Country picker, allowed countries, and default country.                                                                                                                           | No           |
| Tax Number             | Personal or company tax number, validated for a country taken from an earlier answer or requested from the customer.                                                              | No           |
| Date Picker            | Fixed or relative earliest and latest dates. Date-of-birth questions can calculate a hidden age.                                                                                  | No           |
| Country                | Include or exclude countries.                                                                                                                                                     | Per country  |
| Multi-Country Selector | Multiple countries, with minimum and maximum selections.                                                                                                                          | Per country  |
| Address                | Address search with manual entry; optional client-record update.                                                                                                                  | No           |
| Table                  | Typed columns, row limits, totals, and repeated records.                                                                                                                          | No           |
| Address history        | Address records covering a specified number of years without gaps; optional proof-of-address and residence-type columns.                                                          | No           |
| Single File Upload     | One supporting document, with configurable type, classification, and issuing country.                                                                                             | No           |
| Multiple File Upload   | Supporting documents, with minimum and maximum counts.                                                                                                                            | No           |
| Government ID Upload   | Identity document capture, autofill, and reuse settings.                                                                                                                          | No           |
| Company Search         | [Business-register lookup](https://docs.complycube.com/documentation/product-guides/kyc-automation-services/company-search.md) within KYB templates.                              | No           |
| Signature              | Drawn or typed signature stored as an image. Use [eSignatures](https://docs.complycube.com/documentation/product-guides/compliance-studio/e-signatures.md) for a signing journey. | No           |
| Read-only content      | Formatted explanatory content between questions; excluded from answers.                                                                                                           | No           |

#### Text limits

| Content                 |   Maximum length |
| ----------------------- | ---------------: |
| Form and section titles |    60 characters |
| Question titles         |   120 characters |
| Descriptions            |   250 characters |
| Option labels           |    60 characters |
| Short Answer responses  |   255 characters |
| Paragraph responses     | 4,000 characters |

<div data-with-frame="true"><figure><img src="https://1615271746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKyFKMqftsmT6qln9zo5y%2Fuploads%2FDicFg6k71eZVdb6mBHN8%2Fsmart_forms_answer_format.png?alt=media&amp;token=1ff24f9b-6ba8-410d-900c-e4a9da8a5d0b" alt=""><figcaption><p>Smart Forms - Set response length and format requirements.</p></figcaption></figure></div>

### Risk scores

Enable **Score answers for risk** on choice questions to assign non-negative scores to options. For country questions, use **Set risk scores** to configure individual countries or apply a score across a region.

A question's score is the sum of its selected options. Section scores add the scores of their questions, and the form score adds the section scores. Hidden questions contribute nothing. An **Other** response scores **0**.

**Yes / No** questions cannot be scored. If a Yes answer needs a score, use **Choose one** with Yes and No options.

Scores can be used in visibility rules and are included in results. A score alone does not make an approval or rejection decision.

<div data-with-frame="true"><figure><img src="https://1615271746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKyFKMqftsmT6qln9zo5y%2Fuploads%2FMdAwR7zFLlrGVkZUppbK%2Fsmart_forms_risk_scores_country.png?alt=media&amp;token=a4cb8596-ee21-404b-bf7a-f8814af2a3b5" alt=""><figcaption><p>Smart Forms - Assign country scores to reflect your risk framework.</p></figcaption></figure></div>

### Calculated fields and answers

Calculate values from information already collected instead of asking customers to enter them again.

| Calculation  | Setup                                                                                                | Customer visibility                                                          |
| ------------ | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
| Age          | Configure a Date Picker as a date of birth.                                                          | Hidden calculated value.                                                     |
| Column total | Total a numeric or percentage Table column.                                                          | Hidden calculated value; ownership validation can also show a running total. |
| Formula      | Configure a Number or Amount question using numeric answers or Amount answers with fixed currencies. | Configurable.                                                                |

For example, `{Monthly income} * 12` calculates annual income from a monthly amount. Calculated values can be used in rules and are identified as calculated in the result.

<div data-with-frame="true"><figure><img src="https://1615271746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKyFKMqftsmT6qln9zo5y%2Fuploads%2F4zdqV9NoMSemqLvhWV5N%2Fsmart_forms_number_formula.png?alt=media&amp;token=2a3c4c77-7d1f-4edd-b499-dab4506c5824" alt=""><figcaption><p>Smart Forms - Calculate a value from answers already provided.</p></figcaption></figure></div>

### Tables and address history

Use a Table question to collect one row per shareholder, director, bank account, or other item.

To create a shareholder table:

1. Add a **Table** question.
2. Set its entity name to **Shareholder** so the button reads **Add shareholder**.
3. Add columns for the shareholder's name, appointment date, and ownership percentage.
4. Set the minimum number of rows and require the ownership percentage column to total **100**.

Tables support text, number, percentage, email, date, country, phone, single-select, multi-select, amount, address, and single or multiple document-upload columns. Select columns can include an **Other** response.

You can choose which columns appear on collapsed rows and calculate column totals for use in rules.

Use **Address history** when customers must provide addresses covering the last specified number of years without gaps. The form identifies a gap for the customer to resolve.

<div data-with-frame="true"><figure><img src="https://1615271746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKyFKMqftsmT6qln9zo5y%2Fuploads%2Fvcpze0xWryWiAN5lDMiV%2Fsmart_forms_tables.png?alt=media&amp;token=f460c1ab-7a7c-4d6e-a459-11bb87b5066e" alt=""><figcaption><p>Smart Forms - Collect repeated records with typed columns and validation.</p></figcaption></figure></div>

### Document uploads

Single File Upload and Multiple File Upload create documents on the client record. Accepted formats are **PDF, JPG, JPEG, and PNG**, with a maximum size of **4 MB per file**.

| Setting           | Purpose                                                                                                               |
| ----------------- | --------------------------------------------------------------------------------------------------------------------- |
| Document type     | Specify a type, such as bank statement or utility bill, or let the customer choose.                                   |
| Classification    | Identify what the document supports, such as source of wealth, source of funds, address, identity, or company filing. |
| Issuing country   | Fix the country or request it from the customer.                                                                      |
| Additional fields | Configure requests for document number, two sides, country, or classification.                                        |
| Live photo only   | Use the camera on phones. Desktop customers retain the file picker for these upload questions.                        |
| Document count    | Set minimum and maximum counts for Multiple File Upload.                                                              |

<div data-with-frame="true"><figure><img src="https://1615271746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKyFKMqftsmT6qln9zo5y%2Fuploads%2FMnfA0OeKA5O8LaYXj6dP%2Fsmart_forms_upload_settings.png?alt=media&amp;token=51adfdb0-e606-4cf8-b924-8b252e964a7f" alt=""><figcaption><p>Smart Forms - Configure supporting document requirements and classification.</p></figcaption></figure></div>

#### Government ID Upload

Government ID Upload captures an identity document inside the form. The customer selects an allowed document type and issuing country, captures the document, and completes the quality checks before it is saved to the client record.

| Setting                                  | Behavior                                                                                                       |
| ---------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| Accepted documents and allowed countries | Restrict available ID types and issuing countries. All are allowed by default.                                 |
| Quality-check attempts                   | Configure 1–20 attempts; the default is 3.                                                                     |
| Live photo only                          | Require camera capture instead of a file upload.                                                               |
| Fill later questions from this document  | Map extracted details such as name, date of birth, nationality, document number, and dates to later questions. |
| Reuse across stages                      | Capture again, show the document for confirmation, or skip the later capture stage. ID checks still run.       |

An ID check placed before a form can prefill name, date of birth, nationality, and gender.

<div data-with-frame="true"><figure><img src="https://1615271746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKyFKMqftsmT6qln9zo5y%2Fuploads%2Fr1yIs43m2h49ypfe5NI9%2Fsmart_forms_upload_gov_id.png?alt=media&amp;token=e610f21c-c420-41e7-a417-dca61edbe0ea" alt=""><figcaption><p>Smart Forms - Configure ID capture, autofill, and reuse in later verification steps.</p></figcaption></figure></div>

### Business onboarding and Company Search

KYB templates include [Company Search](https://docs.complycube.com/documentation/product-guides/kyc-automation-services/company-search.md). Customers choose the company's registration country and search the business register to populate company details, directors, and shareholders. Manual entry is available as an alternative.

Questions with **Adapt to the company's country** use the relevant field names and formats for that jurisdiction. Fields that do not apply are skipped. Use **Preview as** on the section to inspect the experience for a selected country.

<div data-with-frame="true"><figure><img src="https://1615271746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKyFKMqftsmT6qln9zo5y%2Fuploads%2FNzead31wLhSkeqVwoIW8%2Fsmart_forms_sections_tab.png?alt=media&amp;token=b6d32e72-0e36-4dbc-b90f-e2447942e835" alt=""><figcaption><p>Smart Forms - Add reusable sections for individual or business onboarding</p></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="https://1615271746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKyFKMqftsmT6qln9zo5y%2Fuploads%2FdzVPZ0IGJf560xsMaQZe%2Fsmart_forms_kyb_country_preview.png?alt=media&amp;token=01f21199-a5d1-4e9c-a6d5-1146391e9896" alt=""><figcaption><p>Smart Forms - Review country-specific fields in a KYB section.</p></figcaption></figure></div>

### Addresses and customer updates

Address questions provide search with manual entry as a fallback. Manual entry follows the selected country's field order and required fields. Addresses are saved in ComplyCube's standard address format. You can disable search and restrict available countries.

On supported questions, enable **Save to client record** and choose the field to update. Supported destinations include names, email, phone, date of birth, nationality, country of birth, external ID, and main, alternative, or other addresses.

Updates occur on submission and can be reused by later forms and steps in the session.

<div data-with-frame="true"><figure><img src="https://1615271746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKyFKMqftsmT6qln9zo5y%2Fuploads%2FKYjFAhTzjDG5cTlVElck%2Fsmart_forms_address_settings.png?alt=media&amp;token=4efcf493-f0e6-43fb-9249-27a277918a85" alt=""><figcaption><p>Smart Forms - Configure address capture and client-record mapping.</p></figcaption></figure></div>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.complycube.com/documentation/product-guides/compliance-studio/smart-forms/question-types-and-configuration.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
