Skip to content

Commit e5516fd

Browse files
authored
docs(product-tours): Document wait period configuration feature (#15381)
## Summary This PR adds documentation for the new wait period configuration feature in Product Tours, introduced in PostHog/posthog#48224. ## Changes ### `contents/docs/product-tours/targeting.mdx` - Added new "Wait period" section documenting: - What the feature does (prevents tour fatigue by hiding tours from users who recently saw other tours) - How to configure it (select tour types and number of days 1-365, default 7) - The person properties used for tracking (`$product_tour_last_seen_date/{type}`) ### `contents/docs/product-tours/analytics.mdx` - Added documentation for the three new person properties in the "Person properties" section: - `$product_tour_last_seen_date/tour` - `$product_tour_last_seen_date/announcement` - `$product_tour_last_seen_date/banner` - Added cross-link to the new wait period targeting documentation ## Related - Feature PR: PostHog/posthog#48224 --- This PR was created by the Inkeep Content Writer agent, which is maintained by the [Docs and Wizard team](https://posthog.slack.com/archives/C09GTQY5RLZ). Please reach out on Slack for help if needed.
1 parent f8df1b6 commit e5516fd

File tree

2 files changed

+24
-0
lines changed

2 files changed

+24
-0
lines changed

contents/docs/product-tours/analytics.mdx

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -51,4 +51,10 @@ These properties are set when users interact with tours:
5151
- `$product_tour_completed/{tour_id}` - Set to `true` when completed
5252
- `$product_tour_dismissed/{tour_id}` - Set to `true` when dismissed
5353

54+
These properties track when each tour type was last shown (used for [wait period targeting](/docs/product-tours/targeting#wait-period)):
55+
56+
- `$product_tour_last_seen_date/tour` - Timestamp when a tour was last shown
57+
- `$product_tour_last_seen_date/announcement` - Timestamp when an announcement was last shown
58+
- `$product_tour_last_seen_date/banner` - Timestamp when a banner was last shown
59+
5460
Use these for targeting other tours or creating [cohorts](/docs/data/cohorts).

contents/docs/product-tours/targeting.mdx

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -60,3 +60,21 @@ This is handled via person properties:
6060
- `$product_tour_dismissed/{tour_id}`
6161

6262
These properties are set automatically and used to filter out users who have already interacted with a tour.
63+
64+
## Wait period
65+
66+
Prevent tour fatigue by hiding tours from users who recently saw other tours, announcements, or banners.
67+
68+
Enable the "Don't show to users who recently saw another..." option and configure:
69+
70+
- **Tour types** - Select which types count toward the wait period: tours, announcements, and/or banners
71+
- **Days** - How many days must pass before showing this tour (1-365 days, default 7)
72+
73+
For example, if you configure a 7-day wait period for all types, users who saw any tour, announcement, or banner in the last 7 days won't see this tour.
74+
75+
This uses person properties to track when each type was last shown:
76+
- `$product_tour_last_seen_date/tour`
77+
- `$product_tour_last_seen_date/announcement`
78+
- `$product_tour_last_seen_date/banner`
79+
80+
These properties are set automatically when a tour is shown and checked via the tour's internal feature flag.

0 commit comments

Comments
 (0)