diff --git a/satellite/satellitedb/dbx/identity.dbx b/satellite/satellitedb/dbx/identity.dbx
index 79d4ab740..d0e2f5d5c 100644
--- a/satellite/satellitedb/dbx/identity.dbx
+++ b/satellite/satellitedb/dbx/identity.dbx
@@ -1,11 +1,14 @@
-//--- peer_identity ---//
-
+// peer_identity is a cache for storagenode certificates.
 model peer_identity (
     key node_id
 
+    // node_id refers to storj.NodeID.
     field node_id            blob
+    // leaf_serial_number is the certificate serial number.
     field leaf_serial_number blob (updatable)
-    field chain              blob (updatable) // x509 ASN.1 DER content
+    // chain is the x509 certificate as ASN.1 DER.
+    field chain              blob (updatable)
+    // updated_at is the time it was last updated.
     field updated_at         timestamp ( autoinsert, autoupdate )
 )