Skip to content

docs(logs): Add UI settings method for configuring person pivot attribute#17305

Open
inkeep[bot] wants to merge 1 commit into
masterfrom
docs-writer-ai-update-2026-06-04T22-43-48-455Z-owkd4z
Open

docs(logs): Add UI settings method for configuring person pivot attribute#17305
inkeep[bot] wants to merge 1 commit into
masterfrom
docs-writer-ai-update-2026-06-04T22-43-48-455Z-owkd4z

Conversation

@inkeep
Copy link
Copy Markdown
Contributor

@inkeep inkeep Bot commented Jun 4, 2026

Changes

Updates the Link logs to a person documentation to reflect the new UI settings panel added in PostHog/posthog#61301.

What's new

The "Customizing the attribute key" section now documents:

  1. UI settings method (primary) — Admins can configure the person pivot attribute in Settings > Logs under "Person pivot attribute"
  2. Gear icon shortcut — Users can also reach this setting from the gear icon on any person's Logs tab
  3. API method (alternative) — The existing curl example is preserved for programmatic configuration

Why

PR #61301 added a new settings UI panel that allows admin users to configure the logs_distinct_id_attribute_key via the UI. Previously this was API-only. The documentation should reflect both methods, with the UI being the recommended approach for most users.


This PR was created by the Inkeep Content Writer agent, which is maintained by the Docs and Wizard team. Please reach out on Slack for help if needed.

PR #61301 adds a settings UI at Environment > Logs > "Link to person"
for configuring the logs_distinct_id_attribute_key (admin-only), plus a
gear icon shortcut from the person Logs tab. Update the "Customizing
the attribute key" section to mention the UI method first and present
the API as an alternative.
@inkeep inkeep Bot requested a review from DanielVisca June 4, 2026 22:45
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 4, 2026

Deploy preview

Status Details Updated (UTC)
🟢 Ready View preview Jun 04, 2026 10:56PM

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 4, 2026

Vale prose linter → found 5 errors, 13 warnings, 0 suggestions in your markdown

Full report → Copy the linter results into an LLM to batch-fix issues.

Linter being weird? Update the rules!

contents/docs/logs/link-person.mdx — 5 errors, 13 warnings, 0 suggestions
Line Severity Message Rule
2:13 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
13:13 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
15:6 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
18:52 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
18:66 warning 'OTel' is a possible misspelling. PostHogBase.Spelling
19:16 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
19:66 warning Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept. PostHogBase.ProductNames
19:85 warning Capitalize 'Surveys' for PostHog's product. Use 'surveys' for the general industry concept. PostHogBase.ProductNames
24:152 error Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash. PostHogBase.EnDash
25:118 error Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash. PostHogBase.EnDash
31:5 warning 'Backend (OpenTelemetry)' heading should be in sentence case, and product names should be capitalized. PostHogBase.SentenceCase
33:15 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
33:62 error Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash. PostHogBase.EnDash
102:233 error Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash. PostHogBase.EnDash
121:69 error Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash. PostHogBase.EnDash
127:41 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
133:9 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
133:17 warning Capitalize 'Session Replay' for PostHog's product. Use 'session replay' for the general industry concept. PostHogBase.ProductNames

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 4, 2026

Hey @DanielVisca! This docs PR was generated for you by an agent. You're responsible for reviewing and merging it into production.

  1. Review and approve the PR
  2. Merge the PR
    a. Check the preview env and CI build and merge it yourself
    b. Enable auto-merge if you're confident in the changes

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants