Migration Overview
This guide provides a high-level overview of the paradigm shifts between Lens v2 and Lens v3.
Data Migration
Most of the Lens v2 data was migrated from Polygon to Lens v3 on the Lens Chain Mainnet. The migrated data included:
Profiles were migrated into Accounts
Signless configuration
Profile Managers were migrated into Account Managers
Handles were migrated into Usernames
App IDs defined in metadata were migrated as onchain App Primitives
Follow relationships into the Lens Global Graph
- Publications:
All root posts were migrated.
Comments were migrated up to 4 levels deep — comments on a comment on a comment on a comment were included.
Only quotes of root posts were migrated; quotes of comments were excluded.
As of April 3, 2025, migration data from Lens v2 to Lens v3 has been synchronized up to Polygon block 69,837,653.
Exiting Concepts
Profile → Account – In Lens v2, Profiles were stored as state within a single smart contract. In Lens v3, each Account is its own smart contract.
Profile Manager → Account Manager – In v3, management is built directly into the Account contract itself.
Handle → Username – Handles are now called usernames. Users can have multiple usernames across different namespaces.
Follow Modules → Follow Rules – Follow modules are now referred to as follow rules.
Reference Modules → Post Rules – Similarly, reference modules are now called post rules.
App ID → Onchain App Primitives – In v3, apps are fully onchain, unlocking powerful new capabilities.
Gasless → Sponsorships – Apps now create sponsorships for their users and decide who receives them.
Lens V3 automatically migrated accounts and usernames for users. If a Safe was used, it was deployed on the user's behalf. However, if the account or username was owned by contract on Polygon, it could not be transferred automatically. If this applies to you, please contact us — we can help transfer ownership once verification is complete.
New Concepts
You can explore the full documentation to learn about the new concepts introduced in Lens v3. We recommend starting with the Overview.
Deprecated Concepts
Profile Guardian – In v3, Accounts have owners in a more standard smart wallet pattern.
Handle Guardian – There is no equivalent concept in v3.