Troubleshooting

The field didn't move

Work down this list.

Is the plugin enabled? php craft plugin/enable sidepipe. A disabled Sidepipe renders every layout exactly as Craft would, which looks identical to a misconfigured one.

Is the marker in the same tab as the field? A Sidebar element only claims elements in its own tab. It has no effect on any other tab.

Is the marker set to "everything below this marker" with the field above it? Check the marker's settings, or drag the field below it.

Is this an element type with a sidebar? Global sets, tag groups and the user profile screen have editors that never build one, and Sidepipe stands down there rather than making a field disappear. Settings → Plugins → Sidepipe flags those layouts in the "Where it is in use" list. The full table is in usage.md.

Is it a nested Matrix block in blocks view? Those render inline inside the owner's form and have no sidebar of their own, so they're left alone. Switch the Matrix field to cards view — each block then opens in its own element editor, which does have a sidebar — or arrange the nested type without a sidebar tab.

Does the field have a condition that doesn't match? A piped field with an unmet element or user condition is not rendered, same as in the content pane.

The tab is still in the tab bar, but empty

It isn't empty — something in it is still rendering in the content pane. Most likely a field the marker didn't claim because the marker is set to "everything below this marker" and that field is above it.

A piped field's condition doesn't update as I type

Expected. Craft re-renders the content pane on every change and does not re-render the sidebar, so a conditional field in the sidebar settles on the next page load. If a field's visibility has to change under the author's hands, leave it in the content pane.

The sidebar looks cramped, or something is overflowing

Sidepipe renders piped fields full width and lets oversized content scroll inside its own box, but some field types simply need room. Matrix, CKEditor, Redactor and wide tables belong in the content pane.

If a field looks too narrow rather than too wide, check Respect field widths in the settings — with it on, a field the layout gave 25% gets about sixty pixels.

Changes to a piped field aren't saving

They should be: the inputs are the ones Craft's own form would have produced, with the same names, and Sidepipe has no save handler at all. If a piped field isn't saving, an unpiped field in the same layout almost certainly isn't either — the cause is elsewhere.

Worth ruling out: a field that is read-only for this user (Sidepipe renders it static, as the content pane would), and an entry being viewed as a revision.

The marker disappeared from my field layout

Craft drops layout elements whose plugin is disabled or gone. If Sidepipe was disabled and the layout was then re-saved, the marker was dropped from the saved config and has to be added again.

This is why the marker is a separate element rather than a flag on the fields: what's lost is the arrangement, never a field.

The same applies across environments. An environment that has your field layouts but not the plugin will drop the markers the next time those layouts are re-saved there. Install Sidepipe wherever the project config goes.

Something in the control panel broke after installing

Sidepipe swallows and logs its own errors rather than taking an editor down, so a failure shows up as fields not moving and a line in the log, not a stack trace. Check storage/logs/ for entries in the sidepipe category.

If an element type's own editor turns out to do something unexpected, add it to Leave these element types alone in the settings and it will be skipped entirely.

Reporting a bug

https://github.com/justinholtweb/craft-sidepipe/issues. Useful to include: Craft version, the element type, whether the arrangement uses a marker or a tab name, and the relevant sidepipe log lines.