Skip to main content

Configuration Overrides

While your widget's styles and features are primarily managed through the Widget Builder in the Amplify admin UI, you can override specific properties locally on your webpage using the data-config-override attribute.

This is useful when a specific widget instance needs a different color, font size, or feature toggle — for example, turning off the AI summary for a particular provider or matching a landing page's unique color scheme.

How It Works

The data-config-override attribute accepts a valid JSON string that merges over your default CDN configuration.

What You Can Override

CategoryPropertiesExample
stylesaccentColor, textColor, fontFamily, font-size, and most other visual properties"styles": {"accentColor": "#FF0000"}
optionsFeature toggles such as showAISummary, showQuestionSummary"options": {"showAISummary": false}

What You Cannot Override

CategoryReason
filtersData filters are managed exclusively in the admin UI to ensure data integrity.
widgetTypeUse the standard class attribute (amplify-summary, amplify-detail) to control widget type.

Example

<div
class="amplify-summary"
pg-amplify-widget-id="my-clinic-widget-123"
pg-amplify-person-id="dr-john-smith"
data-config-override='{"styles": {"accentColor": "#FF0000"}, "options": {"showAISummary": false}}'
></div>

This renders a summary widget that uses a red accent color and hides the AI summary, regardless of the default configuration set in the admin UI.

See the Reference for the full data-config-override attribute specification.