---
title: Authoring Your Workflows
slug: authoring-your-workflows
docTags: 
createdAt: 2026-01-23T14:00:54.252Z
---

## Overview

There are three ways to author new workflows on Floyo: start from scratch in the canvas, modify an existing workflow, or upload directly to the community page.

***

## Method 1: Start from the Floyo App Canvas

![](https://images.archbee.com/Ix6MAQhJVD3YU-KVJRd4T-S2EH-T3zZqgwB7ju4VBjk-20250830-144441.jpg?format=webp)

Build a workflow from scratch or import your own JSON file.

### Option A: Create a Blank Canvas

![](https://images.archbee.com/1hT0XoAHMhU4co8ZZjygd/FnmM4S1ByuhcPsCHz-6LG_image.png?format=webp?format=webp)

1. Click **Launch App** to open the canvas
2. Ctrl/Cmd + A to select all nodes
3. Press **Delete** on your keyboard to get a blank page
4. Start adding nodes to build your workflow

### Option B: Drag and Drop a Workflow

::embed[]{url="https://vimeo.com/1114945334?share=copy"}

1. Click **Launch App** to open the canvas
2. Drag and drop your workflow JSON file onto the canvas
3. The workflow replaces whatever was previously loaded

:::BlockQuote
**💡 Tip:** If your workflow contains custom nodes not currently installed in Floyo, the team will be notified. Most nodes are installed within 72 hours.
:::

### After Building

1. **Run your workflow** — Only workflows that have run successfully within the app can be published and verified ✅
2. **Publish** — Once successful, the publish button becomes active

***

## Method 2: Modify an Existing Workflow

![](https://images.archbee.com/Ix6MAQhJVD3YU-KVJRd4T-9mdfjiSKeNG9qi31kKFSr-20250830-142418.jpg?format=webp)

Start from a community workflow and customize it.

### Steps

1. **Launch any Verified ✅ workflow** — Verified workflows have a checkmark, and the creators have completed the process to confirm that the workflow can run successfully
2. **Make any customizations** — Change parameters, update architecture, add nodes, add functionality, and more
3. **Run your workflow** — Only workflows that have run successfully can be published and verified ✅
4. **Publish** — Your modified version becomes a new workflow

:::BlockQuote
**⚠️ Note:** A new workflow will not be monetized if it is sufficiently similar to its original.
:::

***

## Method 3: Add Your Workflow Directly to the Community Page

Upload a workflow without running it in the canvas first.

### Steps

1. Go to the **community page**
2. Click the **Add workflow** button

![](https://api.archbee.com/api/optimize/1hT0XoAHMhU4co8ZZjygd/oLOUp_8qdgapqZEl71dzh_image.png)

3. **Complete the requested info:**
   - Name your workflow, add overview
   - Upload your JSON file

![](https://api.archbee.com/api/optimize/1hT0XoAHMhU4co8ZZjygd/hH5olL3fqJij1sOk4UFJk_image.png)

:::Paragraph{listStyleType="disc" indent="2"}
Provide thumbnails and metadata
:::

![](https://api.archbee.com/api/optimize/1hT0XoAHMhU4co8ZZjygd/zJThtEuwclJK5LzZ0GIZO_image.png)

:::Paragraph{listStyleType="disc" indent="2"}
Document the capabilities and functionalities
:::

![](https://api.archbee.com/api/optimize/1hT0XoAHMhU4co8ZZjygd/UetSSqAk1PAGGfjNamrfU_image.png)

4. Click **Add Workflow** to finish
5. Click **Open Workflow** on your published workflow detail page
6. **Run your workflow to verify it** — Now that the app canvas has loaded, run your workflow. Only workflows that have run successfully can be verified ✅

:::BlockQuote
**💡 Tip:** Your workflow won't be verified until it runs successfully in the app.
:::

***

## Comparison

| Method                 | Best For                            | Verification               |
| ---------------------- | ----------------------------------- | -------------------------- |
| **Start from scratch** | Building new workflows              | Run first, then publish    |
| **Modify existing**    | Customizing proven workflows        | Run first, then publish    |
| **Upload directly**    | Quick publishing of ready workflows | Publish first, then verify |

***

## Tips & Best Practices

- **Test thoroughly:** Run your workflow multiple times to ensure it works consistently
- **Document well:** Add clear descriptions and thumbnails
- **Check custom nodes:** Verify all nodes are installed before publishing
- **Start with verified workflows:** When modifying, use verified workflows as your base

***

## Troubleshooting

### Workflow won't run after importing?

**Solution:** You may be missing custom nodes. Wait 24-72 hours for automatic installation, or request them directly.

### Can't publish my workflow?

**Solution:** You must run the workflow successfully at least once before publishing.

### Modified workflow not monetizable?

**Solution:** If your modifications are too similar to the original, it won't qualify for monetization. Make substantial changes to create a unique workflow.

***

## Related Documentation

- [Publishing Workflows](https://docs.floyo.ai/public-vs-private-publishing)
- [Running Workflows](https://docs.floyo.ai/running-workflows)
- [Requesting Custom Nodes](https://docs.floyo.ai/requesting-custom-nodes)