Australian Immigration — Documentation
Data sources, methodology and how to update the data
A free, public dashboard showing Australian immigration statistics from official government sources: when (year/quarter/month), from (country), to (Australia), across years. Open the dashboard to explore migration statistics published by the Department of Home Affairs. Select a section, table and indicator to explore trends, download charts, or view migration patterns by country.
Links
| What | URL |
|---|---|
| Live dashboard | index.html |
| Indicator tree (list) | tree.html |
| Indicator tree (diagram) | docs/indicator_tree.drawio.html |
| Repository | GitHub — Jfilhorv/IMMI_DATA |
Data source
All statistics come from the official release:
- Dataset: Australian Migration Statistics
- Publisher: Department of Home Affairs, Australian Government
- Portal: data.gov.au
- Content: Migration program outcomes (permanent and temporary), humanitarian, visa cancellations, Net Overseas Migration, citizenship, labour market. Tables 1.0–7.8, financial year series.
- Licence: CC BY 4.0 — attribution required; we attribute in the dashboard and do not imply government endorsement.
Current data: Last update uses the 2024–25 statistical package. New releases (e.g. 2025–26) typically appear after the end of the financial year. See the dataset page for the latest download.
How to update: From project root run python scripts/run_update.py for the full pipeline. See docs/DATA_AND_UPDATE.md for the exact script list and steps.
Project structure
IMMI_DATA/ ├── README.md, PLANNING.md, DATA_SOURCES.md ├── data/ (by_sheet, melted, dashboard/) ├── scripts/ (run_update.py, fetch_first_dataset.py, melt_all_sheets.py, build_dashboard_data.py, …) ├── dashboard/ (index.html, app.js, tree.html, documentation.html, data/) └── docs/ (indicator_tree.drawio, indicator_tree.drawio.html)
Goals
- Use publicly available migration datasets released by the Australian Government (Home Affairs, data.gov.au).
- Transform them into clearer visual insights via intuitive charts and dashboards.
- Help immigrants, analysts, and the public understand migration trends.
- Publish an open, freely accessible dashboard on GitHub Pages.
Status
Planning done; data pipeline from dataset → by_sheet → melted → dashboard. Dashboard: Section → Table → (Submenu) → Indicator; dynamic KPIs, line/bar chart, choropleth map and donut by country, news ticker, table notes. Indicator tree — collapsible tree of all 7 sections, 46 tables and 577 indicators. Live at GitHub Pages.
Licence and attribution
Code in this repo: use as you like (e.g. MIT or CC0). Government data: follow the licence of each dataset (e.g. CC BY); we attribute sources on the site.