Metadata

Every plugin has a metadata.json file at its root. The file describes the plugin and controls how it appears in the catalog.

The core fields (name, displayName, description, category, author, and icon) are set when you export from the UI. The remaining fields (notably links, keywords, and any adjustments to base.config) must be added or edited manually in the JSON after export.

Example

{
  "name": "my-plugin",
  "displayName": "My Plugin",
  "version": "1.0.0",
  "schemaVersion": "2.0",
  "category": "SquaredUp Internal",
  "type": "cloud",
  "author": {
    "type": "community",
    "name": "your-github-username"
  },
  "base": {
    "plugin": "WebAPI",
    "majorVersion": "1",
    "config": {}
  },
  "links": [
    { "category": "documentation", "url": "https://github.com/squaredup/plugins/blob/main/plugins/MyPlugin/v1/docs/README.md", "label": "Help adding this plugin" },
    { "category": "source", "url": "https://github.com/squaredup/plugins/tree/main/plugins/MyPlugin/v1", "label": "Repository" }
  ],
  "keywords": ["monitoring", "alerts", "myservice"]
}

Properties

Property
Set by
Description
name
Export UI
Unique identifier for the plugin. Uses lowercase kebab-case by convention (e.g. my-plugin, google-sheets).
Note

The plugin folder name in the repo uses PascalCase with no separators (e.g. MyPlugin, GoogleSheets). These are two separate things.

displayName
Export UI
The name displayed in the catalog.
description
Export UI
One sentence describing what the plugin integrates with
category
Export UI
Use "SquaredUp Internal" during development; update before publishing. Reuse an existing category from other plugins where possible
author
Export UI
type should be "community"; name should be your GitHub username
version
Manual (JSON)
Semantic version, see Plugin versioning. Starts at 1.0.0 on export and must be bumped manually for every subsequent change
schemaVersion
Export (auto)
Always "2.0" for Low Code Plugins
base.plugin
Export (auto)
The base plugin name, typically "WebAPI"
base.majorVersion
Export (auto)
The major version of the base plugin
links
Manual (JSON)
An array of link objects. Each has url, label, and category fields. Must be added manually after export. Include a "source" link (GitHub repo) and a "documentation" link (README).
keywords
Manual (JSON)
Add relevant keywords to improve discoverability in the catalog. Must be added manually after export.

Was this article helpful?


Have more questions or facing an issue?