Skip to main content

Customize OwnID widget

The default code added to initialize the OwnID SDK has a single parameter: appId. In addition to this required parameter, there are optional parameters that can be added to the initialization code to modify the look of the OwnID button. Each parameter is added to the ownid function of the initialization code as a key/value pair of the JSON object. For example, once you have copied the initialization code to your page, you could edit the ownid function to add the optional textColor parameter:

ownid('init',{
appId: 'a9s8d7f9as7f0as87',
textColor: '#0000FF',
variant: 'button-fingerprint',
infoTooltip: true
});

The following is a complete list of UI customization parameters.

Parameters

  • variant - Determines the design of the OwnID button. Data type is String. Possible values are button(default) and button-fingerprint. The button variation displays a Skip Password button to the right of the password field while the button-fingerprint variation displays a button with a fingerprint icon.
  • infoTooltip - You have the option of displaying an informative tooltip on top of the button (recommended). Data type is Boolean. Default is false.
  • textColor - Defines the color of the Skip Password text and/or the color of the fingerprint icon. Data type is a String formatted as a hex color e.g., #0000FF.
  • borderColor - Defines the color of the border of the OwnID button. Data type is a String formated as a hex color e.g., #0000FF
  • addOrStatement - You have the option of displaying the word "or" in between the password field and the OwnID button. Data type is Boolean. Default is true.