Swedish family benefits, 2026
Ready benefit choices
In the portal's model editor, the immutable modules['swedish-family-benefits'].sym.benefitKinds('en') choice list supplies the choices Child benefit, Study benefit and None:
const benefitKind = input.enum('study', {
options: modules['swedish-family-benefits'].sym.benefitKinds('en'),
});Omit the language or pass 'en' for English labels. Values remain the same in both languages, so calculations and saved selections keep their meaning. Supported languages are 'en' and 'sv'.
Simple parent and household-share choices
Use modules['swedish-family-benefits'].swedishFamilyBenefits with profile:'household' for continuing benefits in a household with one or two adult recipients. Each child declares a stable id, a parent ID or "shared", benefitKind ("child", "study" or "none"), and householdShare ("full" or "half"). These fields are required; the profile does not infer eligibility from age. For example, in the portal's model editor:
const benefits = modules['swedish-family-benefits'].swedishFamilyBenefits({
owner:family, recipients:{anna,erik}, profile:'household',
children:[{id:'kim',parent:'shared',benefitKind:'child',householdShare:'half'}],
});
// Add benefits.component to the model; use a monthly timeline and SEK currency.A full child benefit pays SEK 1,250 into this household each month. Half pays SEK 625 into this household and reports the other SEK 625 as external. The household portion goes to the selected parent; Shared divides it equally between the two adults, so the example pays SEK 312.50 each. With one adult, Shared pays that adult the whole household portion. External amounts create no household payment.
All children belong to one implicit supplement group. Child and study benefits count toward the supplement; None is inactive. Study grants pause in July and August, and the supplement retains its October catch-up and cent rounding. This profile represents continuing assumptions; use the explicit-share contract below for separate groups, eligibility switches, or first/last/transition months.
children can be typed object-array input, a row projection, or fixed source records. recipients can be a keyed entity map or repeated person outputs. An optional fields map renames only id, parent, benefitKind and householdShare; omitted mappings use those names. Exactly one or two recipients are required even when the child list is empty; empty children produce zero. Unknown parents are rejected even for None, as are invalid kinds/shares, duplicate IDs, a recipient named "shared", unsupported fields and changing source values. Return values and the monthly SEK/calendar requirements are the same as in the explicit-share contract.
Configure explicit shares and eligibility
Use swedish-family-benefits to add child benefit, study benefit and multi-child supplement to a model with a monthly timeline and SEK currency. The rule version is 2026.1.0; SWEDISH_FAMILY_BENEFITS_RULE_YEAR is 2026. Selecting the module adds no inputs, pages, people or payments automatically.
Omit profile to keep the existing explicit-share contract unchanged. swedishFamilyBenefits({ owner, children, recipients, fields? }) returns .component and .outputs. Add .component to the model's components. owner identifies the calculation's owner; payments go to the explicitly selected recipients. children accepts an editable input.objectArray() or an array of source records. recipients accepts a keyed entity map such as { anna, erik }, or repeated person outputs such as people.outputs.person.
const { swedishFamilyBenefits } = modules['swedish-family-benefits'];
const children = input.objectArray([{
id: input.id('child-one'),
benefitKind: input.enum('child', { options: [
{ value: 'child', label: 'Barnbidrag' },
{ value: 'study', label: 'Studiebidrag' },
{ value: 'none', label: 'Inget bidrag' },
] }),
eligibleForSupplement: input.integer(1),
familyGroupId: input.str('family-one'),
recipientShares: input.objectArray([
{ id: input.id('anna'), share: input.decimal(0.5) },
{ id: input.id('erik'), share: input.decimal(0.5) },
]),
externalShare: input.decimal(0),
}]);
const benefits = swedishFamilyBenefits({
owner: family, children, recipients: { anna, erik },
});The example pays SEK 625 per month to each person. An empty child list yields zero. Changing child or recipient lists between scenarios rebuilds the matching payments.
Each child needs one stable id, benefitKind (child, study or none), an explicit eligibleForSupplement switch, a familyGroupId, and recipientShares records containing recipient id and share. Plain records use a boolean eligibility value; editable input switches use 1 for yes and 0 for no. Recipient shares plus optional externalShare must sum to one. An explicit zero is valid. Unknown recipients, duplicate child or recipient IDs, invalid fractions and incomplete shares are rejected. A recipient entity may appear only once in the recipient map. An outside-household share is reported separately and creates no household posting.
Put children in the same family group only when your eligibility assumptions allow them to be counted together. Separate groups receive separate supplement calculations. The model does not infer entitlement, group membership or payment recipients from age, marriage, cohabitation, schooling or custody. A study payment can explicitly go to the student. Existing member records can use different field names, for example fields: { benefitKind: 'benefit', eligibleForSupplement: 'supplementEligible' }; other canonical field names can be mapped the same way.
Amounts and payment calendar
Child benefit is SEK 1,250 per child each month. Study benefit is SEK 1,250 in September–June and zero in July/August. These amounts follow the Försäkringskassan 2026 amounts and CSN payment guidance.
| Eligible children in a family group | Monthly full supplement, SEK |
|---|---|
| 0 or 1 | 0 |
| 2 | 150 |
| 3 | 730 |
| 4 | 1,740 |
| 5 | 2,990 |
| 6 | 4,240 |
| Each child beyond 6 | +1,250 |
The supplement is divided in proportion to each recipient's full or split benefit shares across eligible children, including the outside-household share. This follows Försäkringskassan's proportional allocation guidance. The planning estimate conserves the exact total to the öre (SEK 0.01). Residual öre are assigned by the largest-fractional-remainder method; ties follow recipient-map order, with the external share last. Actual Försäkringskassan payments rounded to whole kronor can differ.
During July–September, supplement cash uses only eligible child-benefit children. October pays the current full supplement plus the withheld difference for July, August and September, using each month's explicit eligibility. A continuing family with two child-benefit children and one study-benefit child receives SEK 150 supplement in each of July–September and SEK 2,470 in October. Its annual supplement is SEK 8,760. See Försäkringskassan's study and summer supplement guidance.
Explicit first, last and transition months
Optional fromPeriod and throughPeriod are inclusive model-period indices. Negative indices describe eligibility before the model starts. Omitted bounds mean continuing entitlement before and after the model start. Therefore a model starting in October includes prior July–September accrual by default. Set fromPeriod: 0 when eligibility starts with the model; that suppresses earlier accrual. Set throughPeriod to the chosen final eligible month, including the correct final study year.
A single child can change benefit type without acquiring a second ID. Optional benefitSchedule entries contain fromPeriod, throughPeriod, benefitKind and eligibleForSupplement; entries must have integer, nonoverlapping inclusive ranges. Inside a scheduled range, its kind and eligibility override the child's base values. Outside scheduled ranges, the base values apply. The child's outer eligibility bounds still apply.
const transition = {
id: 'older-child', benefitKind: 'none', eligibleForSupplement: false,
familyGroupId: 'family-one', recipientShares: [{ id: 'anna', share: 1 }],
benefitSchedule: [
{ fromPeriod: 0, throughPeriod: 5,
benefitKind: 'child', eligibleForSupplement: true },
{ fromPeriod: 6, throughPeriod: 11,
benefitKind: 'study', eligibleForSupplement: true },
],
};In a January-start model, this explicitly switches from child to study entitlement in July; study cash still waits until September. Birthdays never generate these transitions. First-payment delays outside the continuing-study calendar must be represented by the selected eligibility periods and schedule. Recipient shares and family group assignments stay fixed within a projection; use scenario replacements to compare different assignments. Profile inputs must be fixed sources. Changing calculations, curves, account balances and callbacks are rejected so that historical October allocation cannot silently use a later assignment.
Results and reusable formulas
.outputs.child, .study, .supplement and .total are monthly household Money projections. .outputs.breakdown is the published record for tables and breakdown widgets. It contains ruleYear, period, month, keyed recipients and groups, and household, external and entitlement totals. Every amount row contains child, study, supplement and total. Group and entitlement amounts include external shares; household amounts include only modeled recipients. Each modeled recipient's total is paid once into their personal bank account and credited to income.tax_free.
For example, benefits.outputs.breakdown.project(['recipients', 'anna', 'supplement']) selects Anna's actual supplement cash. A recipient-specific projection requires that recipient to exist in the selected scenario; use the published recipient map when list lengths change.
The registered source formulas swedishFamilyBenefit2026.child({ count }), .study({ count }) and .supplement({ count }) return krona numbers. Child and study count default to one; zero is retained. Counts must be nonnegative integers, and Money counts are rejected. These formulas expose dependency metadata; when placing one in a calculation, declare its dependsOn and readsAccountsFrom metadata. They support ordinary source composition and repeated row inputs. The supplement formula gives the full monthly tier; the component supplies family allocation and summer cash timing.
The pure calculateChildBenefit2026(count), calculateStudyBenefit2026(count, month), calculateMultiChildSupplement2026(count) and calculateSwedishFamilyBenefits2026({ children, recipientIds, period, month }) use the same named rule set. Pure results contain krona numbers; published component records contain Money values. This version does not forecast future statutory changes or calculate means-tested benefits.