troubleshooting update: all product docs (#14238)

* troubleshooting update product analytics

* solved community questions: pinned + most recent

* web analytics troubleshooting

* session replay troubleshooting

* feature flags

* experiments

* surveys

* cdp

* data warehouse

* llma

* rev analytics

* customer analytics

* posthogai

* workflows

* endpoints and logs

* hoggie pics for intros

* empty state

Author: edwinyjlim

contents/docs/cdp/common-questions.md contents/docs/cdp/troubleshooting.mdcontents/docs/cdp/common-questions.md renamed to contents/docs/cdp/troubleshooting.md

@@ -1,7 +1,13 @@
 ---
-title: Customer data platform troubleshooting and FAQs
+title: Customer Data Platform troubleshooting
 ---
 
+This page covers troubleshooting for CDP. For setup, see the [installation guides](/docs/cdp/sources).
+
+## Have a question? Ask PostHog AI
+
+<AskAIInput placeholder="Type your question and hit enter..." />
+
 ## My transformation or destination isn't working, what do I do?
 
 1. Wait 60 seconds, then check that the transformation or destination is enabled with the correct configuration options in the [data pipeline tab](https://app.posthog.com/pipeline). You can find the correct configuration options in the [transformation or destination's documentation](/docs/cdp) by searching for it in the destinations, transformations, or filtering sections of the docs.
@@ -70,4 +76,10 @@ We recommend sending a `uuid` value with every captured event. Events with the s
 
 This is important because failures and retries happen, so your application or our library might send the same event multiple times. If you don't send UUIDs for every event, we aren't able to know if it's the same event, and hence we are not able to de-duplicate it for you.
 
-Some of our SDKs, such as JavaScript Web, do this automatically, other SDKs allow you to pass UUIDs. If you're using an SDK which doesn't currently support UUIDs for every event, please consider creating a PR or filing an issue in GitHub.
+Some of our SDKs, such as JavaScript Web, do this automatically, other SDKs allow you to pass UUIDs. If you're using an SDK which doesn't currently support UUIDs for every event, please consider creating a PR or filing an issue in GitHub.
+
+## Solved community questions
+
+<SolvedQuestions
+    topicLabel="CDP"
+/>

contents/docs/customer-analytics/faq.mdx …s/customer-analytics/troubleshooting.mdxcontents/docs/customer-analytics/faq.mdx renamed to contents/docs/customer-analytics/troubleshooting.mdx contents/docs/customer-analytics/faq.mdx renamed to contents/docs/customer-analytics/troubleshooting.mdx

@@ -1,5 +1,5 @@
 ---
-title: Customer Analytics FAQ
+title: Customer Analytics troubleshooting
 sidebar: Docs
 showTitle: true
 ---
@@ -8,7 +8,11 @@ import CustomerAnalyticsBetaWarning from './_snippets/customer-analytics-beta-wa
 
 <CustomerAnalyticsBetaWarning />
 
-Have a question not covered here? [Let us know](https://us.posthog.com/home#supportModal).
+This page covers troubleshooting for Customer Analytics. For setup, see the [installation guides](/docs/customer-analytics/installation).
+
+## Have a question? Ask PostHog AI
+
+<AskAIInput placeholder="Type your question and hit enter..." />
 
 ## What activity event does customer analytics use by default?
 

…docs/data-warehouse/common-questions.mdx …/docs/data-warehouse/troubleshooting.mdxcontents/docs/data-warehouse/common-questions.mdx renamed to contents/docs/data-warehouse/troubleshooting.mdx contents/docs/data-warehouse/common-questions.mdx renamed to contents/docs/data-warehouse/troubleshooting.mdx

@@ -1,7 +1,13 @@
 ---
-title: Data warehouse troubleshooting and FAQs
+title: Data Warehouse troubleshooting
 ---
 
+This page covers troubleshooting for Data Warehouse. For setup, see the [installation guides](/docs/data-warehouse/sources).
+
+## Have a question? Ask PostHog AI
+
+<AskAIInput placeholder="Type your question and hit enter..." />
+
 ## How can I see why my syncs are failing?
 
 From the [source page](https://app.posthog.com/pipeline/sources), click the source that's failing, scroll over to the **Status** column and hover over the error message.
@@ -41,4 +47,10 @@ This is useful if you have a complex query and you want to test parts of it with
   imageDark="https://res.cloudinary.com/dmukukwp6/image/upload/w_1600,c_limit,q_auto,f_auto/Clean_Shot_2025_09_02_at_14_24_23_2x_6dad899bb8.png"
   alt="Running partial SQL queries" 
   classes="rounded"
+/>
+
+## Solved community questions
+
+<SolvedQuestions
+    topicLabel="Data Warehouse"
 />

contents/docs/endpoints/troubleshooting.mdx

@@ -1,12 +1,18 @@
 ---
-title: Troubleshooting
+title: Endpoints troubleshooting
 sidebar: Docs
 showTitle: true
 ---
 import EndpointsBetaSnippet from './_snippets/beta.mdx'
 
 <EndpointsBetaSnippet />
 
+This page covers troubleshooting for Endpoints. For setup, see the [installation guide](/docs/endpoints/start-here).
+
+## Have a question? Ask PostHog AI
+
+<AskAIInput placeholder="Type your question and hit enter..." />
+
 ## Endpoint not found
 
 If you get a 404 error:
@@ -38,3 +44,8 @@ If endpoints are slow:
 - [SQL documentation](/docs/sql) - Write SQL queries for your endpoints
 - [Insights](/docs/product-analytics/insights) - Create insights to use as endpoints
 
+## Solved community questions
+
+<SolvedQuestions
+    topicLabel="Endpoints"
+/>

…docs/error-tracking/common-questions.mdx …/docs/error-tracking/troubleshooting.mdxcontents/docs/error-tracking/common-questions.mdx renamed to contents/docs/error-tracking/troubleshooting.mdx contents/docs/error-tracking/common-questions.mdx renamed to contents/docs/error-tracking/troubleshooting.mdx

@@ -1,5 +1,5 @@
 ---
-title: Experiment troubleshooting and FAQs
+title: Experiment troubleshooting
 ---
 export const AssignAnOverrideLight = "https://res.cloudinary.com/dmukukwp6/video/upload/posthog.com/contents/images/features/experiments/assigning-an-override-light-mode.mp4"
 export const AssignAnOverrideDark = "https://res.cloudinary.com/dmukukwp6/video/upload/posthog.com/contents/images/features/experiments/assigning-an-override-dark-mode.mp4"
@@ -8,6 +8,12 @@ import { ProductScreenshot } from 'components/ProductScreenshot'
 export const ReuseFeatureFlagLight = "https://res.cloudinary.com/dmukukwp6/image/upload/posthog.com/contents/images/features/experiments/reuse-feature-flag-for-experiment-light-mode.png"
 export const ReuseFeatureFlagDark = "https://res.cloudinary.com/dmukukwp6/image/upload/posthog.com/contents/images/features/experiments/reuse-feature-flag-for-experiment-dark-mode.png"
 
+This page covers troubleshooting for Experiments. For setup, see the [installation guides](/docs/experiments/installation).
+
+## Have a question? Ask PostHog AI
+
+<AskAIInput placeholder="Type your question and hit enter..." />
+
 ## How do I use an existing feature flag in an experiment?
 
 We generally don't recommend this, since experiment feature flags need to be in a specific format (see below) or otherwise they won't work.
@@ -89,3 +95,9 @@ You can check your current exposure count on the experiment results page. If you
 - Verify your feature flag implementation.
 - Consider increasing your feature flag's rollout percentage.
 - Ensure your exposure events are firing correctly.
+
+## Solved community questions
+
+<SolvedQuestions
+    topicLabel="Experiments"
+/>

…ts/docs/experiments/common-questions.mdx …nts/docs/experiments/troubleshooting.mdxcontents/docs/experiments/common-questions.mdx renamed to contents/docs/experiments/troubleshooting.mdx contents/docs/experiments/common-questions.mdx renamed to contents/docs/experiments/troubleshooting.mdx

@@ -1,5 +1,5 @@
 ---
-title: Feature flag troubleshooting and FAQs
+title: Feature Flags troubleshooting 
 ---
 
 import { ProductScreenshot } from 'components/ProductScreenshot'
@@ -10,11 +10,17 @@ export const BehavioralCohortsDark = "https://res.cloudinary.com/dmukukwp6/image
 export const DeuplicateAsStaticCohortLight = "https://res.cloudinary.com/dmukukwp6/image/upload/posthog.com/contents/images/docs/feature-flags/duplicate-as-static-cohort-light-mode.png"
 export const DeuplicateAsStaticCohortDark = "https://res.cloudinary.com/dmukukwp6/image/upload/posthog.com/contents/images/docs/feature-flags/duplicate-as-static-cohort-dark-mode.png"
 
+This page covers troubleshooting for Feature Flags. For setup, see the [installation guides](/docs/feature-flags/installation).
+
+## Have a question? Ask PostHog AI
+
+<AskAIInput placeholder="Type your question and hit enter..." />
+
 ## Why is my feature flag not working as expected?
 
 Here's a list of suggestions to troubleshoot your flag:
 
-### 1. Check your flag evaluation on the feature flags tab
+**1. Check your flag evaluation on the feature flags tab**
 
 Check the **feature flags tab** on [the persons page](https://app.posthog.com/persons) for your specific person.
 
@@ -29,15 +35,15 @@ Check the **feature flags tab** on [the persons page](https://app.posthog.com/pe
 - If the flag is shown as enabled here, there may be a problem in your code. Double-check the steps to [add feature flag code](/docs/feature-flags/adding-feature-flag-code).
 - Ensure you are capturing identified events.
 
-### 2. Check you're calling `identify()` before evaluating the flag
+**2. Check you're calling `identify()` before evaluating the flag**
 
 If you're [identifying](/docs/product-analytics/identify) users, they may see a different value for a feature flag before and after you call `identify()`. 
 
 To ensure they experience consistent behavior, check that you call `identify()` before evaluating the feature flag.
 
 > **Note:** This only applies to frontend SDKs. Server-side SDKs do not need to call `identify()`.
 
-### 3. An ad-blocker may be blocking calls
+**3. An ad-blocker may be blocking calls**
 
 Check if an ad-blocker is interfering with PostHog calls. You can fix this by:
 
@@ -46,13 +52,13 @@ Check if an ad-blocker is interfering with PostHog calls. You can fix this by:
 
 See our guide on [preventing feature flags from being blocked](/tutorials/flags-adblock-prevention) for more details.
 
-### 4. User or group properties may not have been ingested yet
+**4. User or group properties may not have been ingested yet**
 
 If your [release conditions](/docs/feature-flags/creating-feature-flags#release-conditions) depend on user or group properties and you immediately evaluate the feature flag after updating them, the properties may not be ingested in time to calculate the correct flag value.
 
 In this case, when making your `getFeatureFlag()` call, you can [manually include these properties](/docs/feature-flags/adding-feature-flag-code?tab=Web#overriding-server-properties) in the method arguments.
 
-### 5. Raise a support ticket
+**5. Raise a support ticket**
 
 If none of the above resolve your issue, you can [raise a support ticket](https://app.posthog.com/home#supportModal) to see if we can help debug.
 
@@ -183,4 +189,10 @@ Feature flags are charged based on the number of requests made to the `/flags` e
 
 import PostHogBillableUsageTemplate from "../_snippets/posthog-billable-usage-template.mdx"
 
-<PostHogBillableUsageTemplate />
+<PostHogBillableUsageTemplate />
+
+## Solved community questions
+
+<SolvedQuestions
+    topicLabel="Feature Flags"
+/>

…/docs/feature-flags/common-questions.mdx …s/docs/feature-flags/troubleshooting.mdxcontents/docs/feature-flags/common-questions.mdx renamed to contents/docs/feature-flags/troubleshooting.mdx contents/docs/feature-flags/common-questions.mdx renamed to contents/docs/feature-flags/troubleshooting.mdx

@@ -1,7 +1,12 @@
 ---
-title: Troubleshooting and FAQs
+title: LLM Analytics troubleshooting
 ---
 
+This page covers troubleshooting for LLM Analytics. For setup, see the [installation guides](/docs/llm-analytics/installation).
+
+## Have a question? Ask PostHog AI
+
+<AskAIInput placeholder="Type your question and hit enter..." />
 
 ## How much does LLM analytics cost?
 
@@ -16,4 +21,10 @@ Go to the [pricing page](/pricing) to use our calculator to get an estimate. You
 There are a few reasons why you might not be seeing any LLM events:
 
 - There might be a delay in the events being processed. You can check the status of our ingestion on the [PostHog status page](https://status.posthog.com/).
-- If you are in a serverless environment make sure you are calling `posthog.shutdown()` before ending the request.
+- If you are in a serverless environment make sure you are calling `posthog.shutdown()` before ending the request.
+
+## Solved community questions
+
+<SolvedQuestions
+    topicLabel="LLM Analytics"
+/>

contents/docs/llm-analytics/troubleshooting.mdx

@@ -1,11 +1,17 @@
 ---
-title: Logs troubleshooting and FAQs
+title: Logs troubleshooting
 ---
 
 import LogsBetaSnippet from './_snippets/beta.mdx'
 
 <LogsBetaSnippets />
 
+This page covers troubleshooting for Logs. For setup, see the [installation guide](/docs/logs/installation).
+
+## Have a question? Ask PostHog AI
+
+<AskAIInput placeholder="Type your question and hit enter..." />
+
 ## Authentication errors
 
 **Problem**: Getting 401 Unauthorized errors when sending logs.

contents/docs/logs/troubleshooting.mdx

@@ -2,6 +2,10 @@
 title: PostHog AI FAQ
 ---
 
+## Have a question? Ask PostHog AI
+
+<AskAIInput placeholder="Type your question and hit enter..." />
+
 ## What access does PostHog AI have to my data?
 
 While working with PostHog AI, you will certainly share some information with it. Data analysis is a core feature. When doing research, PostHog AI can read the following data in your project:
@@ -46,4 +50,10 @@ Yes, PostHog AI retains your chat history.
 
 ## Can I self-host PostHog AI and use my own models?
 
-No, PostHog AI is only available in the cloud-hosted [PostHog app](https://app.posthog.com), which uses third-party LLM providers. PostHog automatically selects the most efficient model for each AI feature. 
+No, PostHog AI is only available in the cloud-hosted [PostHog app](https://app.posthog.com), which uses third-party LLM providers. PostHog automatically selects the most efficient model for each AI feature. 
+
+## Solved community questions
+
+<SolvedQuestions
+    topicLabel="PostHog AI"
+/>