# 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 when starting the server: ```console $ vl-convert serve \ > --vega-plugin ./double-value.js \ > --port 3000 ``` Every request handled by this process can then use `doubleValue`. Put the specification above in the `spec` field of a normal `/vegalite/*` request. Save this complete request body as `request.json`: :::{dropdown} request.json :open: ```{literalinclude} /_generated/requests/plugin-startup-png.json :language: json ``` ::: ```console $ curl http://127.0.0.1:3000/vegalite/png \ > -H 'Content-Type: application/json' \ > --data-binary @request.json \ > --output chart.png ``` 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.