# Deprecating VM0042 v1.0 and Migrating to VM0042 v2.1 Using Migration Wizard

## Overview

The Guardian platform allows any registry or standards body to create, manage, and update digital methodologies (policies) for environmental and sustainability programs.

When a policy is updated, it is important to deprecate the old version so no new projects start on it, and migrate existing projects to the updated version while keeping all history intact. This ensures consistency across active projects and compliance with the latest requirements.

This guide explains how to do that using the Guardian Migration Wizard.

## Background Example

An environmental carbon credit standard body is using the VM0042 methodology for *Improved Agricultural Land Management*.\
The current Guardian policy is based on VM0042 v1.0, which has been in use since 2023.

In July 2025, Verra released VM0042 v2.1, which introduces:

* Updated emission factor calculation formulas
* New soil organic carbon (SOC) sampling schema
* Mandatory geospatial boundaries in GeoJSON format
* Additional MRV (Monitoring, Reporting, and Verification) metadata fields

To comply with updated standards, the standard body must:

1. Deprecate VM0042 v1.0 so no new projects start on it.
2. Migrate existing project data to VM0042 v2.1 using Guardian’s Migration Wizard.

### Why Migration Is Needed

* Regulatory compliance — Old methodology no longer meets Verra’s validation requirements.
* Data consistency — All ongoing projects must follow the same updated schema for comparability.
* Avoid double counting — Ensures migrated projects retain unique identifiers and traceable history.

### Part 1: Deprecate VM0042 1.0 Policy

#### Step 1: Open Guardian Admin Panel

Navigate to the **"Policies"** section in the Guardian dashboard.

<figure><img src="https://501642358-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbKnJV8vV7zUxRwKIsJKg%2Fuploads%2Fgit-blob-c43e9d2c17080146e8c0169807c75b202f00f931%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

#### Step 2: Select and Deprecate the Policy

* Click the **"Discontinue"** button.

<figure><img src="https://501642358-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbKnJV8vV7zUxRwKIsJKg%2Fuploads%2Fgit-blob-19d9a3301006010c0cf11988f85102020297e8a5%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

* Select the timeframe, when we want to discontinue the policy. For now, we will be selecting immediate in the pop up:

<figure><img src="https://501642358-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbKnJV8vV7zUxRwKIsJKg%2Fuploads%2Fgit-blob-921adb171bf4687223ba224e1cb7059b0b937512%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

* The policy will now be marked as **Discontinued**, and users will no longer be able to issue new credentials.

<figure><img src="https://501642358-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbKnJV8vV7zUxRwKIsJKg%2Fuploads%2Fgit-blob-d214c8a5d2d44458b580f5d0900163961cc82a28%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

### Part 2: Prepare VM0042 v2.1 Policy

#### Step 3: Create/Import VM0042 V2.1 Policy:

<figure><img src="https://501642358-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbKnJV8vV7zUxRwKIsJKg%2Fuploads%2Fgit-blob-45006a175c7c902ca917f5e7d9d0d03d4e0e4e48%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Publishing VM0042 V2.1 Policy:

<figure><img src="https://501642358-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbKnJV8vV7zUxRwKIsJKg%2Fuploads%2Fgit-blob-05f56576d597ed34affddce646466399c6d1aa5c%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

### Part 3: Migrate Data Using Migration Wizard

#### Step 4: Launch Migration Wizard

* Click on **Migrate data** for Discontinued Policy: VM0042 1.0:

<figure><img src="https://501642358-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbKnJV8vV7zUxRwKIsJKg%2Fuploads%2Fgit-blob-0bbc068fdc9b2cdca81e9003f6f2228642cffd1a%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

#### Step 5: Select Source and Target Policies

* **Source Policy**: Select VM0042 1.0
* **Target Policy**: Select VM0042 V2.1

<figure><img src="https://501642358-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbKnJV8vV7zUxRwKIsJKg%2Fuploads%2Fgit-blob-a7447b22717e6f326fc5cbb6dd3e35f644a339a3%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

#### Step 6: Map Credentials

* This step of the wizard is where you select the project records to migrate from one policy version to another.

Each VC and VP have an associated entity or individual which attested to the document validity by creating a cryptographic signature. This entity is referred to as 'owner' of the document, and is identified by Decentralized Identifier (DID).

* VP Documents are Verifiable Presentations — collections of project information packaged together for sharing and verification.
* VC Documents are Verifiable Credentials — individual digital records that contain the certified data for a project, such as monitoring reports, emission reductions, or validation results.
* DID is a globally unique identifier that can be resolved to a DID Document containing public cryptographic keys, service endpoints, and other metadata. Only the entity with the private keys matching public keys in the DID can prove ownership of the issued VCs and VPs. More information on DIDs and its relationship with VCs and VPs can be found here: <https://www.w3.org/groups/wg/did/>.

More information on VCs and VPs concepts can be found here: <https://www.w3.org/TR/vc-overview>.

<figure><img src="https://501642358-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbKnJV8vV7zUxRwKIsJKg%2Fuploads%2Fgit-blob-7e50742df334a429ece7a26052f47d8b8f3aa9a7%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://501642358-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbKnJV8vV7zUxRwKIsJKg%2Fuploads%2Fgit-blob-0ecb8340f7ae163018056d8c21b465a25be88824%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

* Once selection is completed, click **"Next"**.

#### Step 7: Map Fields to New Schema

The wizard will guide you to map old fields to the new schema structure.

<figure><img src="https://501642358-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbKnJV8vV7zUxRwKIsJKg%2Fuploads%2Fgit-blob-1d610e2fbbce7d937b46969f530382aeef6bd752%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://501642358-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbKnJV8vV7zUxRwKIsJKg%2Fuploads%2Fgit-blob-a9e203b312cc3137a898fcd8aa672648352749bb%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

#### Step 8: Map the Roles

* Map the roles:

<figure><img src="https://501642358-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbKnJV8vV7zUxRwKIsJKg%2Fuploads%2Fgit-blob-78aa3bade247f125f5701f72c68c5591cfb0f26d%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

#### Step 9: Map the Groups/Tokens (Optional)

#### Step 10: Start the Migration Process

* Click on "Next" and start the migration data process:

<figure><img src="https://501642358-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbKnJV8vV7zUxRwKIsJKg%2Fuploads%2Fgit-blob-55fc213fe1be3a82b25fe847d2167ac076624161%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

#### Step 11: Verify the VM0042 V2.1 Policy

* Open the VM0042 V2.1 Policy and click on "**TrustChain**".
* View the TrustChain to confirm:
  * All records migrated correctly
  * Original credential IDs are preserved
  * Linked documents, token metadata, and approvals are intact

<figure><img src="https://501642358-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbKnJV8vV7zUxRwKIsJKg%2Fuploads%2Fgit-blob-3bdf1f1e8df0551fefba30a43fc0d8cc34947f39%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://501642358-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbKnJV8vV7zUxRwKIsJKg%2Fuploads%2Fgit-blob-7d894fbf6ba67608fbab00cbced3b2cb9c981ce4%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>
