diff --git a/README.Rmd b/README.Rmd
index a7acff8..9c818a2 100644
--- a/README.Rmd
+++ b/README.Rmd
@@ -42,6 +42,34 @@ file.copy(file.path("/mnt/d/ScenarioMIP", f), tempdir())
 
 > Create future EnergyPlus Weather files using CMIP6 data
 
+# How to cite
+
+To cite epwshiftr in publications use:
+
+    Jia, Hongyuan, Chong, Adrian, Ning, Baisong, 2023.
+    Epwshiftr: incorporating open data of climate change prediction into building performance simulation for future adaptation and mitigation,
+    in: Proceedings of Building Simulation 2023: 18th Conference of IBPSA, Building Simulation.
+    Presented at the Building Simulation 2023, IBPSA, Shanghai, China, pp. 3201–3207.
+    https://doi.org/10.26868/25222708.2023.1612
+
+A BibTeX entry for LaTeX users is:
+
+```bibtex
+@inproceedings{jia2023epwshiftr,
+  title = {Epwshiftr: Incorporating Open Data of Climate Change Prediction into Building Performance Simulation for Future Adaptation and Mitigation},
+  shorttitle = {Epwshiftr},
+  booktitle = {Proceedings of {{Building Simulation}} 2023: 18th {{Conference}} of {{IBPSA}}},
+  author = {Jia, Hongyuan and Chong, Adrian and Ning, Baisong},
+  year = {2023},
+  series = {Building {{Simulation}}},
+  volume = {18},
+  pages = {3201--3207},
+  publisher = {{IBPSA}},
+  address = {{Shanghai, China}},
+  doi = {10.26868/25222708.2023.1612}
+}
+```
+
 <!-- TOC GFM -->
 
 * [Installation](#installation)
diff --git a/README.md b/README.md
index 8382d1c..0ba6ad9 100644
--- a/README.md
+++ b/README.md
@@ -15,6 +15,34 @@ coverage](https://codecov.io/gh/ideas-lab-nus/epwshiftr/branch/master/graph/badg
 
 > Create future EnergyPlus Weather files using CMIP6 data
 
+# How to cite
+
+To cite epwshiftr in publications use:
+
+    Jia, Hongyuan, Chong, Adrian, Ning, Baisong, 2023.
+    Epwshiftr: incorporating open data of climate change prediction into building performance simulation for future adaptation and mitigation,
+    in: Proceedings of Building Simulation 2023: 18th Conference of IBPSA, Building Simulation.
+    Presented at the Building Simulation 2023, IBPSA, Shanghai, China, pp. 3201–3207.
+    https://doi.org/10.26868/25222708.2023.1612
+
+A BibTeX entry for LaTeX users is:
+
+```bibtex
+@inproceedings{jia2023epwshiftr,
+  title = {Epwshiftr: Incorporating Open Data of Climate Change Prediction into Building Performance Simulation for Future Adaptation and Mitigation},
+  shorttitle = {Epwshiftr},
+  booktitle = {Proceedings of {{Building Simulation}} 2023: 18th {{Conference}} of {{IBPSA}}},
+  author = {Jia, Hongyuan and Chong, Adrian and Ning, Baisong},
+  year = {2023},
+  series = {Building {{Simulation}}},
+  volume = {18},
+  pages = {3201--3207},
+  publisher = {{IBPSA}},
+  address = {{Shanghai, China}},
+  doi = {10.26868/25222708.2023.1612}
+}
+```
+
 <!-- TOC GFM -->
 
   - [Installation](#installation)