Registry entry
Australia Individual Tax Return (myTax, 2026 income year)
Prepare and lodge an individual's Australian income tax return online using myTax, the Australian Taxation Office's myGov-linked online lodgment service, for the 2026 income year (1 July 2025 to 30 June 2026). myTax pre-fills most return data from employers, banks, government agencies, health funds and other third parties by late July each year; the individual reviews the pre-filled figures, amends or completes any that are missing or wrong, and lodges. This document models the field set of the ATO's paper equivalent, the 'Tax return for individuals' (NAT 2541), which myTax's online screens mirror: personal and contact details, electronic funds transfer details, income items 1-12 (salary and wages, allowances, employer lump sums, employment termination payments, government allowances and pensions, annuities and superannuation income streams, superannuation lump sums, attributed personal services income, interest, dividends, and employee share schemes), deductions D1-D10 and prior-year losses, tax offsets T1-T2, Medicare levy questions M1-M2 and private health insurance policy details, adjustments A1-A4, income tests IT1-IT8, spouse details for taxpayers with a spouse (married or de facto) during the year, and the taxpayer's declaration. Out of scope: the separate 'Tax return for individuals (supplementary section) 2026' (business income and expenses, capital gains, foreign income and assets, partnership and trust distributions, rental schedules, and other less-common income/deductions), gated by this document's requiresSupplementarySection field but not itself modelled here; multiple concurrent employers (the source form's five repeating salary/wage payer rows) and multiple concurrent private health insurance policies (the source form's four repeating policy rows), both of which are repeating third-party structures the current flat field model (GSP-0009) cannot express; and the transfer of a refund to a different taxpayer's income tax account or student loan. It does not submit the return or calculate tax payable; the live ATO myTax service and the live NAT 2541 source are always authoritative (see VERIFICATION.md).
You are viewing v1.0.0
The latest published version of this schema is v1.1.0 — see the current reference page. Published versions are immutable; this page stays for agents pinned to au/ato/individual-tax-return-mytax@1.0.0.
Registry entry
au/ato/individual-tax-return-mytax
GovSchema spec v0.3
Authoritative source ATO 'Lodge your tax return online with myTax' guidance page, plus the official 'Tax return for individuals 2026' (NAT 2541-06.2026) paper form whose field set myTax's online screens mirror
Machine access
- Schema document
registry/au/ato/individual-tax-return-mytax/1.0.0/schema.jsonapplication/schema+json- Verification record
registry/au/ato/individual-tax-return-mytax/1.0.0/VERIFICATION.mdtext/markdown- Registry catalog
registry/index.jsonone record per schema id
Field reference
148 fields across 10 steps, read from the published schema.json — names, types, requiredness, and validation as the document states them. The live government form remains the authoritative source.
Access to myTax
-
hasMyGovAccountLinkedToAtoboolean requiredYou need a myGov account with an active link to the ATO to access online services and lodge with myTax. Sign in to myGov, select ATO from your linked services, then select 'Manage tax returns'.
Individual information (page 1-2)
-
taxFileNumberstring requiredYour tax file number. Handle as sensitive personal data.
patternclassification: sensitive-pii -
isAustralianResidentboolean requiredWhether you were an Australian resident for tax purposes.
-
titleenum optionalYour title, if shown.
enum: mr | mrs | miss | ms | other -
familyNamestring requiredYour family name.
length: 1–100classification: pii -
firstGivenNamestring requiredYour first given name.
length: 1–100classification: pii -
otherGivenNamesstring optionalAny other given names.
length: 0–100classification: pii -
nameChangedSinceLastReturnboolean optionalHas any part of your name changed since completing your last tax return?
-
postalAddressLinestring requiredPrint the address where you want your mail sent.
length: 1–200classification: pii -
postalSuburbOrTownstring requiredSuburb/town/locality (postal)
length: 1–100classification: pii -
postalStateenum requiredAustralian state or territory of the postal address.
enum: 8 values -
postalPostcodestring requiredPostcode (postal)
patternclassification: pii -
postalCountryIfNotAustraliastring optionalCountry if not Australia (postal)
length: 0–100 -
postalAddressChangedSinceLastReturnboolean optionalHas this address changed since completing your last tax return?
-
homeAddressDifferentFromPostalboolean optionalIf yes, print your home address below.
-
homeSuburbOrTownstring optionalOnly the suburb/town/locality, state/territory, postcode and country labels are printed for the home address block on the source form; no separate street-line box was captured — see VERIFICATION.md.
length: 0–100classification: pii -
homeStateenum optionalState/territory (home)
enum: 8 values -
homePostcodestring optionalPostcode (home)
patternclassification: pii -
homeCountryIfNotAustraliastring optionalCountry if not Australia (home)
length: 0–100 -
daytimePhoneNumberstring optionalYour daytime phone number
length: 0–30classification: pii -
mobilePhoneNumberstring optionalYour mobile phone number
length: 0–30classification: pii -
emailAddressstring optionalYour email address
length: 0–200classification: pii -
willLodgeFutureReturnenum optional'no_final_return' means this is your final tax return.
enum: yes | dont_know | no_final_return -
dateOfBirthdate optionalRequired if you were under 18 years old on 30 June 2026 (see question A1) to avoid delays in processing.
-
bsbNumberstring required6-digit BSB number of the account for any refund.
patternclassification: financial -
bankAccountNumberstring requiredAccount number
length: 0–10classification: financial -
bankAccountNamestring requiredFor example, JQ Citizen. Don't show the account type, such as cheque, savings, mortgage offset.
length: 0–100classification: financial
Income (items 1-12, page 2-3)
-
salaryOrWagesOccupationstring optionalYour main salary and wage occupation
length: 0–100 -
salaryOrWagesPayerAbnstring optionalModelled as a single payer/employer line; the source form provides five repeating employer rows (TYPE codes) not expressible in GovSchema's flat, non-repeating field model — see VERIFICATION.md.
pattern -
salaryOrWagesTaxWithheldnumber optionalSalary or wages — tax withheld
-
salaryOrWagesIncomenumber optionalSalary or wages — income
-
allowancesEarningsTipsDirectorsFeesnumber optionalAllowances, earnings, tips, director's fees etc
-
employerLumpSumPaymentAmountAnumber optionalEmployer lump sum payments — Amount A
-
employerLumpSumPaymentAmountBnumber optionalEmployer lump sum payments — 5% of Amount B
-
etpPaymentDatedate optionalEmployment termination payment (ETP) — date of payment
-
etpPayerAbnstring optionalEmployment termination payment (ETP) — payer's ABN
pattern -
etpTaxableComponentnumber optionalEmployment termination payment (ETP) — taxable component
-
etpCodestring optionalThe ETP type code printed by the payer on your ETP payment summary.
length: 0–2 -
governmentAllowancesAndPaymentsnumber optionalAustralian Government allowances and payments (e.g. Youth Allowance, JobSeeker, Austudy)
-
governmentPensionsAndAllowancesnumber optionalIf you complete this item you must also complete the Seniors and pensioners tax offset (T1) question.
-
annuitySuperIncomeStreamTaxedElementnumber optionalAustralian annuities and superannuation income streams — taxable component, taxed element
-
annuitySuperIncomeStreamUntaxedElementnumber optionalAustralian annuities and superannuation income streams — taxable component, untaxed element
-
annuitySuperIncomeStreamCappedDefinedBenefitnumber optionalAssessable amount from capped defined benefit income stream
-
annuitySuperIncomeStreamLumpSumArrearsTaxednumber optionalLump sum in arrears — taxable component, taxed element
-
annuitySuperIncomeStreamLumpSumArrearsUntaxednumber optionalLump sum in arrears — taxable component, untaxed element
-
superLumpSumPaymentDatedate optionalAustralian superannuation lump sum payments — date of payment
-
superLumpSumPayerAbnstring optionalAustralian superannuation lump sum payments — payer's ABN
pattern -
superLumpSumTaxableComponentTaxednumber optionalAustralian superannuation lump sum payments — taxable component, taxed element
-
superLumpSumTaxableComponentUntaxednumber optionalThe source form places a third dollar box immediately above item 9 whose exact association with item 8 versus a running tax-withheld subtotal could not be confirmed with certainty from the extracted text layer alone — see VERIFICATION.md.
-
attributedPersonalServicesIncomenumber optionalAttributed personal services income
-
grossInterestnumber optionalIf you're a foreign resident, make sure you print your country of residence on page 1.
-
interestTfnAmountsWithheldnumber optionalTFN amounts withheld from gross interest
-
dividendsUnfrankedAmountnumber optionalIf you're a foreign resident, make sure you print your country of residence on page 1.
-
dividendsFrankedAmountnumber optionalDividends — franked amount
-
dividendsFrankingCreditnumber optionalDividends — franking credit
-
dividendsTfnAmountsWithheldnumber optionalTFN amounts withheld from dividends
-
employeeShareSchemeDiscountEligibleForReductionnumber optionalEmployee share schemes — discount from taxed upfront schemes, eligible for reduction
-
employeeShareSchemeDiscountNotEligibleForReductionnumber optionalEmployee share schemes — discount from taxed upfront schemes, not eligible for reduction
-
employeeShareSchemeDiscountFromDeferralSchemesnumber optionalEmployee share schemes — discount from deferral schemes
-
employeeShareSchemeTotalAssessableDiscountnumber optionalEmployee share schemes — total assessable discount amount
-
employeeShareSchemeTfnAmountsWithheldnumber optionalTFN amounts withheld from employee share scheme discounts
-
employeeShareSchemeForeignSourceDiscountsnumber optionalEmployee share schemes — foreign source discounts
-
totalSupplementIncomeOrLossnumber optionalTranscribed here only if you completed the separate 'Tax return for individuals (supplementary section) 2026', which is out of scope for this document — see VERIFICATION.md.
-
totalTaxWithheldnumber optionalSum of every 'Tax withheld' box on items 1-8 above.
-
totalIncomeOrLossnumber optionalSum of the income amounts on items 1-12 (and the supplement, if any) less any loss amount.
Deductions and losses (D1-D10, L1, page 4)
-
workRelatedCarExpensesnumber optionalD1 Work-related car expenses
-
workRelatedTravelExpensesnumber optionalD2 Work-related travel expenses
-
workRelatedClothingLaundryDryCleaningnumber optionalD3 Work-related clothing, laundry and dry cleaning expenses
-
workRelatedSelfEducationnumber optionalD4 Work-related self-education expenses
-
otherWorkRelatedExpensesnumber optionalD5 Other work-related expenses
-
lowValuePoolDeductionnumber optionalD6 Low value pool deduction
-
interestDeductionsnumber optionalD7 Interest deductions
-
dividendDeductionsnumber optionalD8 Dividend deductions
-
giftsOrDonationsnumber optionalD9 Gifts or donations
-
costOfManagingTaxAffairsnumber optionalA 'Litigation costs' label is printed directly above D10 on the source form; whether it names a component of this box or a separate unlabelled amount could not be confirmed with certainty — see VERIFICATION.md.
-
otherExpensesManagingTaxAffairsnumber optionalOther expenses incurred in managing your tax affairs
-
totalSupplementDeductionsnumber optionalTranscribed here only if you completed the separate supplementary section, out of scope for this document.
-
totalDeductionsnumber optionalSum of D1 to D10 (and the supplement, if any).
-
taxLossesOfEarlierIncomeYearsnumber optionalL1 Tax losses of earlier income years
-
primaryProductionLossesCarriedForwardnumber optionalPrimary production losses carried forward from earlier income years
-
primaryProductionLossesClaimedThisYearnumber optionalPrimary production losses claimed this income year
-
nonPrimaryProductionLossesCarriedForwardnumber optionalNon-primary production losses carried forward from earlier income years
-
nonPrimaryProductionLossesClaimedThisYearnumber optionalNon-primary production losses claimed this income year
-
taxableIncomeOrLossnumber optionalTotal income or loss less total deductions (and losses claimed).
Tax offsets (T1-T2, page 5)
-
seniorsPensionersTaxOffsetCodestring optionalATO-defined single-letter tax offset code; the ATO works out the offset amount itself.
length: 0–2 -
seniorsPensionersVeteranCodestring optionalATO-defined veteran code, only if it applies.
length: 0–2 -
superIncomeStreamTaxOffsetnumber optionalT2 Australian superannuation income stream tax offset
-
totalSupplementTaxOffsetsnumber optionalTranscribed here only if you completed the separate supplementary section, out of scope for this document.
-
totalTaxOffsetsnumber optionalSum of T2 and the supplement tax offsets, if any.
Adjustments (A1-A4, page 7)
-
under18Incomenumber optionalRequired if you were under 18 years old on 30 June 2026, or you may be taxed at a higher rate.
-
partYearTaxFreeThresholdMonthsinteger optionalA2 Part-year tax-free threshold — months eligible for threshold
range: 0–12 -
partYearTaxFreeThresholdDatedate optionalA2 Part-year tax-free threshold — date
-
governmentSuperContributionsCodestring optionalATO-defined code.
length: 0–2 -
incomeFromInvestmentPartnershipOtherSourcesnumber optionalPrinted directly below A3 without its own A-numbered question label in the source extraction; its exact question association could not be confirmed with certainty — see VERIFICATION.md.
-
otherIncomeFromEmploymentAndBusinessnumber optionalSee the sourcing caveat on incomeFromInvestmentPartnershipOtherSources above.
-
otherDeductionsFromBusinessIncomenumber optionalSee the sourcing caveat on incomeFromInvestmentPartnershipOtherSources above.
-
workingHolidayMakerNetIncomenumber optionalA4 Working holiday maker net income
-
workingHolidayMakerHomeCountrystring optionalA4 Working holiday maker — home country
length: 0–100
Income tests (IT1-IT8, page 8)
-
reportableFringeBenefitsExemptnumber optionalIf the amount is zero, write 0.
-
reportableFringeBenefitsNotExemptnumber optionalIT1 Total reportable fringe benefits amounts — employers not exempt from FBT under section 57A
-
reportableSuperContributionsnumber optionalIT2 Reportable employer superannuation contributions
-
taxFreeGovernmentPensionsnumber optionalIT3 Tax-free government pensions
-
targetForeignIncomenumber optionalIT4 Target foreign income
-
netFinancialInvestmentLossnumber optionalIT5 Net financial investment loss
-
netRentalPropertyLossnumber optionalIT6 Net rental property loss
-
childSupportPaidnumber optionalIT7 Child support you paid
-
numberOfDependentChildrenIt8integer optionalIT8 Number of dependent children
range: 0–∞
Spouse details - married or de facto (page 8-9)
-
spouseFamilyNamestring optionalComplete this section only if you had a spouse (married or de facto) during 2025-26. If you had more than one spouse during the year, print the name of your spouse on 30 June 2026 or your last spouse.
length: 0–100classification: pii -
spouseFirstGivenNamestring optionalYour spouse's first given name
length: 0–100classification: pii -
spouseOtherGivenNamesstring optionalYour spouse's other given names
length: 0–100classification: pii -
spouseDateOfBirthdate optionalYour spouse's date of birth
classification: pii -
spouseGenderenum optionalYour spouse's gender
enum: male | female | indeterminate -
hadSpouseForFullYearboolean optionalDid you have a spouse for the full year, 1 July 2025 to 30 June 2026?
-
spouseFromDatedate optionalOnly if you didn't have a spouse for the full year.
-
spouseToDatedate optionalOnly if you didn't have a spouse for the full year.
-
spouseDiedDuringYearboolean optionalDid your spouse die during the year?
-
spouseTaxableIncomenumber optionalExcluding any assessable first home super saver released amount.
-
spouseTrustIncomeSection98number optionalOnly the amount not already included in your spouse's taxable income.
-
spouseFamilyTrustDistributionTaxIncomenumber optionalOnly the amount your spouse would otherwise have had to show as assessable income.
-
spouseReportableFringeBenefitsExemptnumber optionalYour spouse's total reportable fringe benefits amounts — employers exempt from FBT under section 57A
-
spouseReportableFringeBenefitsNotExemptnumber optionalYour spouse's total reportable fringe benefits amounts — employers not exempt from FBT under section 57A
-
spouseGovernmentPensionsAndAllowancesnumber optionalExcludes exempt pension income.
-
spouseExemptPensionIncomenumber optionalDon't include any amount paid under the Military Rehabilitation and Compensation Act 2004.
-
spouseReportableSuperContributionsnumber optionalTotal of reportable employer superannuation contributions and deductible personal superannuation contributions.
-
spouseOtherSpecifiedExemptPaymentsnumber optionalOther specified exempt payments your spouse received
-
spouseTargetForeignIncomenumber optionalYour spouse's target foreign income
-
spouseNetInvestmentLossnumber optionalTotal of net financial investment loss and net rental property loss.
-
spouseChildSupportPaidnumber optionalChild support your spouse paid
-
consentToRepaySpouseFamilyAssistanceDebtboolean optionalDo you consent to use part or all of your 2026 tax refund to repay your spouse's Family Assistance debt?
-
spouseCustomerReferenceNumberstring optionalOnly if you consent to use your refund to repay your spouse's Family Assistance debt, and your spouse has given you authority to quote their CRN.
length: 0–12classification: sensitive-pii -
familyAssistanceConsentSignatureDatedate optionalDate you signed the Family Assistance consent
Taxpayer's declaration (page 10)
-
requiresSupplementarySectionboolean optionalThe supplementary section itself (additional business, capital gains, foreign income, rental, and partnership/trust schedules) is out of scope for this document — see VERIFICATION.md.
-
furtherInformationAttachedboolean optionalHave the instructions asked you to attach further information relating to specific questions?
-
declarationSignedboolean requiredYou must read the declaration and sign the return as being true and correct before lodging.
-
declarationDatedate requiredDate of signature
Verification record
This file is the source-review record for this document version, per the manual-source-review-v1 practice.
Current claim
status:draftverification.method:manual-source-review-v1verification.lastVerifiedAt:2026-07-02
The document was derived from the ATO's own guidance page describing myTax and the official paper equivalent form it mirrors. The full field-by-field comparison the practice requires against the live, authenticated myTax online screens (Procedure step 2) has not been completed, so this remains draft, not verified.
Sources examined
- Document
(id, version):au/ato/individual-tax-return-mytax/1.0.0 - Spec version: GovSchema
0.3.0 - Authority: Australian Taxation Office ("ATO").
- Primary source (flow/eligibility): https://www.ato.gov.au/individuals-and-families/your-tax-return/how-to-lodge-your-tax-return/lodge-your-tax-return-online-with-mytax ("Lodge your tax return online with myTax", last updated 24 April 2026 per the page itself). Direct fetch of this URL returned HTTP 403 from both a raw
curlrequest and theWebFetchtool in this sandbox — addato.gov.auto the same WAF/bot-protection-blocked domain list asnzta.govt.nz([[gov474-dmv-business-formation-vertical-and-xfa-extraction]]) andcanada.ca. Recovered via the Wayback Machine's CDX API (web.archive.org/cdx/search/cdx?...&output=text&fl=timestamp), which returned a capture at20260616083509— 16 days old at authoring time, not a stale fallback. The capture itself requiredcurl --compressed(the archived response is gzip-encoded; a plaincurlwithout that flag returns unreadable compressed bytes) — worth trying before assuming a Wayback fetch failed. - Secondary source (field-by-field detail): the official "Tax return for individuals 2026" (NAT 2541-06.2026), downloaded directly (HTTP 200, no access block) from
iorder.com.au(the ATO's own Publications Ordering Service, linked fromato.gov.au/forms-and-instructions/tax-return-for-individuals-2026/how-to-get-the-individual-tax-return-2026), 12 pages. This is a static (non-fillable) PDF —pdfjs-dist'sgetFieldObjects()returnsnulland there is no/AcroFormor/XFAmarker in the raw bytes — the same shape as NZTA's DL1 form ([[gov474-dmv-business-formation-vertical-and-xfa-extraction]]), so fields were reconstructed from the text layer's x/y position data (items sorted by y descending then x ascending; each numbered item/question's boxes and single-letter box codes read off their printed position) rather than AcroForm field names. - Retrieved / reviewed: 2026-07-02.
- Reviewer: GovSchema Engineering (Standards Engineer — initial authoring source review).
What was confirmed against the source
| Source element | Field(s) | |---|---| | "Access to myTax" (myGov account linked to the ATO) | hasMyGovAccountLinkedToAto | | Page 1-2: TFN, residency, name, postal/home address, contact details, EFT details | taxFileNumber through bankAccountName | | Page 2-3, items 1-12 (salary/wages through employee share schemes) and page 3 totals | salaryOrWagesOccupation through totalIncomeOrLoss | | Page 4, D1-D10 deductions, L1 losses, taxable income | workRelatedCarExpenses through taxableIncomeOrLoss | | Page 5, T1-T2 tax offsets and total | seniorsPensionersTaxOffsetCode through totalTaxOffsets | | Page 6-7, M1-M2 Medicare levy questions and private health insurance policy details | medicareLevyReductionOrExemptionClaimed through healthInsuranceTaxClaimCode | | Page 7, A1-A4 adjustments | under18Income through workingHolidayMakerHomeCountry | | Page 8, IT1-IT8 income tests | reportableFringeBenefitsExempt through numberOfDependentChildrenIt8 | | Page 8-9, spouse details (married or de facto) | spouseFamilyName through familyAssistanceConsentSignatureDate | | Page 10, taxpayer's declaration questions and signature | requiresSupplementarySection through declarationDate | | Page 10 "I declare that: ..." bullet list, quoted verbatim and combined into one statement | documents[].declarationAttestation | | ato.gov.au: myGov/ATO account linkage requirement, pre-fill sources (employers, banks, government agencies, health funds, third parties, myDeductions uploads), 31 October lodgment due date | hasMyGovAccountLinkedToAto field description; document description |
What is NOT independently confirmed (out of scope), and three sourcing caveats
- The separate "Tax return for individuals (supplementary section) 2026" (pages 13-16 of the same publication, referenced repeatedly on pages 1-10 as a distinct attachment) is entirely out of scope — business income and expenses, capital gains, foreign income and assets, partnership/trust distributions, and rental schedules live there, not in this document. This mirrors
gb/hmrc/self-assessment-tax-return-sa100's SA101-SA109 exclusion andnz/ird/individual-tax-return-ir3's IR3G-worksheet exclusion.requiresSupplementarySection(page 10, declaration question 1) is modelled as a gate field but the supplementary section's own fields are not. - Multiple concurrent employers. Item 1 (Salary or wages) prints five repeating payer rows (TYPE codes visible in the extracted text layer). This is a repeating third-party structure the flat v0.3 field model (GSP-0009) cannot express — the same limitation already recorded for
ie/revenue/self-assessment-tax-return-form11s(Panels C/L) andnz/ird/individual-tax-return-ir3(Boxes 38C-38H). This document models a single payer/employer line (salaryOrWagesPayerAbn,salaryOrWagesTaxWithheld,salaryOrWagesIncome,salaryOrWagesOccupation); a filer with more than one employer in the year is only partially served by v1.0.0. - Multiple concurrent private health insurance policies. The private health insurance policy details block prints four repeating policy rows with identical fields. Same GSP-0009 limitation as above; this document models a single policy.
- Transferring a refund to a different taxpayer's account. Not present on the core pages reviewed (unlike the IR3's Boxes 38C-38H, the NAT 2541 core return has no such section); noted here only because the document description excludes it for completeness, matching the IR3 precedent's phrasing style. No corresponding field exists to omit.
- Three genuine box-boundary ambiguities in the extracted text layer, recorded rather than resolved by guessing (same discipline as the NSW interlock/Q-condition negation gap and the DE i-Kfz 10-day/14-day figure conflict, [[gov474-dmv-business-formation-vertical-and-xfa-extraction]]): Each affected field's own
descriptionrepeats the relevant caveat so a consumer is not misled into treating the association as settled.superLumpSumTaxableComponentUntaxed(item 8) — a third dollar box sits immediately above item 9's label in the extracted position data; its precise identity (a third component of item 8, versus a running tax-withheld subtotal carried from earlier items) could not be confirmed with certainty from position data alone.costOfManagingTaxAffairs(D10) — a "Litigation costs" label is printed directly above D10's own boxes; whether it names a component amount within D10 or a separate, unlabelled figure is not resolved.incomeFromInvestmentPartnershipOtherSources,otherIncomeFromEmploymentAndBusiness, andotherDeductionsFromBusinessIncome— three dollar boxes printed directly below A3 (Government super contributions) carry letter codes but no A-numbered question label of their own in the extracted text; they may belong to A3 or to an unlabelled adjustment block the extraction did not capture a heading for.
- A possible home-address street line. The printed form's home-address block (page 1, "Print your home address below") captures only Suburb/town/locality, State/territory, Postcode and Country in the text layer, unlike the postal address block a few lines above it which has an explicit free-text address line. It is plausible a street-address box exists there as a graphical element the text layer did not capture as readable text (the same class of gap as the gender checkboxes on NZTA's DL1 form) rather than a genuine absence.
homeSuburbOrTownonly models what the extraction evidences; nohomeAddressLinefield was invented.
Why every field here is optional except the compulsory few
Unlike a blank-form-fill-in document (e.g. us/irs/individual-income-tax-return-1040), myTax's defining shape is reviewing a pre-filled return: the ATO says it will "pre-fill most information from your employers, banks, government agencies, health funds and third parties by late July" before the individual ever opens the return. A field being optional here therefore reflects both (a) genuine applicability (most items apply only to some taxpayers, exactly as on the paper form) and (b) the pre-fill shape itself — myTax may populate a value the individual never manually types, so required: true would wrongly imply the applicant must supply it by hand. The form's own compulsory markings are honored directly: M2 (Medicare levy surcharge) is printed "THIS QUESTION IS COMPULSORY FOR ALL TAXPAYERS", and the declaration/signature are required to lodge — those are the only fields with required: true besides the core identity/access fields (myGov linkage, TFN, residency, name, postal address details, EFT details) that every lodgment genuinely needs. This is the first published GovSchema document exercising this "review a pre-filled return" shape, also shared by the still-open DE ELSTER and SG myTax Portal/Form B1 tax-return candidates ([[gov430-taxes-vertical-and-gsp0019]]).
Time-versioning and the edition axis (flagged spec gap)
The NAT 2541 is genuinely time-versioned — the ATO reissues a fresh edition every income year (the form's own footer reads "NAT 2541-06.2026" and "1 July 2025 to 30 June 2026" throughout) — the same shape as gb/hmrc/self-assessment-tax-return-sa100, us/irs/individual-income-tax-return-1040, ie/revenue/self-assessment-tax-return-form11s, and nz/ird/individual-tax-return-ir3. Spec v0.3's edition.scheme enum is closed to us-tax-year / gb-tax-year / award-year (SPEC.md §5.7) — none of which is correct for Australia, whose income year runs 1 July to 30 June (neither a calendar year nor the UK's April-to-April year). Rather than mislabeling the scheme or unilaterally extending a closed enum, this document is published at the plain, non-edition registry path (registry/au/ato/individual-tax-return-mytax/1.0.0/schema.json), consistent with the IE and NZ workaround. This is the fourth reference schema to hit this exact gap (after IE Form 11S, NZ IR3, and — for the same reason — implicitly blocking DE ELSTER and SG Form B1 from the edition axis too), further reinforcing spec/proposals/0019-generalize-edition-scheme-calendar-tax-year.md as a genuinely cross-jurisdictional need, not a one-off.
Scope and jurisdiction notes
- Conditional requiredness/visibility is expressed with
requiredWhen/visibleWhen(GSP-0013), targeting spec v0.3. - The
hasMyGovAccountLinkedToAtogate uses ato: null/exitReason: "no-mygov-account-linked"transition (GSP-0013 §4), the same eligibility-gate pattern used byca/on/mto/drivers-licence-renewalandde/kba/vehicle-registrationfor other myGov/portal-linkage preconditions. A taxpayer without a linked myGov account still has a paper-lodgment or registered-tax-agent path; those channels are a different process not modelled by this document (myTax-only), so the exit is presentational, not a claim that no other lodgment channel exists. - The declaration (page 10 bullet list) is modelled as a single
documents[]attestation entry (GSP-0014 §1) with the combined statement text, plusdeclarationSigned/declarationDatefields in the flow — the same splitnz/ird/individual-tax-return-ir3andde/kba/vehicle-registrationuse.
Path to a verified claim (next step)
To advance to status: verified, a reviewer applies manual-source-review-v1 Procedure step 2 against the live, authenticated myTax online screens, resolves the three box-boundary ambiguities above by cross-checking the ATO's "Individual tax return instructions 2026" companion publication (not reviewed this cycle), and records the outcome here — shipping a new schema version if discrepancies are found (VERSIONING.md §3, immutability).
Re-verification
Per the practice's Cadence, nextReviewBy is set to 2027-01-01 (6 months), and in any case before the 2027 income year's edition of the NAT 2541 is published, since the source content itself changes annually.
View the raw record (VERIFICATION.md)
Version history
-
1.1.0draftlatestno independent verification recordschema.json -
1.0.0draftthis pagehas verification recordschema.json
Independent and non-affiliated
GovSchema is an independent, open-source project. This reference is not produced, reviewed, or endorsed by Australian Taxation Office or any government. The authoritative source is always the live government form and its official instructions.