diff --git a/README.md b/README.md
index c9822ba..b1bfefc 100644
--- a/README.md
+++ b/README.md
@@ -20,6 +20,19 @@ main branch, a release of the helm chart is triggered automatically if the
 
 This git repository uses [Github Pages](https://helm.sh/docs/topics/chart_repository/#github-pages-example) to host the helm repository.
 
+## Changelogs
+
+Add a [Changelog](https://artifacthub.io/docs/topics/annotations/helm/#supported-annotations) for the new chart version. Example:
+
+version: 1.2.3
+annotations:
+  artifacthub.io/changes: | 
+    - kind: changed
+      description: We now include a changelog in each helm chart.
+      links:
+        - name: GitHub Issue
+          url: https://github.com/subshell/helm-charts/pull/171
+
 * * *
 
 Take a look at this project from the [subshell](https://subshell.com) team. We make [Sophora](https://subshell.com/sophora/): a content management software for content creation, curation, and distribution. [Join our team!](https://subshell.com/jobs/) | [Imprint](https://subshell.com/about/imprint/)
diff --git a/charts/external-secrets/Chart.yaml b/charts/external-secrets/Chart.yaml
index c66668a..ed5c80e 100644
--- a/charts/external-secrets/Chart.yaml
+++ b/charts/external-secrets/Chart.yaml
@@ -7,5 +7,6 @@ annotations:
   artifacthub.io/changes: |
     - kind: added
       description: "link to sources at GitHub"
+
 sources:
   - https://github.com/subshell/helm-charts/tree/main/charts/external-secrets
diff --git a/charts/gateway/Chart.yaml b/charts/gateway/Chart.yaml
index 4e1fe9b..07e2292 100644
--- a/charts/gateway/Chart.yaml
+++ b/charts/gateway/Chart.yaml
@@ -11,5 +11,6 @@ annotations:
   artifacthub.io/changes: |
     - kind: added
       description: "link to sources at GitHub"
+
 sources:
   - https://github.com/subshell/helm-charts/tree/main/charts/gateway
diff --git a/charts/o-neko-catnip/Chart.yaml b/charts/o-neko-catnip/Chart.yaml
index 6f594d4..f9afcf7 100644
--- a/charts/o-neko-catnip/Chart.yaml
+++ b/charts/o-neko-catnip/Chart.yaml
@@ -2,7 +2,12 @@ apiVersion: v2
 name: o-neko-catnip
 description: A Helm chart for the O-Neko URL trigger
 type: application
-version: 1.3.3
+version: 1.3.4
+annotations:
+  artifacthub.io/changes: |
+    - kind: added
+      description: "added Artifacthub changelog annotation"
+
 appVersion: "1.3.2"
 sources:
   - https://github.com/subshell/o-neko-catnip/
diff --git a/charts/o-neko/Chart.yaml b/charts/o-neko/Chart.yaml
index 89ff86a..ecb7085 100644
--- a/charts/o-neko/Chart.yaml
+++ b/charts/o-neko/Chart.yaml
@@ -2,7 +2,12 @@ apiVersion: v2
 name: o-neko
 description: A Helm chart for O-Neko
 type: application
-version: 1.6.1
+version: 1.6.2
+annotations:
+  artifacthub.io/changes: |
+    - kind: added
+      description: "added Artifacthub changelog annotation"
+
 appVersion: "1.8.0"
 sources:
   - https://github.com/subshell/o-neko/
diff --git a/charts/sophora-admin-dashboard/Chart.yaml b/charts/sophora-admin-dashboard/Chart.yaml
index 03b975d..a9072b5 100644
--- a/charts/sophora-admin-dashboard/Chart.yaml
+++ b/charts/sophora-admin-dashboard/Chart.yaml
@@ -13,4 +13,8 @@ icon: https://subshell.com/logos/admindashboard104~1x1.1683631966185.png
 # This is the chart version. This version number should be incremented each time you make changes
 # to the chart and its templates, including the app version.
 # Versions are expected to follow Semantic Versioning (https://semver.org/)
-version: 1.3.2
+version: 1.3.3
+annotations:
+  artifacthub.io/changes: |
+    - kind: added
+      description: "added Artifacthub changelog annotation"
diff --git a/charts/sophora-ai/Chart.yaml b/charts/sophora-ai/Chart.yaml
index ae46ea2..47e60bb 100644
--- a/charts/sophora-ai/Chart.yaml
+++ b/charts/sophora-ai/Chart.yaml
@@ -3,12 +3,13 @@ name: sophora-ai
 description: Sophora AI
 type: application
 version: 2.0.2
+annotations:
+  artifacthub.io/changes: |
+    - kind: added
+      description: "link to subshell website and icon"
+
 appVersion: 1.0.0
 sources:
   - https://github.com/subshell/helm-charts/tree/main/charts/sophora-ai
 home: https://subshell.com/sophora/modules/sophora-ai100.html
 icon: https://subshell.com/logos/sophora-ai106~1x1.1728311176867.png
-annotations:
-  artifacthub.io/changes: |
-    - kind: added
-      description: "link to subshell website and icon"
diff --git a/charts/sophora-cluster-common/Chart.yaml b/charts/sophora-cluster-common/Chart.yaml
index cb7de93..3d4334e 100644
--- a/charts/sophora-cluster-common/Chart.yaml
+++ b/charts/sophora-cluster-common/Chart.yaml
@@ -3,11 +3,12 @@ name: sophora-cluster-common
 description: A Helm chart containing some common resources useful for Sophora cloud setups
 type: application
 version: 1.4.2
-appVersion: "4"
 annotations:
   artifacthub.io/changes: |
     - kind: added
       description: "link to sources at GitHub"
+
+appVersion: "4"
 sources:
   - https://github.com/subshell/helm-charts/tree/main/charts/sophora-cluster-common
 home: https://subshell.com/sophora/modules/sophora-server102.html
diff --git a/charts/sophora-contentapi/Chart.yaml b/charts/sophora-contentapi/Chart.yaml
index 6b4da26..3c949be 100644
--- a/charts/sophora-contentapi/Chart.yaml
+++ b/charts/sophora-contentapi/Chart.yaml
@@ -2,7 +2,12 @@ apiVersion: v2
 name: sophora-contentapi
 description: Sophora Content API
 type: application
-version: 1.0.1
+version: 1.0.2
+annotations:
+  artifacthub.io/changes: |
+    - kind: added
+      description: "added Artifacthub changelog annotation"
+
 appVersion: 6.0.0
 sources:
   - https://github.com/subshell/helm-charts/tree/main/charts/sophora-contentapi
diff --git a/charts/sophora-courier/Chart.yaml b/charts/sophora-courier/Chart.yaml
index f64a70f..5bc5859 100644
--- a/charts/sophora-courier/Chart.yaml
+++ b/charts/sophora-courier/Chart.yaml
@@ -15,7 +15,11 @@ type: application
 # This is the chart version. This version number should be incremented each time you make changes
 # to the chart and its templates, including the app version.
 # Versions are expected to follow Semantic Versioning (https://semver.org/)
-version: 1.1.2
+version: 1.1.3
+annotations:
+  artifacthub.io/changes: |
+    - kind: added
+      description: "added Artifacthub changelog annotation"
 
 # This is the version number of the application being deployed. This version number should be
 # incremented each time you make changes to the application. Versions are not expected to
diff --git a/charts/sophora-export-job/Chart.yaml b/charts/sophora-export-job/Chart.yaml
index 1a675b9..6880be3 100644
--- a/charts/sophora-export-job/Chart.yaml
+++ b/charts/sophora-export-job/Chart.yaml
@@ -15,7 +15,11 @@ type: application
 # This is the chart version. This version number should be incremented each time you make changes
 # to the chart and its templates, including the app version.
 # Versions are expected to follow Semantic Versioning (https://semver.org/)
-version: 2.0.2
+version: 2.0.3
+annotations:
+  artifacthub.io/changes: |
+    - kind: added
+      description: "added Artifacthub changelog annotation"
 
 # This is the version number of the application being deployed. This version number should be
 # incremented each time you make changes to the application. Versions are not expected to
diff --git a/charts/sophora-image-access-service/Chart.yaml b/charts/sophora-image-access-service/Chart.yaml
index d256704..1bded4b 100644
--- a/charts/sophora-image-access-service/Chart.yaml
+++ b/charts/sophora-image-access-service/Chart.yaml
@@ -15,7 +15,11 @@ type: application
 # This is the chart version. This version number should be incremented each time you make changes
 # to the chart and its templates, including the app version.
 # Versions are expected to follow Semantic Versioning (https://semver.org/)
-version: 1.3.2
+version: 1.3.3
+annotations:
+  artifacthub.io/changes: |
+    - kind: added
+      description: "added Artifacthub changelog annotation"
 
 # This is the version number of the application being deployed. This version number should be
 # incremented each time you make changes to the application. Versions are not expected to
diff --git a/charts/sophora-image-ai/Chart.yaml b/charts/sophora-image-ai/Chart.yaml
index f781019..988b64a 100644
--- a/charts/sophora-image-ai/Chart.yaml
+++ b/charts/sophora-image-ai/Chart.yaml
@@ -3,11 +3,12 @@ name: sophora-image-ai
 description: Sophora Image AI
 type: application
 version: 2.1.1
-appVersion: 5.1.0
 annotations:
   artifacthub.io/changes: |
     - kind: added
       description: "link to subshell website"
+
+appVersion: 5.1.0
 sources:
   - https://github.com/subshell/helm-charts/tree/main/charts/sophora-image-ai
 home: https://subshell.com/sophora/modules/sophora-image-ai100.html
diff --git a/charts/sophora-image-update-service/Chart.yaml b/charts/sophora-image-update-service/Chart.yaml
index 10cb3bf..b79f029 100644
--- a/charts/sophora-image-update-service/Chart.yaml
+++ b/charts/sophora-image-update-service/Chart.yaml
@@ -15,7 +15,11 @@ type: application
 # This is the chart version. This version number should be incremented each time you make changes
 # to the chart and its templates, including the app version.
 # Versions are expected to follow Semantic Versioning (https://semver.org/)
-version: 1.0.4
+version: 1.0.5
+annotations:
+  artifacthub.io/changes: |
+    - kind: added
+      description: "added Artifacthub changelog annotation"
 
 # This is the version number of the application being deployed. This version number should be
 # incremented each time you make changes to the application. Versions are not expected to
diff --git a/charts/sophora-import-job/Chart.yaml b/charts/sophora-import-job/Chart.yaml
index 8a80bca..8fbfa93 100644
--- a/charts/sophora-import-job/Chart.yaml
+++ b/charts/sophora-import-job/Chart.yaml
@@ -15,7 +15,11 @@ type: application
 # This is the chart version. This version number should be incremented each time you make changes
 # to the chart and its templates, including the app version.
 # Versions are expected to follow Semantic Versioning (https://semver.org/)
-version: 1.2.2
+version: 1.2.3
+annotations:
+  artifacthub.io/changes: |
+    - kind: added
+      description: "added Artifacthub changelog annotation"
 
 # This is the version number of the application being deployed. This version number should be
 # incremented each time you make changes to the application. Versions are not expected to
diff --git a/charts/sophora-importer/Chart.yaml b/charts/sophora-importer/Chart.yaml
index 500a9ec..8199010 100644
--- a/charts/sophora-importer/Chart.yaml
+++ b/charts/sophora-importer/Chart.yaml
@@ -16,17 +16,16 @@ type: application
 # to the chart and its templates, including the app version.
 # Versions are expected to follow Semantic Versioning (https://semver.org/)
 version: 2.0.3
+annotations:
+  artifacthub.io/changes: |
+    - kind: added
+      description: "link to sources at GitHub"
 
 # This is the version number of the application being deployed. This version number should be
 # incremented each time you make changes to the application. Versions are not expected to
 # follow Semantic Versioning. They should reflect the version the application is using.
 appVersion: 5.0.0
 
-annotations:
-  artifacthub.io/changes: |
-    - kind: added
-      description: "link to sources at GitHub"
-
 # A list of URLs to source code for this project
 sources:
   - https://github.com/subshell/helm-charts/tree/main/charts/sophora-importer
diff --git a/charts/sophora-indexer/Chart.yaml b/charts/sophora-indexer/Chart.yaml
index ccea7ec..85462a2 100644
--- a/charts/sophora-indexer/Chart.yaml
+++ b/charts/sophora-indexer/Chart.yaml
@@ -16,6 +16,10 @@ type: application
 # to the chart and its templates, including the app version.
 # Versions are expected to follow Semantic Versioning (https://semver.org/)
 version: 1.1.1
+annotations:
+  artifacthub.io/changes: |
+    - kind: added
+      description: "link to sources at GitHub"
 
 # This is the version number of the application being deployed. This version number should be
 # incremented each time you make changes to the application. Versions are not expected to
@@ -23,11 +27,6 @@ version: 1.1.1
 # It is recommended to use it with quotes.
 appVersion: '4.2.2'
 
-annotations:
-  artifacthub.io/changes: |
-    - kind: added
-      description: "link to sources at GitHub"
-
 # A list of URLs to source code for this project
 sources:
   - https://github.com/subshell/helm-charts/tree/main/charts/sophora-indexer
diff --git a/charts/sophora-indexing-service/Chart.yaml b/charts/sophora-indexing-service/Chart.yaml
index 5c47d54..79c72c3 100644
--- a/charts/sophora-indexing-service/Chart.yaml
+++ b/charts/sophora-indexing-service/Chart.yaml
@@ -3,13 +3,12 @@ name: sophora-indexing-service
 description: Sophora Indexing Service (SISI)
 type: application
 version: 1.3.1
-appVersion: '5.4.1'
-
 annotations:
   artifacthub.io/changes: |
     - kind: added
       description: "link to sources at GitHub"
 
+appVersion: '5.4.1'
 sources:
   - https://github.com/subshell/helm-charts/tree/main/charts/sophora-indexing-service
 home: https://subshell.com/sophora/modules/sophora-indexing-service100.html
diff --git a/charts/sophora-linkchecker/Chart.yaml b/charts/sophora-linkchecker/Chart.yaml
index f6ab531..f8aa42b 100644
--- a/charts/sophora-linkchecker/Chart.yaml
+++ b/charts/sophora-linkchecker/Chart.yaml
@@ -2,7 +2,12 @@ apiVersion: v2
 name: sophora-linkchecker
 description: Sophora Link Checker
 type: application
-version: 0.1.3
+version: 0.1.4
+annotations:
+  artifacthub.io/changes: |
+    - kind: added
+      description: "added Artifacthub changelog annotation"
+
 appVersion: 6.0.0
 sources:
   - https://github.com/subshell/helm-charts/tree/main/charts/sophora-linkchecker
diff --git a/charts/sophora-media-finder/Chart.yaml b/charts/sophora-media-finder/Chart.yaml
index 72a94ea..cedd080 100644
--- a/charts/sophora-media-finder/Chart.yaml
+++ b/charts/sophora-media-finder/Chart.yaml
@@ -3,13 +3,12 @@ name: sophora-media-finder
 description: A Helm chart for Sophora Media Finder
 type: application
 version: 0.2.3
-appVersion: "5.x"
-
 annotations:
   artifacthub.io/changes: |
     - kind: added
       description: "link to sources at GitHub"
 
+appVersion: "5.x"
 sources:
   - https://github.com/subshell/helm-charts/tree/main/charts/sophora-media-finder
 home: https://subshell.com/sophora/modules/sophora-smf100.html
diff --git a/charts/sophora-metadata-supplier/Chart.yaml b/charts/sophora-metadata-supplier/Chart.yaml
index f0164d0..0afa68a 100644
--- a/charts/sophora-metadata-supplier/Chart.yaml
+++ b/charts/sophora-metadata-supplier/Chart.yaml
@@ -3,13 +3,12 @@ name: sophora-metadata-supplier
 description: Sophora Metadata Supplier (SMS)
 type: application
 version: 1.3.4
-appVersion: '4.14.0'
-
 annotations:
   artifacthub.io/changes: |
     - kind: added
       description: "link to sources at GitHub"
 
+appVersion: '4.14.0'
 sources:
   - https://github.com/subshell/helm-charts/tree/main/charts/sophora-metadata-supplier
 home: https://subshell.com/sophora/modules/sophora-metadata-supplier100.html
diff --git a/charts/sophora-schema-docs/Chart.yaml b/charts/sophora-schema-docs/Chart.yaml
index c9dc454..f98b4ff 100644
--- a/charts/sophora-schema-docs/Chart.yaml
+++ b/charts/sophora-schema-docs/Chart.yaml
@@ -2,7 +2,12 @@ apiVersion: v2
 name: sophora-schema-docs
 description: Sophora Schema Docs
 type: application
-version: 2.1.3
+version: 2.1.4
+annotations:
+  artifacthub.io/changes: |
+    - kind: added
+      description: "added Artifacthub changelog annotation"
+
 appVersion: 5.0.0
 sources:
   - https://github.com/subshell/helm-charts/tree/main/charts/sophora-schema-docs
diff --git a/charts/sophora-seo-check/Chart.yaml b/charts/sophora-seo-check/Chart.yaml
index 03aa142..cf2cb47 100644
--- a/charts/sophora-seo-check/Chart.yaml
+++ b/charts/sophora-seo-check/Chart.yaml
@@ -2,7 +2,12 @@ apiVersion: v2
 name: sophora-seo-check
 description: Sophora SEO Check
 type: application
-version: 1.0.2
+version: 1.0.3
+annotations:
+  artifacthub.io/changes: |
+    - kind: added
+      description: "added Artifacthub changelog annotation"
+
 appVersion: 4.12.0
 sources:
   - https://github.com/subshell/helm-charts/tree/main/charts/sophora-seo-check
diff --git a/charts/sophora-server/Chart.yaml b/charts/sophora-server/Chart.yaml
index 34a88d7..d327e86 100644
--- a/charts/sophora-server/Chart.yaml
+++ b/charts/sophora-server/Chart.yaml
@@ -15,7 +15,11 @@ type: application
 # This is the chart version. This version number should be incremented each time you make changes
 # to the chart and its templates, including the app version.
 # Versions are expected to follow Semantic Versioning (https://semver.org/)
-version: 2.10.2
+version: 2.10.3
+annotations:
+  artifacthub.io/changes: |
+    - kind: added
+      description: "added Artifacthub changelog annotation"
 
 # This is the version number of the application being deployed. This version number should be
 # incremented each time you make changes to the application. Versions are not expected to
diff --git a/charts/sophora-tablestar-controller/Chart.yaml b/charts/sophora-tablestar-controller/Chart.yaml
index c07d729..28931f4 100644
--- a/charts/sophora-tablestar-controller/Chart.yaml
+++ b/charts/sophora-tablestar-controller/Chart.yaml
@@ -15,7 +15,11 @@ type: application
 # This is the chart version. This version number should be incremented each time you make changes
 # to the chart and its templates, including the app version.
 # Versions are expected to follow Semantic Versioning (https://semver.org/)
-version: 1.0.1
+version: 1.0.2
+annotations:
+  artifacthub.io/changes: |
+    - kind: added
+      description: "added Artifacthub changelog annotation"
 
 # This is the version number of the application being deployed. This version number should be
 # incremented each time you make changes to the application. Versions are not expected to
diff --git a/charts/sophora-ugc/Chart.yaml b/charts/sophora-ugc/Chart.yaml
index 7210eef..83df82d 100644
--- a/charts/sophora-ugc/Chart.yaml
+++ b/charts/sophora-ugc/Chart.yaml
@@ -16,6 +16,13 @@ type: application
 # to the chart and its templates, including the app version.
 # Versions are expected to follow Semantic Versioning (https://semver.org/)
 version: 2.0.12
+annotations:
+  artifacthub.io/changes: |
+    - kind: added
+      description: "link to sources at GitHub"
+  artifacthub.io/links: |
+    - name: Documentation for Sophora UGC 
+      url: https://subshell.com/docs/ugc/
 
 # This is the version number of the application being deployed. This version number should be
 # incremented each time you make changes to the application. Versions are not expected to
@@ -31,11 +38,3 @@ sources:
 home: https://subshell.com/sophora/modules/sophora-ugc-comments-quizzes-votings-polls-forms100.html
 # A URL to an SVG or PNG image to be used as an icon
 icon: https://subshell.com/logos/ugc104~1x1.1683631915261.png
-
-annotations:
-  artifacthub.io/changes: |
-    - kind: added
-      description: "link to sources at GitHub"
-  artifacthub.io/links: |
-    - name: Documentation for Sophora UGC 
-      url: https://subshell.com/docs/ugc/
diff --git a/charts/sophora-webclient/Chart.yaml b/charts/sophora-webclient/Chart.yaml
index f93f091..4bb4830 100644
--- a/charts/sophora-webclient/Chart.yaml
+++ b/charts/sophora-webclient/Chart.yaml
@@ -6,7 +6,11 @@ type: application
 # This is the chart version. This version number should be incremented each time you make changes
 # to the chart and its templates, including the app version.
 # Versions are expected to follow Semantic Versioning (https://semver.org/)
-version: 1.4.1
+version: 1.4.2
+annotations:
+  artifacthub.io/changes: |
+    - kind: added
+      description: "added Artifacthub changelog annotation"
 
 # This is the version number of the application being deployed. This version number should be
 # incremented each time you make changes to the application. Versions are not expected to
diff --git a/charts/sophora-youtube-connector/Chart.yaml b/charts/sophora-youtube-connector/Chart.yaml
index ba4c546..1a45a8f 100644
--- a/charts/sophora-youtube-connector/Chart.yaml
+++ b/charts/sophora-youtube-connector/Chart.yaml
@@ -15,15 +15,7 @@ type: application
 # This is the chart version. This version number should be incremented each time you make changes
 # to the chart and its templates, including the app version.
 # Versions are expected to follow Semantic Versioning (https://semver.org/)
-version: 1.2.2
-
-
-# This is the version number of the application being deployed. This version number should be
-# incremented each time you make changes to the application. Versions are not expected to
-# follow Semantic Versioning. They should reflect the version the application is using.
-# It is recommended to use it with quotes.
-appVersion: '4.6.5'
-
+version: 1.2.3
 annotations:
   artifacthub.io/changes: |
     - kind: added
@@ -32,6 +24,12 @@ annotations:
     - name: Documentation for the AV Tool
       url: https://subshell.com/docs/avtool/
 
+# This is the version number of the application being deployed. This version number should be
+# incremented each time you make changes to the application. Versions are not expected to
+# follow Semantic Versioning. They should reflect the version the application is using.
+# It is recommended to use it with quotes.
+appVersion: '4.6.5'
+
 # A list of URLs to source code for this project
 sources:
   - https://github.com/subshell/helm-charts/tree/main/charts/sophora-youtube-connector