DOCS

Migration guides

This section covers the migration scenarios you may encounter when installing or upgrading Fundations.

Scenarios

1. Upgrading to Fundations 2.8.0

Version 2.8.0 includes a breaking change: donation form blocks without a Form Template assigned no longer display on the frontend. This affects every site upgrading from any version before 2.8.0 unless the donation form block was already using a template (only possible if you were on a Pro version with the form builder).

Steps are short. See Form Template assignment.

2. Internal donation data migration (postmeta to custom table)

Fundations stores donations in a dedicated custom database table. Sites that were created before this table existed (roughly before version 1.5.0) may have legacy donation data stored as a WordPress post type (get_fund_donation). The internal migration tool converts that data to the custom table.

This migration runs once per site and is a prerequisite for accurate stats and the Entries admin page. See Internal donation data migration.

3. Migrating from another crowdfunding platform

If you are moving an existing crowdfunding operation from GoFundMe, GiveWP, WP Charitable, or another non-WordPress platform, the platform migration guide covers data mapping, import steps, and what to verify after import.

See Platform migration.

Which migration do I need?

SituationMigration needed
Upgrading from any version before 2.8.0Form Template assignment
Site was created before ~1.5.0 or stats look wrongInternal donation data migration
Moving from GoFundMe / GiveWP / WP CharitablePlatform migration
Fresh installNone