koira
workflow automationbrowser automationno-code automation

Show It Once: How Click-Through Training Actually Works

KOIRA Team9 min read1,950 words
Browser screen showing click-through workflow training session with semantic element highlights and step capture panel
Intro
Breakdown
Solution
FAQ
◆ Key takeaways
  • Click-through training captures intent, not just pixel coordinates — which is why it survives page redesigns that would break a macro.
  • The system records semantic signals (element roles, labels, context) rather than raw screen positions, making replays robust across browsers and screen sizes.
  • A single demonstration is enough to define the workflow; the software infers the repeating pattern and applies it to future inputs automatically.
  • Self-healing is a consequence of intent-based capture: when a site changes its layout, the workflow re-anchors to the same semantic element rather than failing at a dead coordinate.
  • The approval queue is the trust bridge — early runs surface for human review so you can confirm the workflow is doing what you demonstrated before it runs unsupervised.
  • Plain-English description can replace or supplement clicking for steps that are hard to demonstrate live, like conditional logic or timing rules.

The Question Nobody Asks Before They Automate

Most owner-operators who discover they can "train" software by clicking through a website assume it works like a screen recorder — capture the clicks, play them back, done. That assumption is wrong, and the gap between what they think is happening and what's actually happening explains why some automations run for months without breaking while others fall apart the first time a vendor updates their portal.

So let's be precise about what click-through training actually does.


What Gets Captured During a Training Session

When you demonstrate a task by clicking through it live, the software isn't saving a video of your screen. It's building a structured log of semantic actions — a description of what you did and why, not just where your cursor moved.

For each step, the system captures roughly:

  • The element you interacted with — not its pixel position, but its identity: its HTML role (button, input, select), its accessible label or aria attribute, its position in the document hierarchy, and any visible text associated with it.
  • The action you performed — click, type, select, scroll, wait, extract.
  • The data involved — what you typed, what you selected, what value you read off the page.
  • The context — what URL you were on, what state the page was in before and after the action.

This is the fundamental difference between a macro and a trained workflow. A macro says: "click at coordinate (847, 312)." A trained workflow says: "click the button labeled 'Submit Order' inside the checkout form on this domain." When the page redesigns and the button moves to coordinate (912, 288), the macro breaks. The trained workflow finds the button by its label and role, not its position, and keeps running.


The Demonstration Loop: Show Once, Run Forever

Here's the practical sequence of what happens when you train a workflow:

Step 1 — You open the recording session. The software attaches to your browser tab and starts listening. You perform the task exactly as you normally would: log into a supplier portal, pull the latest inventory numbers, paste them into your own spreadsheet, confirm the sync. Nothing about your behavior changes — you're just doing the work while the system watches.

Step 2 — The system logs the action graph. Every meaningful interaction is recorded as a node in a directed graph. The edges represent sequence and dependency: step B only runs after step A completes and the page reaches a certain state.

Step 3 — You finish the demonstration and review the captured steps. Most systems surface a plain-English summary of what they recorded: "Navigate to portal.supplier.com, log in using stored credentials, click 'Inventory Report', download the CSV, open the target spreadsheet, paste values into column B starting at row 2." You can edit any step, flag conditions ("only run if the report shows a value under 50 units"), or add plain-English instructions for steps you couldn't demonstrate live.

Step 4 — The workflow is compiled. The action graph is translated into a durable representation that can be executed by a headless browser — a browser that runs invisibly in the background, without a screen, on a server. This is what "runs on any website without needing an API" actually means: the software is operating the website through its own interface, the same way a human would, rather than calling a hidden backend endpoint.

Step 5 — Early runs go to an approval queue. The first few executions are surfaced for your review before any output is committed. You see what the workflow did, what data it touched, what it produced. If something looks off, you correct it. Once you're confident, you can let it run unsupervised on a schedule.


Why "Intent" Is the Right Word

The phrase that clarifies this best is training by demonstration — a concept borrowed from robotics, where you physically guide a robot arm through a motion rather than programming the coordinates manually. The robot doesn't memorize the exact path; it extracts the goal of the motion and generalizes it.

Click-through workflow training works the same way. When you demonstrate "download the weekly sales report from this portal," the system doesn't memorize that you clicked a link at a specific position on a specific day. It understands that there's a link associated with the concept of a weekly sales report, and it will find and click that link on future visits even if the page has been redesigned, the link has moved, or the portal has updated its navigation structure.

Training by clicking is not recording what you did — it's teaching the software what you were trying to accomplish.

This is why self-healing is possible. When a site changes, the workflow doesn't fail silently at a dead coordinate. It re-examines the page, finds the element that best matches the semantic description it was trained on, and re-anchors. If it genuinely can't find a match, it surfaces an alert rather than proceeding with bad data.


What Plain-English Instructions Add

Not everything is easy to demonstrate by clicking. Conditional logic is the obvious case: "only run this step if the quantity field shows less than 20" is hard to show in a single demonstration where the quantity happens to be 47.

This is where plain-English instruction supplements the click-through recording. You can add a condition in natural language — "skip the reorder step if the current stock level is above the reorder threshold" — and the system interprets it into a conditional branch in the workflow graph. The combination of demonstrated steps (for the mechanical sequence) and described rules (for the logic) produces a workflow that's both precise and flexible.

For many tasks, you don't need to click through at all. If the task is simple enough to describe fully — "every Monday morning, go to this URL, log in, find the pending invoices table, and send me a summary by email" — you can train the workflow entirely in plain English and skip the demonstration. The click-through option exists for tasks where showing is faster than describing, not because it's the only input method.


How This Compares to What You're Probably Already Using

If you've used Zapier, you're used to connecting APIs — one app sends a trigger event, another app receives it and takes an action. That works well when both apps have APIs and the trigger/action you need is in the connector library. It breaks down completely when the website you need to automate has no API, or when the specific action you need isn't exposed in the connector.

If you've used traditional RPA tools (UiPath, Automation Anywhere, or even simple browser macros), you're familiar with the fragility problem. Those tools record at the pixel or DOM-path level. A site update that moves a button three pixels or renames a CSS class breaks the automation, and fixing it requires re-recording or manual scripting.

Click-through training with intent-based capture sits in a different category. It doesn't need an API because it operates the website directly. It doesn't break on layout changes because it's anchored to semantic identity, not position. And it doesn't require you to write or maintain code — the demonstration IS the programming.


The Practical Limits You Should Know

This approach isn't magic, and being clear about its limits makes it more useful:

CAPTCHAs and MFA. Workflows can be paused at authentication steps that require human input — a CAPTCHA solve or a two-factor code. The practical solution is to use session persistence (the workflow logs in once and maintains the session) or to route MFA codes through an accessible inbox the workflow can read.

Highly dynamic UIs. Pages that render heavily via JavaScript and vary their structure based on real-time data can be harder to anchor reliably. The semantic capture still works, but you may need to train on a few variations of the page state to cover edge cases.

Tasks that require judgment. If the next step depends on information that requires a human decision — not a rule, but actual judgment — the right answer is an approval gate, not full automation. Knowing when to gate and when to let it run is a separate skill from training the workflow itself.

Data that isn't visible on the page. The workflow can only read and interact with what's rendered in the browser. If the data you need lives in a PDF that requires interpretation, or behind a login the workflow can't reach, that step needs a different solution.


What the Approval Queue Is Actually For

New automators often treat the approval queue as an obstacle — extra clicks between them and full automation. It's the opposite. The approval queue is the mechanism that lets you trust the workflow before you hand it the wheel.

Think of it like a new hire's first week. You don't give a new employee unsupervised access to your payment system on day one. You watch what they do, correct mistakes, and expand their autonomy as they demonstrate they understand the task. The approval queue is that first week — compressed into a few review cycles rather than five business days.

Once you've reviewed several runs and confirmed the workflow is doing exactly what you demonstrated, you flip it to unsupervised. At that point, the only thing that surfaces is an alert if the workflow encounters something it doesn't recognize — a page state it wasn't trained on, a missing element, an unexpected error. Everything else runs silently in the background while you do other work.

This is what self-driving software actually means in practice: not that the software is autonomous from day one, but that it earns autonomy through demonstrated accuracy, with a human available to correct it until that trust is established.


The One-Time Cost vs. the Ongoing Return

The training session for a typical workflow takes 5–15 minutes. You perform the task once, review the captured steps, add any conditional rules, and run a few supervised executions. After that, the workflow runs on whatever schedule you set — daily, hourly, triggered by an event — without your involvement.

For a task that previously took 20 minutes a day, that's roughly 100 hours recovered per year from a single 15-minute training session. For a task that was getting skipped because nobody had time for it — a follow-up email cadence, a daily inventory check, a weekly report pull — the return is harder to quantify but often more significant: the task actually gets done, consistently, without depending on someone remembering to do it.

The click-through training model exists because the bottleneck was never compute — it was the cost of describing the task precisely enough for software to execute it. Demonstration solves that. You already know how to do the task. Doing it once in front of the software is the entire programming step.

Training by clicking is not recording what you did — it's teaching the software what you were trying to accomplish.

Save this for later
Get a PDF copy of this post →
Drop your email, we’ll send you the full piece as a clean PDF. Plus the weekly KOIRA roundup.
Title: What Happens When You Train a Workflow by Clicking
Click-through workflow training
A method of programming automation software by demonstrating a task live in a browser, allowing the system to capture the intent behind each action rather than recording raw screen coordinates.
Intent-based capture
Recording automation steps as semantic descriptions of element roles, labels, and context — rather than pixel positions — so the workflow remains valid even when a website's layout changes.
Self-healing workflow
An automated workflow that re-anchors to the correct page element after a site redesign by matching semantic descriptions rather than failing at a stale coordinate or DOM path.
Approval queue
A review mechanism that surfaces early workflow runs for human inspection before outputs are committed, allowing the operator to verify accuracy and build trust before enabling unsupervised execution.
Training by demonstration
An automation paradigm where the user performs a task once in the live environment and the software infers a generalizable, repeatable workflow from that single observed execution.
Click-Through Workflow Training vs. Traditional Macro Recording
AreaMacro / Screen RecordingClick-Through Workflow Training
What gets capturedPixel coordinates and raw DOM paths at the moment of recordingSemantic element identity: role, label, context, and action intent
Resilience to site changesBreaks when layout updates move an element even a few pixelsSelf-heals by re-anchoring to the same semantic element after redesigns
Setup requirementMust re-record or manually edit scripts whenever the target site changesTrained once; adapts automatically to most layout and structure changes
Conditional logicRequires scripting in a programming language or proprietary macro syntaxAdded in plain English alongside the demonstrated steps
API dependencySome tools require an API or connector for each target siteOperates the website through its own interface — no API needed
Human oversightRuns silently with no built-in review mechanism; errors often go unnoticedApproval queue surfaces early runs for review; alerts fire on unrecognized states

How to Train a Workflow by Clicking Through a Website

  1. 01
    Identify the exact task you want to automate. Before opening a recording session, write out the task in plain English from start to finish — including the URL, the login step, every click, every piece of data you read or enter, and where the output goes. Ambiguity in the task definition becomes ambiguity in the trained workflow.
  2. 02
    Open a recording session and navigate to the starting URL. Attach the software to your browser tab and navigate to the page where the task begins. The system starts listening the moment you confirm the session is active — you don't need to do anything special to signal the start.
  3. 03
    Perform the task exactly as you normally would. Click, type, select, scroll, and extract data at your normal pace. Don't try to move slowly or make exaggerated gestures — the system is capturing semantic actions, not timing, so natural behavior produces the cleanest training signal.
  4. 04
    Review the captured step summary and add conditional rules. After completing the demonstration, review the plain-English summary of what was recorded. Correct any steps that were misinterpreted, and add any conditional logic — "only proceed if the value is below X," "skip this step on weekends" — in natural language.
  5. 05
    Run two or three supervised executions through the approval queue. Trigger the workflow and review each output before it's committed. Confirm that the data extracted matches what you'd expect, that the actions taken are correct, and that any edge cases you can anticipate are handled properly.
  6. 06
    Correct any mismatches and re-run. If a step produced the wrong output, edit that step's description or re-demonstrate it. Most corrections take under two minutes — you're adjusting a natural-language description, not rewriting code.
  7. 07
    Set the schedule and disable the approval queue. Once you're confident the workflow is accurate, set it to run on your desired schedule — hourly, daily, triggered by an event — and turn off mandatory approval. The workflow now runs silently, surfacing alerts only if it encounters a page state it wasn't trained on.
FAQ
Is click-through workflow training the same as recording a macro?
No — and the difference matters a lot in practice. Macro recording saves the literal coordinates and DOM paths of your interactions, so when a website updates its layout, the macro breaks. Click-through workflow training captures semantic intent: the role, label, and context of each element you interact with. This means the workflow can re-anchor to the same element even after a page redesign, rather than failing at a dead pixel coordinate.
How long does it take to train a workflow by clicking through a website?
Most workflows take 5–15 minutes to demonstrate. You perform the task once at normal speed while the system records, then spend a few minutes reviewing the captured steps and adding any conditional rules you couldn't demonstrate live. After two or three supervised runs through the approval queue, the workflow is ready to run unsupervised on a schedule.
What happens when the website changes after I've trained the workflow?
Because the workflow is anchored to semantic element descriptions rather than pixel positions, it can often adapt automatically — this is called self-healing. The software re-examines the updated page, finds the element that best matches the trained description (by label, role, and context), and re-anchors. If it genuinely can't find a match, it surfaces an alert rather than proceeding with incorrect data.
Do I have to click through the task to train it, or can I just describe it in words?
Both options work, and they're often combined. For mechanical sequences — navigate here, click this, fill in that — demonstration by clicking is usually faster than writing it out. For conditional logic, timing rules, or edge cases that are hard to show in a single run, plain-English instructions fill the gap. Some simple tasks can be trained entirely by description without any clicking at all.
Why does the approval queue exist if the workflow was trained correctly?
The approval queue lets you verify that the software interpreted your demonstration accurately before it runs unsupervised at scale. Even a correctly-trained workflow might handle an edge case differently than you'd expect — a page state you didn't demonstrate, a data value outside the range you showed. A few supervised review cycles let you catch and correct those cases before the workflow has autonomy over real data. Once you're confident, you disable the queue and the workflow runs silently.
Can a click-through trained workflow handle websites that require login?
Yes. Credentials are stored separately from the workflow definition and injected at the authentication step during each run. Most workflows use session persistence — the software logs in once and maintains the session across subsequent steps — so you're not re-authenticating on every execution. For sites with two-factor authentication, the workflow can be configured to pause at the MFA step and wait for a code routed through an accessible inbox.
Find KOIRA on
XLinkedInFacebookCrunchbaseWellfoundF6S
Keep reading
Product
Autonomous Mode: What It Is and When to Turn It On
9 min read
Product
Why Every Business Function Needs a Human in the Loop
9 min read
Product
Self-Driving Work vs RPA: What's Actually Different
9 min read
Product
L4 vs L5 Autonomy: When to Gate, When to Let It Run
9 min read
Stay in the loop
New posts, straight to your inbox.
Marketing and sales insights from the KOIRA team. No filler.
What Happens When You Train a Workflow by Clicking
Get KOIRA