> 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.md).

# Smart Forms

Build dynamic KYC and KYB questionnaires. Collect customer information, declarations, and supporting documents within your verification workflows.

### Smart Forms Overview

Smart Forms let you add customizable questionnaires to [ComplyCube Workflows](https://docs.complycube.com/documentation/product-guides/compliance-studio/workflows.md). Use them to collect information for **Know Your Customer (KYC)**, **Know Your Business (KYB)**, **customer due diligence (CDD)**, and **enhanced due diligence (EDD)** alongside your verification checks.

Organize questions into sections, show follow-up questions based on earlier answers, and assign risk scores to selected responses. You can also capture supporting documents, calculate values, and reuse customer information across the verification journey.

Each form runs within a [workflow session](https://docs.complycube.com/documentation/product-guides/compliance-studio/workflows.md#workflow-session), with responses available in the Portal or through the API.

{% hint style="info" %}
Contact your **Account Manager** to enable Smart Forms.
{% endhint %}

<figure><img src="https://1615271746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKyFKMqftsmT6qln9zo5y%2Fuploads%2FIh1ms2LOCS3myBmlRqPc%2Fsmart_forms_builder.png?alt=media&amp;token=95cf4458-23f9-4975-bdb0-acb550b91023" alt=""><figcaption><p>Smart Forms - Build and configure dynamic questionnaires in the Smart Forms builder.</p></figcaption></figure>

### Common use cases

<table data-search="false"><thead><tr><th>Use case</th><th>What to collect</th></tr></thead><tbody><tr><td><strong>KYC and CDD questionnaires</strong></td><td>Personal details, employment information, customer declarations, and periodic review updates.</td></tr><tr><td><strong>Enhanced due diligence</strong></td><td>Additional questions and supporting evidence based on customer responses or configured risk scores.</td></tr><tr><td><strong>Source of funds and source of wealth</strong></td><td>Structured information about the origin of funds or assets, with supporting bank statements, pay stubs, or other documents.</td></tr><tr><td><strong>Business onboarding</strong></td><td>Company details, directors, shareholders, and ultimate beneficial owners (UBOs).</td></tr><tr><td><strong>Tax residency</strong></td><td>Countries of tax residence and relevant tax identification numbers.</td></tr><tr><td><strong>Employment and residency</strong></td><td>Employment declarations, address history, and information used in right-to-work or residency checks.</td></tr><tr><td><strong>Suitability assessments</strong></td><td>Financial circumstances and other information needed for your assessment process.</td></tr><tr><td><strong>Consent and agreements</strong></td><td>Disclosures, acknowledgments, and documents for <a href="https://docs.complycube.com/documentation/product-guides/compliance-studio/e-signatures.md">electronic signing</a>.</td></tr></tbody></table>

### How Smart Forms work

Smart Forms run as steps within a verification workflow, alongside identity verification and other checks. Each customer completes the form as part of a [workflow session](https://docs.complycube.com/documentation/product-guides/compliance-studio/workflows.md#workflow-session), which records their verification journey.

Questions are organized into sections. Conditional logic determines which questions and sections appear based on earlier answers, calculated values, or configured risk scores. This lets you request additional information when needed, such as supporting documents for enhanced due diligence.

Forms can reuse information collected earlier in the journey and save supported answers to the client record for use in later steps.

All responses are securely stored and linked to the workflow session. Your team can review submitted answers in the Portal or retrieve them through the API.

<div><figure><img src="https://1615271746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKyFKMqftsmT6qln9zo5y%2Fuploads%2F82xNPp0ISnFhwTp7CLJt%2Fsmart_forms_1.png?alt=media&amp;token=8ae5d9f7-8b41-4b41-804b-84383dca6515" alt="Smart Forms step in a ComplyCube workflow for KYC data capture" width="563"><figcaption></figcaption></figure> <figure><img src="https://1615271746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKyFKMqftsmT6qln9zo5y%2Fuploads%2F0nyR6BU9qNWCyREcCtO3%2Fsmart_forms_3.png?alt=media&amp;token=8356ceb1-a24d-4de2-b964-e01e3e047c94" alt="Smart Forms preview showing a dynamic questionnaire in a customer verification journey" width="563"><figcaption><p>Smart Forms - Preview</p></figcaption></figure> <figure><img src="https://1615271746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKyFKMqftsmT6qln9zo5y%2Fuploads%2Fch6BEhWRxi1QFNRd6rXh%2Fsmart_forms_2.png?alt=media&amp;token=30636d92-df62-4f93-92af-dbc79bbbaa08" alt="Smart Forms screen used to collect compliance declarations and supporting documents" width="563"><figcaption></figcaption></figure></div>

### Creating a Smart Form

{% @arcade/embed flowId="8V2AiLifThazynLwbjL9" url="<https://app.arcade.software/share/8V2AiLifThazynLwbjL9>" %}

Smart Forms can be created directly within the [workflow designer](https://docs.complycube.com/documentation/product-guides/compliance-studio/workflows.md#designing-workflows). Open a [workflow](https://portal.complycube.com/workflowTemplates) in the Portal, add a **Smart Form** step, and launch the form builder.

You can start from scratch or select content from the **Form library** and **Sections** tabs in **Add content**. Available library content includes individual onboarding, business onboarding, company details, UK Right to Work questions, and more.

**Library** sections have a fixed structure. You can edit their wording and translations, but you cannot add, remove, or change their question types.

The **Editor** tab displays your sections, the section you are editing, and the properties of the selected item. Drag sections and questions to change their order.

Give each section a clear title. For each question, configure its title, description, required status, and any validation or visibility rules. Use guidance to explain unfamiliar terms or link to additional information.

<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%2F5EQnk8jQIKqodzVjFqUT%2Fsmart_forms_library_tab.png?alt=media&amp;token=97e9f69e-342c-46ff-9be0-c78c4d1c7810" alt=""><figcaption><p>Smart Forms - Start with library content and tailor the wording to your onboarding process.</p></figcaption></figure></div>

### Conditional questions and risk scores

Visibility rules control when a question or section appears. A rule can evaluate an earlier answer, a calculated value, or the risk score of a question or section.

Select the question or section, open **Visibility**, and select **Add rule**. Choose the value to evaluate, an operator, and a comparison value. Combine conditions with **and** or **or** when needed. The **Expression** tab lets you view and edit the rule as text.

Hidden questions are not presented to the customer and do not contribute to the section score.

You can assign scores to **Choose one**, **Choose multiple**, **Country**, and **Multi-Country Selector** questions. Selected scores add together at question, section, and form level.

<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%2FH2AT9VtaCy5PfHJGWEF7%2Fsmart_forms_rule_builder.png?alt=media&amp;token=5e600b27-ab92-4ed6-b595-1c54c94bae75" alt=""><figcaption><p>Smart Forms - Show follow-up questions only when the configured conditions are met.</p></figcaption></figure></div>

{% hint style="info" %}
A Smart Form score does not automatically approve or reject a customer. Configure the rules or downstream process that should use it. These questionnaire scores are distinct from the broader [AML Risk Scoring](https://docs.complycube.com/documentation/product-guides/due-diligence-tools/risk-profile.md) service.
{% endhint %}

{% hint style="info" %}
For scoring behavior, calculations, tables, and field settings, see [Question types and configuration](https://docs.complycube.com/documentation/product-guides/compliance-studio/smart-forms/question-types-and-configuration.md).
{% endhint %}

### Collecting and reusing customer information

Smart Forms support **text**, **choices**, **dates**, **amounts**, **countries**, **addresses**, **tax numbers**, and **document uploads**. **Tables** let customers add multiple shareholders, directors, addresses, or other records.

Use **Government ID Upload** to capture identity documents within a form and populate mapped questions with extracted information. You can also configure how the document is reused in later verification steps. Reusing capture does not remove the underlying ID checks.

On supported questions, enable **Save to client record** and select the field to update. The record is updated when the form is submitted, allowing later steps to reuse the information. For example, a later Proof of Address step can use a saved address.

### Customer experience and translations

On desktop, customers move through one section per screen. On phones, questions appear individually with a progress bar. Sections hidden by visibility rules are skipped.

In **Form settings**, enable **Progress saving** to let customers leave and return to their place in the form. Enable **Review screen before submission** to let them review and edit answers before submitting.

<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%2F0xaOSD6tH18XnW5iDWSb%2Fsmart_forms_settings.png?alt=media&amp;token=f391480a-6725-4d62-858c-c49124258de9" alt=""><figcaption><p>Smart Forms - Configure progress saving and the review screen.</p></figcaption></figure></div>

English is the source language for translations. In the **Translations** tab, add a language and enter the translated text, or export a CSV for translation and import it back.

Titles, choice labels, and read-only content must be translated before you can save a form with an added language. Other untranslated strings fall back to English.

<figure><img src="https://1615271746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKyFKMqftsmT6qln9zo5y%2Fuploads%2Fo8IaSm9RjGiEQXsELb2l%2Fsmart_forms_translations.png?alt=media&amp;token=d30cca97-d500-4109-a31b-adb8eb7946d1" alt=""><figcaption><p>Smart Forms - Manage translated form content for the languages you support.</p></figcaption></figure>

### Adding eSignatures

Use the **eSignature** tab to add **electronic signing** after form submission. Choose a signature level and either generate a document from the form or use your own PDF with answers placed on it. See [eSignatures](https://docs.complycube.com/documentation/product-guides/compliance-studio/e-signatures.md) for signature levels and setup.

The **Signature** question captures a drawn or typed signature image. It does not configure an eSignature signing journey. Use the eSignature capability when your process requires an electronic signing workflow.

<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%2FQOC9PYYvFoGGPpQUwsjL%2Fsmart_forms_esignatures.png?alt=media&amp;token=2fd42851-05c1-4dcb-bb4a-4af5578421e8" alt=""><figcaption><p>Smart Forms - Configure a document and signature level for the signing journey.</p></figcaption></figure></div>

### Previewing and updating forms

Use **Preview** to test desktop and mobile layouts before publishing. Preview does not create a client, workflow session, or document. After submission, **Submitted answers** shows a sample result that you can download as JSON.

Test each conditional path, required field, translation, and document request. Check that the form collects the information you need and that its IDs match your integration.

Saving validates the form. If an issue prevents saving, use **Go to issue** to open the affected control.

Saving the workflow creates a new workflow version. Customers already in a session remain on the version they started.

{% hint style="info" %}
Keep form, section, and question IDs stable once an integration uses them. Responses are identified by these IDs, so renaming them can affect downstream processing.
{% endhint %}

### Reviewing smart form responses

Using the [Portal](https://portal.complycube.com/), open the relevant [workflow session](https://portal.complycube.com/workflowSessions) to review Smart Form responses.

For integrations, use the [Workflow Sessions API](https://docs.complycube.com/documentation/api-reference/core-resources/workflow-sessions.md). Workflow session webhooks can notify your application of session changes; retrieve the session to inspect the responses.

See [Responses and integration](https://docs.complycube.com/documentation/product-guides/compliance-studio/smart-forms/responses-and-integration.md) for result structure, drafts, and the difference between blank and missing answers.

### Frequently asked questions

<details>

<summary>What is a Smart Form in a KYC workflow?</summary>

Smart Forms are dynamic questionnaires used inside a verification workflow.

They help you collect extra customer data, declarations, and supporting evidence as part of the same KYC journey.

</details>

<details>

<summary>Can Smart Forms collect supporting documents and declarations?</summary>

Yes.

You can use Smart Forms to capture declarations, acknowledgements, signatures, and supporting files such as payslips, bank statements, or contracts.

</details>

<details>

<summary>Can Smart Forms show different questions based on earlier answers?</summary>

Yes.

Smart Forms support **conditional logic**, so questions and sections can change based on previous answers, selected journeys, or other workflow conditions.

</details>

<details>

<summary>Can Smart Forms support enhanced due diligence and ongoing KYC reviews?</summary>

Yes.

Smart Forms are well suited for **enhanced due diligence (EDD)** questionnaires, **source of funds** checks, **source of wealth** questions, and **customer due diligence refresh** flows.

Use **conditional questions and sections** to collect additional information or evidence when a response or configured risk score meets your criteria.

</details>

<details>

<summary>Do Smart Forms work with workflows and compliance policies?</summary>

Yes.

Smart Forms run inside [Workflows](https://docs.complycube.com/documentation/product-guides/compliance-studio/workflows.md) and can support rule-based decisions alongside [Compliance Policies](https://docs.complycube.com/documentation/product-guides/compliance-studio/policies.md).

</details>

<details>

<summary>Does uploading a document in a Smart Form verify it?</summary>

No.

Document collection and verification are separate parts of the journey. Configure the relevant verification checks in your workflow. Government ID Upload can reuse captured documents in later ID verification steps.

</details>

<details>

<summary>Can I collect details for several shareholders or addresses?</summary>

Yes.

Use a Table question for repeated records. You can require an ownership percentage column to total 100%, or use Address history to collect a specified period without gaps.

</details>

<details>

<summary>Where can I access Smart Form responses?</summary>

Responses are linked to the workflow session and stored securely.

You can review them in the **Portal**, retrieve them through the **API**, or receive them through **webhooks** for downstream processing.

</details>

### Related topics

* [Workflows](https://docs.complycube.com/documentation/product-guides/compliance-studio/workflows.md) to build end-to-end KYC/AML verification journeys.
* [eSignatures](https://docs.complycube.com/documentation/product-guides/compliance-studio/e-signatures.md) to embed document signing and capture signature evidence.
* [AML Risk Scoring](https://docs.complycube.com/documentation/product-guides/due-diligence-tools/risk-profile.md) to perform broader customer risk assessments.
* [Compliance Policies](https://docs.complycube.com/documentation/product-guides/compliance-studio/policies.md) to evaluate regulatory and business rules.


---

# 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.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.
