timescale · atovpeko · Apr 8, 2025 · Mar 17, 2025 · Mar 17, 2025 · Mar 17, 2025
diff --git a/_troubleshooting/chunk-temp-file-limit.md b/_troubleshooting/chunk-temp-file-limit.md
@@ -2,7 +2,7 @@
 title: Temporary file size limit exceeded when compressing chunks
 section: troubleshooting
 products: [cloud, mst, self_hosted]
-topics: [hypertables, distributed hypertables, compression]
+topics: [hypertables, distributed hypertables, compression, hypercore]
 errors:
   - language: text
     message: |-

diff --git a/_troubleshooting/compression-alter-hypertable.md b/_troubleshooting/compression-alter-hypertable.md
@@ -2,7 +2,7 @@
 title: Cannot add column to a compressed hypertable
 section: troubleshooting
 products: [cloud, mst, self_hosted]
-topics: [hypertables, compression]
+topics: [hypertables, compression, hypercore]
 errors:
   - language: text
     message: |-

diff --git a/_troubleshooting/compression-dml-tuple-limit.md b/_troubleshooting/compression-dml-tuple-limit.md
@@ -2,7 +2,7 @@
 title: Tuple decompression limit exceeded by operation
 section: troubleshooting
 products: [cloud, mst, self_hosted]
-topics: [hypertables, compression]
+topics: [hypertables, compression, hypercore]
 errors:
   - language: text
     message: |-

diff --git a/_troubleshooting/compression-inefficient-chunk-interval.md b/_troubleshooting/compression-inefficient-chunk-interval.md
@@ -0,0 +1,18 @@
+---
+title: Inefficient `compress_chunk_time_interval` configuration
+section: troubleshooting
+products: [cloud, mst, self_hosted]
+topics: [compression, hypercore]
+errors:
+  - language: text
+    message: |-
+      compress_chunk_time_interval configured and primary dimension not first column in compress_orderby. 
+      consider setting "<column name>" as first compress_orderby column
+keywords: [compression, alter_table]
+tags: [compression, alter_table]
+---
+
+When you configure `compress_chunk_time_interval` but do not set the primary dimension as the first column in `compress_orderby`, $TIMESCALE_DB decompresses chunks before merging. This makes merging less efficient. Set the primary dimension of the chunk as the first column in `compress_orderby` to improve efficiency. 
+
+
+
diff --git a/_troubleshooting/compression-userperms.md b/_troubleshooting/compression-userperms.md
@@ -2,7 +2,7 @@
 title: User permissions do not allow chunks to be compressed or decompressed
 section: troubleshooting
 products: [cloud, mst, self_hosted]
-topics: [hypertables, compression, configuration]
+topics: [hypertables, compression, configuration, hypercore]
 errors:
   - language: text
     message: |-

diff --git a/_troubleshooting/invalid-attribute-reindex-hypertable.md b/_troubleshooting/invalid-attribute-reindex-hypertable.md
@@ -2,7 +2,7 @@
 title: Reindex hypertables to fix large indexes
 section: troubleshooting
 products: [cloud, mst, self_hosted]
-topics: [hypertables, distributed hypertables, schema management, data retention, compression]
+topics: [hypertables, distributed hypertables, schema management, data retention, compression, hypercore]
 errors:
   - language: bash
     message: |-

diff --git a/_troubleshooting/scheduled-jobs-stop-running.md b/_troubleshooting/scheduled-jobs-stop-running.md
@@ -2,7 +2,7 @@
 title: Scheduled jobs stop running
 section: troubleshooting
 products: [cloud, mst, self_hosted]
-topics: [jobs, continuous aggregates, data retention, compression]
+topics: [jobs, continuous aggregates, data retention, compression, hypercore]
 apis:
   - [continuous aggregates, add_continuous_aggregate_policy()]
   - [continuous aggregates, add_policies()]

diff --git a/use-timescale/page-index/page-index.js b/use-timescale/page-index/page-index.js
@@ -76,6 +76,11 @@ module.exports = [
             href: "secondary-indexes",
             excerpt: "Automate",
           },
+          {
+            title: "Troubleshooting",
+            href: "troubleshooting",
+            type: "placeholder",
+          },
         ],
       },
       {