Plugin troubleshooting
Editions: Open Source · Free Cloud · Pro
| Symptom | Cause | Fix |
|---|---|---|
type: project is removed; declare capabilities |
Dev/strict YAML still uses type: project |
Add capabilities list |
plugin is not activated for this project (REST 403) |
project.rest without activation or missing project id |
Activate in Project Settings; send X-Apito-Project-ID |
plg_* missing after activate |
Project GraphQL cache stale | upsertPlugin now expires cache; retry / switch project |
| Console plugin blocked | Unsigned/unofficial bundle or checksum mismatch | Official signed bundle only, or use host-rendered settings |
| Plugin in catalog but not in project | Not activated | Project Settings → Plugins → Add from catalog |
| Second project sees plugin APIs | Should not | Confirm activation row exists only on intended project |
Compatibility: engine range that ships this capability model; older consoles that still query type keep working (system). SDKs that still send reserved protobuf type values are ignored for install class.