How to share what you built with coworkers (without Slack archaeology)
Short answer: stop pasting screenshots into chat. Keep a one-row-per-workflow catalog, a one-page README next to each workflow, and a short "safe to share" checklist before anyone else presses Run. The sharing problem is usually discovery and trust, not file transfer.
This is a common question in r/automation: builders have working automations and no clean way for teammates to find or reuse them.
The three pieces
| Piece | Lives where | Purpose |
|---|---|---|
| Catalog | Sheet / Notion / Airtable | Searchable index: name, owner, trigger, systems touched, link, status |
| README | Same folder / workflow sticky / doc page | How to run, what it changes, how to stop it |
| Handoff check | 5-minute review | Credentials, test mode, idempotency, who gets alerted |
1. Catalog columns that actually get used
Minimum useful columns:
- Name — human title, not the internal id.
- Owner — one person on the hook.
- Trigger — cron, webhook, form, manual.
- Systems — Gmail, Sheets, CRM, Slack, …
- Link — n8n workflow URL, Make scenario URL, or repo path.
-
Status —
draft/pilot/production. - Last verified — date someone ran it successfully on purpose.
Anything else (ROI, screenshots, long essays) can wait. If the catalog is painful to update, people will ignore it.
2. One-page README template
Paste this into an n8n Sticky Note, a Make note, or a markdown file next to the export:
# <Workflow name>
Owner: <name> | Status: draft|pilot|production
Trigger: <cron / webhook / manual>
What it changes: <list side effects>
What it does NOT do: <boundaries>
How to test safely: <test inbox / dry-run flag / sample sheet>
How to stop it: <deactivate / pause / kill switch>
Alerts go to: <channel or email>
Last verified: <YYYY-MM-DD>
If a coworker cannot answer "what does this change?" from that page alone, it is not shareable yet.
3. Safe-to-share checklist (before you hand over Run)
- [ ] Credentials are team-owned (or clearly personal and not required for the demo).
- [ ] Side effects hit a test inbox, sheet, or CRM sandbox first.
- [ ] Retries cannot double-create (idempotency key or "already exists" guard).
- [ ] There is an obvious off switch.
- [ ] Failure alerts go somewhere a human looks.
- [ ] Catalog row and README are updated the same day.
This is the same reliability mindset as silent-failure watchdogs and approval queues — sharing multiplies mistakes unless those guards exist.
Ways to share the actual workflow
| Method | Good when | Watch out for |
|---|---|---|
| Invite teammate into the same n8n/Make workspace | Day-to-day ops | Overwrite risk; use naming + status |
| Export JSON / Make blueprint | Handoff, backup, Git | Secrets may be stripped or embedded — review before sending |
| Screen recording + catalog link | Training | Goes stale; always pair with README |
| Internal template gallery | Agency with many repeats | Needs an owner to curate or it rots |
On n8n, inviting a teammate to a workflow is built in on Cloud (every plan) and on self-hosted Business or Enterprise (n8n sharing docs). On Community self-hosted, export the workflow as JSON or give them access to the same instance instead. Review exports before you send them: n8n's docs note that JSON can include credential names and IDs, and HTTP Request nodes may still carry auth headers from a cURL import.
A tiny "publish to catalog" automation
When a workflow moves to pilot or production, have a button or short scenario that:
- Reads name, owner, trigger, systems from a form or sticky fields.
- Upserts one row in the catalog (key = workflow id).
- Posts a short message to the team channel with the catalog link — not the full JSON.
You can build that button in n8n or in Make. If your team already thinks in visual scenarios, Make's free tier is enough for the catalog upsert + Slack notify path: Make free plan.
Common failure modes
- Sharing the JSON and nothing else. Teammates import it, it fails on missing credentials, and they never trust automation again.
- One hero owns every production scenario. Vacation = outage. Put a backup owner on the catalog row.
-
No status field. People rerun
draftworkflows against live customers. - Catalog in six places. Pick one source of truth.
Bottom line
Coworkers do not need your entire brain dump. They need a searchable catalog, a one-page README, and proof the workflow is safe to touch. Build those three once; every new automation reuses the same pattern.
Disclosure: Some links are affiliate links — I may earn a commission at no extra cost to you.
Top comments (0)