Skip to content

feat: subscriptions liquid filter#1324

Open
cjbell wants to merge 2 commits intomainfrom
cjbell-dynamic-data-filters-docs-460e
Open

feat: subscriptions liquid filter#1324
cjbell wants to merge 2 commits intomainfrom
cjbell-dynamic-data-filters-docs-460e

Conversation

@cjbell
Copy link
Contributor

@cjbell cjbell commented Feb 24, 2026

Description

This PR introduces documentation for the newly added subscriptions Liquid filter, which allows loading up to 25 active subscriptions for a user within workflow templates.

The changes aim to:

  1. Inform users about the new subscriptions filter and how to use it in templates.
  2. Consolidate documentation for all dynamic data loading filters (user, object, tenant, subscriptions) into a new "Dynamic data filters" section in the Liquid helpers reference.
  3. Enhance discoverability by adding a note about this functionality to the Subscriptions concept page.

The updates include:

  • Adding a dedicated section for the subscriptions filter in content/template-editor/referencing-data.mdx, including usage examples and limitations.
  • Creating a "Dynamic data filters" section in content/template-editor/reference-liquid-helpers.mdx that outlines the user, object, tenant, and subscriptions filters.
  • Adding a "Referencing subscriptions in templates" section to content/concepts/subscriptions.mdx with a brief overview and a link to the detailed documentation.

Todos

  • None

Tasks

  • None

Screenshots

  • Not relevant

Open in Web Open in Cursor 

- Add subscriptions filter section to 'Referencing data in templates' page
  with examples for loading subscriptions by static and dynamic identifiers
- Add 'Dynamic data filters' section to liquid helpers reference documenting
  user, object, tenant, and subscriptions filters in a reference table
- Add 'Referencing subscriptions in templates' section to subscriptions
  concept page with usage example and link to full docs
- Add callout on referencing-data page linking to the new dynamic data
  filters reference section
- Update frontmatter tags to include new filter keywords

Co-authored-by: Chris Bell <chris@cjbell.co>
@cursor
Copy link

cursor bot commented Feb 24, 2026

Cursor Agent can help with this pull request. Just @cursor in comments and I'll start working on changes in this branch.
Learn more about Cursor Agents

@vercel
Copy link

vercel bot commented Feb 24, 2026

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

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment Feb 24, 2026 6:41pm

Request Review

Co-authored-by: Chris Bell <chris@cjbell.co>
@cjbell cjbell changed the title Dynamic data filters docs feat: subscriptions liquid filter Feb 24, 2026
@cjbell cjbell marked this pull request as ready for review February 24, 2026 21:23
Knock environment at render time. You can find a full reference of these
filters in the{" "}
<a href="/template-editor/reference-liquid-helpers#dynamic-data-filters">
liquid helpers reference
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
liquid helpers reference
Liquid helpers reference

nit

],
[
"subscriptions",
"Loads up to 25 active subscriptions for a user by their identifier. Returns a list of subscription objects, each containing the subscribed object and any custom properties set on the subscription.",
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
"Loads up to 25 active subscriptions for a user by their identifier. Returns a list of subscription objects, each containing the subscribed object and any custom properties set on the subscription.",
"Loads up to 25 active subscriptions for a user by their identifier. Returns a list of subscription objects, each containing the subscribed Object and any custom properties set on the subscription.",

Not sure if this is a helpful differentiation and whether it's the entire serialized Object. But "subscription objects, each containing the subscribed object" was a bit confusing to read.

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.

3 participants