UI Customisation

Learn how to customise how Smart UI appears on your webpage.


Note when using Bootstrap libraries

We have seen some CSS bootstrap libraries cause issues with the display of the consent dialogue on iOS devices.

This can be resolved by adding an override for z-index property in the .ff-form-overlay class.

Sizing the Smart UI

Since v3.6 (check Version Log), the height and width configuration takes a special value “AUTO”, which mimics the default behavior for HTML block elements. The height will adapt to the Smart UI’s contents, which are variable, and the width will extend to 100% of the parent’s width.

Other values for height and width configuration, available from early versions, are

  • FULL”, which uses the innerHeight and innerWidth of the viewport
  • yy%”, which makes the Smart UI size as a percentage of its container
  • yypx”, which makes the Smart UI size fixed in pixels

You may use any combination of values for width and height. For a decent user experience, we recommend the minimum dimensions to be 380px wide and 500px tall.

But how to define its size via CSS or JavaScript?

Changing the Smart UI configuration will cause it to reload, restarting the flow. If you need more dynamic sizing, maybe to make it more responsive, you might assign width and height to “100%” and either:

  1. Resize its container.
  2. Override the width and height using CSS with important rules or JavaScript directly to the ff-onboarding-widget element.


Note that configuring the width and height with “100%” is mandatory for this use case, so the inner elements are aware they need to adapt to external sizing rules.

AUTO height with max-height CSS rules

Configuring height as AUTO will always allow the Smart UI to grow with its contents. If you wish to limit that growth with max-height styling rule, you’ll notice that although the root element ff-onboarding-widget obeys that constraint, the contents don’t. They will overflow the root element, just like a div with variable contents would.

If you come across this situation, you may also add overflow: scroll to the styling so the content won’t overflow anymore and users can still scroll and see the rest of the contents.

Two problems arise with this workaround:

  1. The “next” buttons at the bottom of most pages won’t be always visible and might be hidden under the scroll region.
  2. Dropdowns might be hidden under the scroll region and depending on the absolute size of the Smart UI, the dropdowns might create a temporary scroll effect, which in general doesn’t look very good.

Custom CSS


Visit Migrating v2 to v3

v2 only

Since v2.3.0, the shadow DOM was removed and external styles can now target elements within . This means it's now possible to customize it to look like it belongs to the host platform.

While that is an advantage overall, it also means some unintentional styles may be injected into the Smart UI and have undesirable effects. Most websites and web applications don't use generic element selectors as they don't target anything specific, but let us know if your platform requires a version that is isolated using the shadow DOM. (examples below)

Smart UI CSS Selectors

Selectors throughout the Smart UI are intended to facilitate overriding their styles, but we're open to suggestions and requests on how to make style override simpler. Here is a quick guide on how to override styles:

  1. The font family for the Smart UI can be changed targeting the root #ff-onboarding-widget. Any font family available on the page can be used. The default styling expects the following font weights and styles, where weights fallback to the closest available one:

    1. 300, Regular
    2. 300, Italic
    3. 400, Regular
    4. 400, Italic
    5. 700, Regular
  2. Selectors are prefixed with "ff-", to avoid targeting external elements

  3. Page titles can be targeted with .ff-title

  4. Page subtitles can be targeted with .ff-subtitle

  5. Every page has multiple levels of containers, which can be used to target specific views. They are named View, Form, and Input, but that only refers to how they access data internally and has no meaning to how they should be displayed or how they behave externally, so you may disregard that naming.

In the list below, an item in the form [class &&] followed by an indented inner list means that the class is appended with one of the following listed classes. Otherwise, indented inner lists mean they are contained within the parent class. Elements usually have multiple intermediary containers not mentioned here, so avoid using the direct child selector (>).
1. .ff-welcome-view
2. .ff-initial-data-view
1. .ff-document-form
1. .ff-document-type
2. [.ff-document-input &&]
1. .ff-passport-input
2. .ff-medicare-input
3. .ff-licence-inputs-container
2. .ff-personal-details-form
1. .ff-fullname-input
2. .ff-dob-input
3. .ff-address-input
1. .ff-address-autocomplete
2. .ff-address-manual-input
3. .ff-details-review
1. .ff-document-review-input
2. .ff-applicant-review-input
3. [.ff-the-input &&], which is the specific form being reviewed, shown after clicking the pen to edit that specific field. It will also have one of the following classes that have been shown before in .ff-initial-data-view
1. [.ff-document-input && specific document type] same as .ff-document-input above
2. .ff-fullname-input
3. .ff-dob-input
4. .ff-address-manual-input
4. .ff-no-match, which contain revision for personal details
1. .ff-warning-no-match
2. .ff-personal-details-form and its children, same as above
5. .ff-partial-match, which contain revision for document details
1. .ff-warning-partial-match
2. .ff-review-document and same children as .ff-details-review, but only for documents
3. .ff-document-form, same as .ff-document-form above
6. .ff-warning-success
7. .ff-failure-view

  1. Most basic elements come from our external component library and for that reason they have stronger targeted styles. They are elements such as Form Inputs, Progress Bar, Dropdowns, Check Boxes, Buttons and What we call Go Ahead Buttons, which are Buttons with an Icon, Label Text, Hint text and an Arrow icon pointing to the right. They can still be targeted but might require greater specificity, including the use of !important rules. Their inner structure is the following.

    1. Button
      1. button.ff-basic-button, which is a simple button element
    2. Go Ahead Button
      1. button.ff-goahead-button
      2. .ff-icon, the custom icon
      3. .ff-label
        1. .ff-main-label, title in bold
        2. .ff-hint-label, small italic hint below the title
      4. .ff-arrow, the arrow icon
    3. Progress Bar
      1. .ff-progress-bar, grey container
        2. .ff-progress, the action progress, in blue
    4. Check Box
      1. .ff-the-tick
        1. .ff-icon
      2. .ff-label, all text associated with the check box
    5. SelectOption (dropdowns that might also be displayed as a full spread list of options for better UX on small screens)
      1. .ff-select-option, when it's a regular dropdown is just a wrapper for a third party library
        1. .ff-the-select-box, the third party element
      2. .ff-select-option.ff-spread, in case the options list is spread on the screen instead of a dropdown, which makes it a sequence of ul li
        1. .ff-select-option-filter, the filter text input that might be present or not, based on configuration. See details in Generic Input
        2. ul.ff-select-option-options, the actual options list
        3. li.ff-select-option-label, some spread lists might have a first static list item that is simply a label for the list
        4. li, all the option list items
    6. Generic Input, the basic inputs such as text and number input
      1. .ff-generic-input
        1. .ff-label, contains the label text and might contain other elements
        2. input, the basic native Html input element
  2. Regarding the disabled state

    1. Button and Go Ahead Button have a disabled state that can be targeted with the attribute selector [disabled]
    2. Generic Input will have .ff-disabled in its root .ff-generic-input element, and [disabled] in the native input element
    3. Select Option will contain .ff-disabled in its root
  3. Regarding the focused state

    1. Being a wrapper for a native Html input, the Generic Input element:focus state can be targeted directly .ff-generic-input input:focus, to change the default border surrounding it
  4. Other states will still be made available

Adding styles using javascript

Of course, it's not necessary to include stylesheets in such a 90's manner. Styles injected via bundler's such as webpack will work without any issues. Another way is to inject them manually:

var style = document.createElement('style');
style.innerHTML = `
  #ff-onboarding-widget {
    font-family: "Comic Sans MS"

Custom Styles - Examples

Custom Styles

Custom Styles

Initialization in script tag and custom styles.

This is in demo mode, so ff-onboarding-widget tag is missing the token in the ff attribute.

Basic Initialization

Basic Initialization

Changing the font

Changing the font

Custom Style Example

Custom Style Example