Skip to content

docs: add Packaging Subflows as Custom Nodes page - #8355

Open
dgatti0213 wants to merge 3 commits into
mainfrom
docs/packaging-subflows
Open

docs: add Packaging Subflows as Custom Nodes page#8355
dgatti0213 wants to merge 3 commits into
mainfrom
docs/packaging-subflows

Conversation

@dgatti0213

@dgatti0213 dgatti0213 commented Sep 1, 2026

Copy link
Copy Markdown
Contributor

What & why

Adds a user-docs page for the Subflow exporter (shipped in 2.21) — packaging a Node-RED subflow as a custom node published to the Team's Custom Nodes registry. This was previously only covered in the release changelog/blog, with no reference doc.

Paired with website PR FlowFuse/website#5723 (Application Guide), whose Subflow link points at this new page — that PR is held until this one merges so the link doesn't 404.

Changes

  • New: docs/user/packaging-subflows.md — Packaging Subflows as Custom Nodes
    • The packaging workflow (build flow → convert to subflow → fill package details → Publish)
    • Name & version behavior (scoped @flowfuse-<team id>/<node-name> naming; same-name republish updates, version bump for updates)
    • Installing via Manage palette from the Team Library catalogue
    • Both screenshots reused from the 2.21 changelog
  • Updated: docs/user/custom-npm-packages.md — note cross-linking to the new page

Key nuance called out

Packaging is Hosted-Instance-only, but the published nodes install and run on any instance type (Hosted or Remote).

Document the Subflow exporter (shipped in 2.21): package a Node-RED
subflow as a custom node published to the Team's Custom Nodes registry,
how the name/version behave, and installing it via Manage palette. Notes
that packaging is Hosted-Instance-only while the published nodes install
on any instance type. Cross-links from Custom Node Packages. Screenshots
reused from the 2.21 changelog.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Docs state what the feature is, not who's entitled to it.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@hardillb

hardillb commented Sep 1, 2026

Copy link
Copy Markdown
Contributor

This is a Self Hosted Enterprise only feature, (it is available to both Hub and Edge on the new tiers).

The reason it was available to Pro on FFC is that there was never a hard link between what we choose to offer to Pro teams on FFC and what was in a Pro Self Hosted license because FFC always ran with a full Enterprise License.

@dgatti0213

Copy link
Copy Markdown
Contributor Author

Subflow export should be available on all new tiers. Fleet should have this too.

@hardillb

hardillb commented Sep 3, 2026

Copy link
Copy Markdown
Contributor

Subflow export should be available on all new tiers. Fleet should have this too.

Fleet is just edge with bulk device pricing, they have identical features

@dgatti0213

Copy link
Copy Markdown
Contributor Author

@hardillb did you want to change something about this PR? I dont think I mentioned anything about tiers in the docs, just what the feature is.

@hardillb

hardillb commented Sep 3, 2026

Copy link
Copy Markdown
Contributor

No, just commenting on the licence availability

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