stubkit docs

Feature · Apple-only · Automatic

Apple Family Sharing

Apple lets a purchaser share an auto-renewable subscription with up to six family members. When a family member's device pings Apple for entitlement, Apple sends stubkit a webhook with inAppOwnershipType: "FAMILY_SHARED". Stubkit now parses this field and marks the resulting subscription row with is_family_shared = 1.

What you see

  • The user gets full entitlement access — same isActive() result as the paying member.
  • Dashboard user detail → subscriptions row shows a family badge next to the status.
  • Analytics (MRR, LTV) automatically exclude family-shared rows from revenue aggregates since they didn't pay — we only count the original purchase.

What changed under the hood

type SubscriptionRow = {
  // ... existing fields
  is_family_shared: number;  // 0 or 1
};

Google Play's equivalent ("Subscription Sharing") is handled separately — a family member is a completely different user on Google's side. Stripe has no family sharing concept.

Nothing to configure

Automatic for every Apple webhook. No tenant setup. If you're migrating from a system that blocked family entitlements, note that stubkit intentionally grants the entitlement — Apple's customer-facing terms guarantee family access when the purchaser opted in.