Skip to content

Clarify list-of-values deprecation for non-list search attribute types#4593

Merged
lennessyy merged 6 commits into
mainfrom
docs/search-attribute-list-deprecation
May 19, 2026
Merged

Clarify list-of-values deprecation for non-list search attribute types#4593
lennessyy merged 6 commits into
mainfrom
docs/search-attribute-list-deprecation

Conversation

@austonli
Copy link
Copy Markdown
Contributor

@austonli austonli commented May 19, 2026

Summary

  • Add a :::warning deprecation admonition to the Search Attributes reference page explaining that storing lists of values in non-list types (Keyword, Int, etc.) is deprecated and will be enforced after September 30, 2026
  • Cover migration paths: KeywordKeywordList, IntKeywordList (as strings) or split into multiple Int attributes
  • Note that Temporal Cloud is actively enforcing this restriction
  • Fix a misleading TypeScript code example that showed CustomIntField: [1, 2, 3] (the deprecated pattern) → CustomIntField: [1]

Context

Temporal Cloud is removing unintended support for storing list-of-values in non-list search attribute types. This is a prerequisite for Visibility 2.0. ~23 accounts are affected and customer messaging is being prepared in parallel. These docs changes ensure the public documentation reflects the deprecation before customer outreach begins.

Test plan

  • Verify the :::warning admonition renders correctly in Docusaurus
  • Confirm the TypeScript code example still makes sense with the single-value change
  • Check no broken links or formatting issues

🤖 Generated with Claude Code

┆Attachments: EDU-6392 Clarify list-of-values deprecation for non-list search attribute types

- Add deprecation warning admonition with September 30, 2026 enforcement deadline
- Cover migration paths: Keyword → KeywordList, Int → KeywordList or split into multiple Int attributes
- Fix misleading TypeScript example that showed the deprecated [1, 2, 3] pattern

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@austonli austonli requested a review from a team as a code owner May 19, 2026 17:09
@vercel
Copy link
Copy Markdown

vercel Bot commented May 19, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
temporal-documentation Ready Ready Preview, Comment May 19, 2026 10:07pm

Request Review

@CLAassistant
Copy link
Copy Markdown

CLAassistant commented May 19, 2026

CLA assistant check
All committers have signed the CLA.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 19, 2026

📖 Docs PR preview links

Comment thread docs/develop/typescript/platform/observability.mdx Outdated
Comment thread docs/encyclopedia/visibility/search-attributes.mdx Outdated
Comment thread docs/encyclopedia/visibility/search-attributes.mdx Outdated
Comment thread docs/encyclopedia/visibility/search-attributes.mdx Outdated
Comment thread docs/encyclopedia/visibility/search-attributes.mdx Outdated
Co-authored-by: Rodrigo Zhou <rodrigo.zhou@gmail.com>
austonli and others added 2 commits May 19, 2026 14:38
Co-authored-by: Lenny Chen <55669665+lennessyy@users.noreply.github.com>
Co-authored-by: Lenny Chen <55669665+lennessyy@users.noreply.github.com>
Co-authored-by: Lenny Chen <55669665+lennessyy@users.noreply.github.com>
@lennessyy lennessyy merged commit 06c5368 into main May 19, 2026
9 checks passed
@lennessyy lennessyy deleted the docs/search-attribute-list-deprecation branch May 19, 2026 22:23
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.

4 participants