diff --git a/posthog/src/main/java/com/posthog/PostHogConfig.kt b/posthog/src/main/java/com/posthog/PostHogConfig.kt
index 716274b68..1922a2306 100644
--- a/posthog/src/main/java/com/posthog/PostHogConfig.kt
+++ b/posthog/src/main/java/com/posthog/PostHogConfig.kt
@@ -126,7 +126,11 @@ public open class PostHogConfig(
     public var maxBatchSize: Int = DEFAULT_MAX_BATCH_SIZE,
     /**
      * Maximum number of retries for push subscription registration failures.
-     * Durable ingestion queues retain retryable records and are bounded by their queue size.
+     *
+     * This limit does not apply to event, replay, or log ingestion. Retryable ingestion
+     * failures retain queued records for later flush triggers, subject to backoff.
+     * Use [maxQueueSize] for events and replay, and [PostHogLogsConfig.maxBufferSize] for logs.
+     *
      * Defaults to 3
      */
     public var maxRetries: Int = 3,