diff --git a/schema.json b/schema.json
index 550d435f..cd988fab 100644
--- a/schema.json
+++ b/schema.json
@@ -1,5 +1,8 @@
 {
+  "$id": "https://raw.githubusercontent.com/xataio/pgroll/main/schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "JSON Schema for pgroll migrations",
+  "description": "This JSON schema defines the structure and properties of pgroll migrations.",
   "allOf": [{ "$ref": "#/$defs/PgRollMigration" }],
   "$defs": {
     "CheckConstraint": {