Skip to content
Last updated

Branded SDK appearance

The branded SDK can match the colors, logo and typography of your wallet. Use the appearance options and initialization example below to style the embedded experience without changing eligibility, activation or reward amounts.

Pass appearance to Percents.init(...) to match the issuer host page's appearance.

Percents.init({
  container: '#percents-widget',
  sessionEndpoint: '/api/percents/session',
  appearance: {
    displayName: 'Branded Rewards',
    logoUrl: 'https://issuer.example.com/logo.svg',
    primaryColor: '#0079d2',
    accentColor: '#028a00',
    fontFamily: "Gilroy, 'Gilroy Regular', ui-sans-serif, system-ui",
  },
});
FieldDescription
displayNameName shown in the SDK header. Defaults to Branded Rewards.
logoUrlHTTPS image URL shown beside the display name.
primaryColorSix-digit hex color for primary actions and selected states.
accentColorSix-digit hex color for secondary emphasis and highlights.
fontFamilyCSS font-family string applied inside the iframe.

To change appearance after mounting, call destroy() on the current SDK instance and initialize a new one.

Try the fields in the SDK Playground.