Publish a Pipeline as a Web Form
Let anyone with a Salt login run a Pipeline through a Web Form without Pipeline Builder access.
Publishing a Pipeline as a web form creates a shareable page where someone can fill in a form, run the Pipeline, and download the results, without opening the editor. You control the page's headline, description, and button text, and which inputs and outputs are visible.
Prerequisites
Your Pipeline's latest run must complete successfully, and its discovered contract must contain at least one configured output. Salt discovers the form's fields from that run's Input and Output nodes. The output requirement is specific to Web Forms; publishing as an Agentic Tool or API does not require a configured output.
The publish button stays disabled while any requirement is missing:
- No successful run yet — "Run your pipeline first"
- Last run failed — "Successful run required"
- No outputs configured — "No outputs configured"
Publish the pipeline as a web form
Open the Publish page
With the Pipeline open in the editor, click Publish in the header. If Web Form publishing is enabled, select the Web Form surface button on the Publish page.
Fill in the page details
Under Page Details, set three fields:
- Headline — the page's title, shown to end users. Defaults to the Pipeline's name, up to 80 characters.
- Description — a sentence explaining what the form does, up to 1500 characters. Defaults to "Try out the pipeline I built with salt.ai"
- Button Label — the text on the run button, up to 80 characters. Defaults to "Run"
All three fields are required. A live, dimmed preview of the actual form updates on the right as you type.
Configure inputs and outputs
Under Inputs and Outputs, each input and output from your Pipeline gets its own row. Use the eye icon to show or hide it on the form — hidden items are marked "Hidden from users" and dropped from what end users see entirely.
For each visible input, you can set a Label (what end users see instead of the raw node name), a Default Value, and whether it's a Required field. For each visible output, you can set only a Label.
Publish
Click Publish Webform. After the first publication, this button reads Publish Changes, and a Live URL row appears above Page Details with the form's link and buttons to copy or open it.
What end users see
The published page shows your Headline as the title, your Description underneath it, and a run button with your Button Label text (it reads "Running..." while an execution is in progress). Below that, a left column lists the visible inputs — each rendered as a single-line field or, for longer default values, a multi-line text area — and a right column shows outputs once the run completes, each downloadable individually.
If every input is hidden, the left column reads "This pipeline has no inputs". The page ends with a "Powered by Salt AI" footer.
Submitting the form starts an execution and polls for its status. After the run reaches a terminal state, the page fetches and displays the output artifacts. If someone opens a link to a form that no longer exists, they see a "Webform not found" message and are redirected away.
A web form link is not anonymous or fully public. Anyone who opens it must be logged into Salt, but that check isn't scoped to your organization — any authenticated Salt user who has the link, from any organization, can view and run the form.
Managing a published web form
After a run uses a different Pipeline version from the published deployment, the Publish page shows a "Changes detected" warning until you republish. There's no pause or disable control for a live Web Form; your options are to republish with Publish Changes or delete it with Delete. The confirmation dialog is titled Delete web form?, and its confirmation button reads Delete web form.