Webly
WeblyDocs

Branches

Try a change on its own copy of the site, preview it at its own address, then merge it into main.

A branch is a named copy of your site beside main, the line your draft and live site come from. Changes on a branch don't touch main or the live site until you merge them. Use one for a bigger or riskier change you want to see first, or when several agents work on the same site at once (one branch each).

Its own address

Every branch has a preview at https://{branch}--{subdomain}.webly.site. Like the draft, it isn't indexed and isn't the public site. Share it with anyone who should look at the change.

Working on a branch

  • In the dashboard, pick a branch in the site header or the editor, or choose New branch and give it a name (lowercase letters, numbers and hyphens). Edits and saves then go to that branch, and History shows that branch's versions.
  • With an agent, ask it to work on a branch. It creates one with create_branch, passes the branch's name to every read and write, and gives you the branch's address to preview.

Merging

When the branch looks right, choose Merge into main (agents use merge_branch). Webly combines the branch's changes with anything main changed since, saves the result as a new draft version on main, and closes the branch.

Merging is not publishing. The live site stays as it is until you publish. In the dashboard you can tick Publish after merging; an agent asks you first before it publishes a merge. If the merged version is still building (or its build failed), the merge is saved but not live yet; publish it once it's ready.

If main and the branch changed the same lines, nothing is saved and you see the files and lines that clash. Choose Update from main (agents use update_branch): main's other changes come into the branch, and the clashing files keep the branch's version and are listed for you. Fix those files on the branch, then merge again.

To drop a branch without merging, delete it. Its versions stay in History.

How many

Branches are for signed-in sites on every plan, Free included. Each site can have up to 2 open branches on Free, 8 on Hobby and 20 on Pro, plus main. Merging or deleting a branch frees its slot. A site published without an account needs a Webly account first: claim it (sign in, free) and activate it, then create the branch. Shared files don't have branches.

Git

In the site's read-only git copy, each open branch is its own git branch next to main.