Field guide · Mantle migration

Reconcile the numbers before you replace the dashboard.

A migration is only trustworthy when both tools answer the same question. Use this checklist while Mantle and the replacement view are available side by side.

Before connecting

Choose one representative app, one reporting currency and one owner for the comparison. Record the date, the old report name and any existing exclusions before changing anything.

  1. 01Choose one app with active paid merchants
  2. 02Pick one reporting currency
  3. 03Record the exact start and end dates
  4. 04Export or capture the current Mantle totals
  5. 05List manually excluded or test merchants

Align the definition

Two reports can be internally correct and still disagree because they define the metric differently. Write the definition down before investigating variance.

  1. 01Confirm annual plans are normalized to a monthly value
  2. 02Exclude trials and one-time charges from basic MRR
  3. 03Decide how frozen shops appear
  4. 04Keep currencies separate rather than converting silently
  5. 05Match the treatment of refunds, credits and exclusions

Compare the bridge

Do not compare only the closing total. Reconcile the components that moved the number: opening MRR, new, expansion, contraction, churn, frozen, reactivation and closing MRR.

  1. 01Match opening MRR first
  2. 02Compare each positive movement category
  3. 03Compare each negative movement category
  4. 04Sort merchant variances by absolute value
  5. 05Trace the largest differences to lifecycle events and transactions

Sign off

Keep a short variance log with the source record, explanation and decision. A small explained difference is more useful than a perfectly matching total produced by hidden adjustments.

  1. 01Document every unresolved variance
  2. 02Confirm transaction and payout coverage dates
  3. 03Repeat with a second app or currency
  4. 04Save the final definition and exclusions
  5. 05Schedule a post-cutoff spot check

Use the method on your own data

Marlo keeps definitions beside the relevant report and detail views.

Start 7-day trial