Program owner
Defines who qualifies
A program or community team can say “donate at least $50” or “complete three donations this month.”
Guide · Entitlements
Phase twoAn entitlement is Our Impact’s evaluated answer about one supporter. Your application chooses what that answer unlocks.
Program owner
A program or community team can say “donate at least $50” or “complete three donations this month.”
Software team
Code reacts to community_champion_theme without duplicating qualification logic.
{
"entitlement_key": "community_champion_theme",
"state": "active",
"qualifying_count": 1,
"progress_value": 1,
"progress_unit": "events",
"qualified_at": "2026-11-06T12:00:01Z",
"valid_until": null,
"updated_at": "2026-11-06T12:00:01Z"
}statequalifying_countprogress_valueprogress_unitevents, or a lowercase ISO currency code. For example, 5000 plus usd means $50.00.qualified_atvalid_untilThe preview browser package caches one entitlement request and checks expiry when you call user.is().
import { OurImpact } from "@our-impact/browser";
const impact = new OurImpact({
publishableKey: "oi_pk_test_...",
userToken,
});
const hasTheme = await impact.user.is("community_champion_theme");
const allAccess = await impact.user.all();
if (hasTheme) {
document.documentElement.dataset.theme = "community-champion";
}user.is(key)Client feature togglesuser.get(key)Client progress UIuser.all()Client dashboardsuser.profile()Client identity displaylistUserEntitlements()Server authorizationA browser entitlement is excellent for presentation, but it must not be the only check protecting paid data, private routes, or privileged mutations.
import { OurImpactClient } from "@our-impact/node";
const ourImpact = new OurImpactClient({
secretApiKey: process.env.OUR_IMPACT_SECRET_KEY,
});
const state = await ourImpact.entitlements.listUserEntitlements({
externalUserId: "storefront:user_01JABC",
});
const hasServerAccess = state.entitlements.some(
(item) =>
item.entitlementKey === "community_champion_theme" &&
item.state === "active" &&
(!item.validUntil || item.validUntil > new Date()),
);community_champion_theme, supporter_badge, or tier_3.donated_50_dollars; thresholds will change.