diff --git a/packages/reference/src/collection-reference.ts b/packages/reference/src/collection-reference.ts
index b1bb69a1..0e112e86 100644
--- a/packages/reference/src/collection-reference.ts
+++ b/packages/reference/src/collection-reference.ts
@@ -32,7 +32,7 @@ export class CollectionReference<TItem extends JsonifiableObject = JsonifiableOb
   /**
    * Alwatr store engine file format version number.
    */
-  static readonly fileFormatVersion = 1;
+  static readonly fileFormatVersion = 2;
 
   /**
    * Creates new CollectionReference instance from stat.
@@ -64,6 +64,7 @@ export class CollectionReference<TItem extends JsonifiableObject = JsonifiableOb
         extension: StoreFileExtension.Json,
         ver: CollectionReference.version,
         fv: CollectionReference.fileFormatVersion,
+        schemaVer: 1
       },
       data: initialData ?? {},
     };
@@ -140,7 +141,11 @@ export class CollectionReference<TItem extends JsonifiableObject = JsonifiableOb
       throw new Error('store_version_incompatible', {cause: context.meta});
     }
 
-    // if (context.meta.fv === 1) migrate_to_2
+    if (context.meta.fv === 1) {
+      // migrate from v1 to v2
+      context.meta.schemaVer = 0;
+      context.meta.fv = 2;
+    }
 
     context.meta.ver = CollectionReference.version;
   }
@@ -194,6 +199,22 @@ export class CollectionReference<TItem extends JsonifiableObject = JsonifiableOb
     this.logger__.logMethodArgs?.('new', {id: this.id});
   }
 
+  /**
+   * get store schema version
+   *
+   * @returns store schema version
+   */
+  get schemaVer(): number {
+    return this.context__.meta.schemaVer;
+  }
+
+  /**
+   * set store schema version for migrate
+   */
+  set schemaVer(ver: number) {
+    this.context__.meta.schemaVer = ver;
+  }
+
   /**
    * Checks if an item exists in the collection.
    *
diff --git a/packages/reference/src/document-reference.ts b/packages/reference/src/document-reference.ts
index 24c6a0cc..68b12a03 100644
--- a/packages/reference/src/document-reference.ts
+++ b/packages/reference/src/document-reference.ts
@@ -22,7 +22,7 @@ export class DocumentReference<TDoc extends JsonifiableObject = JsonifiableObjec
   /**
    * Alwatr store engine file format version number.
    */
-  static readonly fileFormatVersion = 1;
+  static readonly fileFormatVersion = 2;
 
   /**
    * Creates new DocumentReference instance from stat and initial data.
@@ -53,6 +53,7 @@ export class DocumentReference<TDoc extends JsonifiableObject = JsonifiableObjec
         extension: StoreFileExtension.Json,
         ver: DocumentReference.version,
         fv: DocumentReference.fileFormatVersion,
+        schemaVer: 1
       },
       data: initialData,
     };
@@ -128,6 +129,14 @@ export class DocumentReference<TDoc extends JsonifiableObject = JsonifiableObjec
       logger.accident('doc.migrateContext__', 'store_version_incompatible', context.meta);
       throw new Error('store_version_incompatible', {cause: context.meta});
     }
+
+    if (context.meta.fv === 1) {
+      // migrate from v1 to v2
+      context.meta.schemaVer = 0;
+      context.meta.fv = 2;
+    }
+
+    context.meta.ver = DocumentReference.version;
   }
 
   /**
@@ -174,6 +183,22 @@ export class DocumentReference<TDoc extends JsonifiableObject = JsonifiableObjec
     this.logger__.logMethodArgs?.('new', {path: this.path});
   }
 
+  /**
+   * get store schema version
+   *
+   * @returns store schema version
+   */
+  get schemaVer(): number {
+    return this.context__.meta.schemaVer;
+  }
+
+  /**
+   * set store schema version for migrate
+   */
+  set schemaVer(ver: number) {
+    this.context__.meta.schemaVer = ver;
+  }
+
   /**
    * Retrieves the document's data.
    *
diff --git a/packages/types/src/main.ts b/packages/types/src/main.ts
index cbd009e2..d0bb86fe 100644
--- a/packages/types/src/main.ts
+++ b/packages/types/src/main.ts
@@ -139,6 +139,12 @@ export type StoreFileMeta = StoreFileStat & {
    */
   ver: string;
 
+  /**
+   * The schema version for easy migration by user.
+   * default is `0` for old migrate data an `1` for new define storage.
+   */
+  schemaVer: number;
+
   /**
    * Store file format version.
    */