# Vega Plugins Plugins extend Vega with custom functions, transforms, and other chart features. Use one when your specification needs an extension that Vega does not include. The [Vega extensibility API](https://vega.github.io/vega/docs/api/extensibility/) lists the registration functions a plugin can call. :::{warning} A plugin is executable JavaScript. Load plugin files and URLs only from sources you trust. Do not accept caller-supplied plugins on a public service unless you have decided to accept that risk ::: ## Create a Plugin A plugin is a JavaScript ECMAScript module (ESM) whose default export is a function. VlConvert calls that function with the Vega module when a worker starts, before any specification is compiled or parsed. Save this example as `double-value.js`: :::{dropdown} double-value.js :open: ```{literalinclude} /_examples/double-value.js :language: javascript ``` ::: Save this Vega-Lite specification: :::{dropdown} chart.vl.json :open: ```{literalinclude} /_examples/plugin-demo.vl.json :language: json ``` ::: The `calculate` transform can now call `doubleValue`. ## Register the Plugin Register the plugin with `configure()`, then convert as usual: ```python from pathlib import Path import vl_convert as vlc vlc.configure(vega_plugins=["./double-value.js"]) spec = Path("chart.vl.json").read_text(encoding="utf-8") png = vlc.vegalite_to_png(spec) Path("chart.png").write_bytes(png) ``` The plugin stays available to every later conversion in the process. The registered `doubleValue` function doubles the source values before Vega draws these bars: ```{vl-chart} /_examples/plugin-demo.vl.json :vega-plugin: /_examples/double-value.js :alt: Two bars with the source values doubled to four and ten ``` Plugins can also come from HTTPS URLs or inline source, and a plugin can import other modules. See {doc}`../advanced/plugin-loading` for loading modes, import allowlists, prebundling, and caller-supplied plugins, and {doc}`security` for the wider trust model.