How to publish a plugin
5 steps to go from a custom Metabase visualization to a published plugin on MetaViz Hub.
Create a custom visualization
Follow the official Metabase documentation to build your custom visualization. This covers the SDK, the component API, and how Metabase loads external plugins.
Read the Metabase custom viz docs →Add the required files to your repo
MetaViz Hub reads one required file at the root of your repository.
metabase-plugin.jsonThe standard Metabase manifest — required to load your plugin in Metabase. See official documentation →Preview images (recommended)
Place your screenshots in the assets/ directory at the root of your repo. All image files (.png, .jpg, .webp…) will be picked up automatically and displayed as a carousel on both the catalog card and the plugin detail page.
No configuration needed — just drop the images in assets/ and they appear automatically.
Submit your repository
Make sure your repo is public on GitHub, then paste the URL on the submit page. We'll read your metabase-plugin.json automatically, then ask you to fill in category, description and tags in a short form.
Wait for validation
Our team reviews every submission within 48 hours. We check the manifest, the preview image, and that the plugin loads correctly in Metabase.
If your submission is rejected, you'll receive a reason via GitHub issue and can fix and resubmit at any time.
Your visualization is live
Once approved, your plugin appears in the catalog. The community can discover it, rate it, and install it directly from its detail page.
Browse the catalog →