Widget Customization
Customise your import widget to match your brand and design system using the AppearanceConfig options.
Basic Example and Setup
const { showWidget, isImplerInitiated } = useImpler({
projectId: "",
templateId: "",
accessToken: "",
appearance: {
primaryColor: '#FF6B35',
fontFamily: 'Inter',
borderRadius: '8px'
}
});
AppearanceConfig type definition
export type AppearanceConfig = {
widget?: {
backgroundColor?: string;
};
primaryColor?: string;
fontFamily?: string;
borderRadius?: string;
primaryButtonConfig?: ButtonConfig;
secondaryButtonConfig?: ButtonConfig;
};
export type ButtonConfig = {
backgroundColor?: string;
buttonShadow?: string;
textColor?: string;
hoverBackground?: string;
hoverBorderColor?: string;
borderColor?: string;
hoverTextColor?: string;
};
Note - All properties, including the appearance
object, are optional. If none are provided, the widget will fall back to its default appearance.
ApperaranceConfig Property with Available Customization Options
Widget Properties:
backgroundColor
- Sets the main widget background colorprimaryColor
- Main brand color used throughout the widgetfontFamily
- Font family for all text elementsborderRadius
- Corner rounding for all elements
Button Properties:
backgroundColor
- Button background color (default state)textColor
- Button text color (default state)borderColor
- Button border color (default state)buttonShadow
- Drop shadow effecthoverBackground
- Background color when hoveringhoverTextColor
- Text color when hoveringhoverBorderColor
- Border color when hovering
Quick Note
⚠️ Important: We're moving primaryColor
inside the appearance
object. The old way still works but will be deprecated in future releases.
If you have any questions, suggestions, or comments. Feel free to reach out to us over Discord. We’re constantly improving to deliver the best Data Importer for your product, and we value your input.
Last updated
Was this helpful?