37 lines
3.2 KiB
Markdown
37 lines
3.2 KiB
Markdown
+++
|
|
title = "plugin.json"
|
|
keywords = ["grafana", "plugins", "documentation"]
|
|
type = "docs"
|
|
aliases = ["/docs/grafana/latest/plugins/developing/plugin.json/"]
|
|
+++
|
|
|
|
# plugin.json
|
|
|
|
The plugin.json file is mandatory for all plugins. When Grafana starts it will scan the plugin folders and mount every folder that contains a plugin.json file unless the folder contains a subfolder named `dist`. In that case grafana will mount the `dist` folder instead.
|
|
|
|
## Schema
|
|
|
|
| Property | Description |
|
|
|-----------------------------|-------------------------------------------------------------------------------------------------------------------------------|
|
|
| id | Unique name of the plugin. |
|
|
| type | One of `app`, `datasource`, `panel` |
|
|
| name | Human-readable name of the plugin |
|
|
| dependencies.grafanaVersion | Required Grafana version for this plugin |
|
|
| dependencies.plugins | An array of required plugins on which this plugin depends |
|
|
| info.author.name | Author's name |
|
|
| info.author.url | Link to author's website |
|
|
| info.description | Description of plugin. Used for search on grafana.com |
|
|
| info.keywords | Array of plugin keywords. Used for search on grafana.com |
|
|
| info.links | An array of link objects to be displayed on this plugin's project page in the form `{name: 'foo', url: 'http://example.com'}` |
|
|
| info.logos.small | Link to the "small" version of the plugin logo, which must be an SVG image. "Large" and "small" logos can be the same image. |
|
|
| info.logos.large | Link to the "large" version of the plugin logo, which must be an SVG image. "Large" and "small" logos can be the same image. |
|
|
| info.screenshots | An array of screenshot objects in the form `{name: 'bar', path: 'img/screenshot.png'}` |
|
|
| info.updated | Date when this plugin was built. Use `%TODAY%` for Grafana to autopopulate this value. |
|
|
| info.version | Project version of this commit. Use `%VERSION%` for Grafana to autopopulate this value. |
|
|
|
|
## Plugin.json Example
|
|
|
|
Here's an example of an up-to-date plugin.json file:
|
|
|
|
https://github.com/grafana/clock-panel/blob/master/src/plugin.json
|