Questionnaire Configuration

The questionnaire within the KYB process is a dynamic form used to collect specific information about a company—such as the nature of its business, sources of funds, or ownership structure—in order to assess compliance risks. This questionnaire can be customized.

ℹ️

Questionnaire configuration is done entirely in the AdvanGuard Dashboard: Configuration → Questionnaire. No API calls are required to set up the questionnaire template itself — only generate a link for integration.

Questionnaire Capabilities

The AdvanGuard Questionnaire builder supports a rich set of question types and form behaviors:



17+ Question Types

Single Selection, Multiple Selection, Short Text, Long Text, Number, Email, Link, Signature, Phone Number, Country, Currency, Date, Date Time, Address, Consent Agreement, Document.

Conditional Branch Logic

Show or hide specific question cards or entire sections dynamically based on a respondent's previous answers.

Repeatable Sections

Allow applicants to add multiple Directors, Shareholders, or UBOs within a single form by clicking "+ Add" to loop through the section.

Static Embeddable Link

A permanent dedicated URL is auto-generated on publish. Embed it in your website or send directly to merchants — no API integration needed.

Page Break

A questionnaire can be configured with multiple pages, each featuring a distinct theme, resulting in a more user-friendly experience.

Custome Section

A modular section of a custom questionnaire, offering greater clarity and flexibility regarding the module's purpose.

Custome Question Group

Define a custom goup of questions that can include multiple fields, such as multiple structured address fields.

Data Sources Auto-Fill

Integrated official data sources to auto-fill the fileds of the questionnaire (SG-Singpass/Corppass).

Moblie/PC Screen Supported

The questionnaire supports both mobile and PC screens, featuring distinct page layouts tailored to the display requirements of each scenario.

UI Customization

The questionnaire's UI style allows for customization of the logo, colors, text, buttons, etc. It can ensure the unified style of business scenarios.



1

Create a New Questionnaire

a

Navigate to Questionnaire List

In the AdvanGuard Dashboard, go to Configuration → Questionnaire. The list shows all previously created questionnaires including their name, Questionnaire ID, and publish status.

b

Click "+ Create"

Click the + Create button in the top-right corner to enter the questionnaire configuration flow.

Questionnaire


2

Questionnaire Settings

The first step configures the questionnaire's basic infomation. The preview panel on the right refreshes in real time as you make changes.

Internal Identifiers

FieldRequiredDescription
Questionnaire NameRequiredInternal identifier (e.g. APAC Merchant Standard KYC Form)
DescriptionOptionalInternal notes on the questionnaire's compliance purpose

Form Display Controls

Toggle the following display elements on or off via the Form Display section:

ToggleEffect
TitleShow or hide the main form title (e.g. "Enterprise Account Application") visible to end users
SubtitleShow or hide the form subtitle
Brand LogoShow or hide your company logo at the top of the form

Questionnaire Settings



3

Questionnaire Structure

The structure editor shows the drag-and-configure panel on the left, with a live end-user H5/Web preview on the right.

📍

The platform pre-configures two questionnaire sets: Company Details (enterprise questionnaire) and Associated Profiles (questionnaire for related profiles). You can use these out of the box without any input.

Adding Custom Sections

a

Add a Custom Section

Click "+ Add Custom Section" to define a new compliance chapter (e.g. Enterprise Information, Shareholder Information, Director Information).

In Section Settings, configure the section's title, description, and display settings.

b

Set Conditional Display Logic

Click the edit icon next to any question card or section's Display Condition to configure trigger rules. For example:

When the primary company's "Registered Country" equals "Singapore", dynamically show the "LEI Code" input field.
c

Add Questions

Scroll to the Questions section and choose one of two options:

OptionDescription
Create Custom QuestionCreates a question with no system-defined logic or field mapping. Used purely for custom data collection.
Add Question from DictionaryImports a pre-built dictionary item. Its underlying field parameters (API key, validation rules) are preset and auto-synced.
d

Configure Each Question

For custom questions, configure: Title, Description, Placeholder, and toggle Required. For question types like Single Selection, you can edit each specific input item and its key-value pairs.

Referencing Dictionary Items

When adding a question from the dictionary, use the search modal:

Search MethodDescription
Keyword searchEnter at least 4 characters in the left input box to trigger fuzzy search by Display Name
Type filterFilter by dictionary type: Address, Attachment, Short Text, etc.

Before confirming, check these key attributes in the list:

AttributeWhat to verify
DisplayName / AliasNameConfirm the customer-facing name and the unique backend alias match what you expect
ClassStandard = system built-in high-frequency compliance field; Custom = team-defined field
Category👤 Individual (person) vs 🏢 Company — ensure the field type matches your section
💡

After confirming, the dictionary item is automatically converted into a standard question card in the questionnaire. Its underlying rules (character limits, API key values, etc.) stay in real-time sync with the dictionary item.

Section


Question


Add question from dictionary


4

Preview & Publish

a

Save Draft

Click Save at any time to save the current configuration as a draft without affecting any active submissions.

b

Publish

When ready, click Publish in the top-right corner. After publishing, the system automatically generates a Static Embeddable Link (permanent URL). Copy this URL to deploy in your merchant portal or send directly to target customers — no API integration required.

✅ After publishing, check the Application list in the AdvanGuard Dashboard to find the qnreIdentifierVersion. This value is required for Mode 1 (API Form Submit) API calls.


5

UI Customization

Customize the visual appearance of your questionnaire form to match your brand. Go to Configuration → Customization.

⚠️

If a theme currently being referenced by a questionnaire is deleted, the associated form will automatically revert to the system default visual template.

Managing Themes

From the Customization list you can:

Search

Enter a theme name (left-prefix fuzzy search)

Duplicate

Clone an existing theme and rename it for further editing

Delete

Permanently remove a theme (affects linked questionnaires)

Theme Configuration Tabs

When creating or editing a theme, five configuration tabs are available:

Tab 1General

Theme Name (required): 2–50 characters; supports letters, numbers, spaces, hyphens, underscores, parentheses, and colons. Cannot begin/end with spaces; no emoji or special symbols. Cannot be changed after creation.

Description (optional): Max 200 characters. Describes the theme's business purpose. Malicious script tags are blocked to prevent XSS attacks.

Tab 2Logo & Colors
SettingDescription
LogoUpload brand logo (PNG/JPG only, max 512 KB). Configure top-of-form alignment position.
Overrides the logo setting in Questionnaire Basic Settings.
Background ImageUpload a custom sidebar/background image (PNG/JPG, max 512 KB). If not uploaded, the system uses a default minimal background.
Widget BackgroundBackground color for questionnaire cards and input areas (supports hex + opacity, e.g. #FFFFFF, 100%)
Page BackgroundBackground color for the outer page wrapper
Tab 3Texts

General Settings: Set the global text alignment (left / center / right).

Hierarchy styles — configure independently for Header 1, Header 2, and Body Text:

PropertyOptions
FontBrand font choice (e.g. Rubik, Manrope)
Font WeightExtraLight, Light, Regular, Medium, SemiBold, Bold, ExtraBold
Font SizeFree pixel definition (e.g. 24px, 16px)
Color & OpacityHex color + percentage opacity (e.g. #202528, 100%)
Tab 4Buttons

Configure Primary Button (e.g. "Next", "Submit") and Secondary Button (e.g. "Back") independently:

SettingDescription
General SettingsUnified font, font weight, font size, vertical padding, and corner radius
Background ColorButton fill color (independent per primary/secondary)
Border Color & WidthButton border styling
Font ColorButton label text color
Tab 5Other Components
ComponentSettingDescription
Checkboxes & Radio
Buttons
Item Active ColorBrand highlight color when a user checks a checkbox or radio button
Item Background
Color
Fill color for option boxes in their inactive (unchecked) state

Customization





Did this page help you?