Experimental features

Paperclip ships some features behind opt-in flags before they become default behavior. They're real, working features — you can turn them on today — but they're still being evaluated against real usage, so they live on a dedicated Experimental settings page instead of being on for everyone.

This section has one page per experimental feature: why it exists, how to turn it on, and how to use it.

What "experimental" means

An experimental feature in Paperclip:

• Has shipped and works. These aren't stubs — each flag gates a complete surface.
• Is opt-in. Everything stays hidden until you flip the flag, so the UI stays out of your way if you don't use it.
• Comes with no compatibility guarantees. The app puts it plainly when you open the page: "Experimental features may break at any time. These features are opt-in and come with no compatibility guarantees. They may change, break, or be removed without notice. Avoid relying on them for critical or production workflows."

Turning a flag on is not dangerous in the "this will corrupt your data" sense, and flipping one back off is always safe — features are hidden, not deleted, and any data they created is kept. But don't build a workflow that has to stay stable on top of one, and expect to re-read the release notes after an upgrade: experimental features may be renamed, reworked, promoted to core settings, or retired between releases.

Turning a feature on

All experimental flags live in one place, and they're instance-wide (they apply to every company on your Paperclip instance):

1. Open Settings → Instance settings → Experimental.
2. Find the feature's card and flip its toggle.

Changes take effect immediately — no restart, no migration. Each feature page in this section repeats the exact toggle name to look for.

If a toggle is locked

On an instance managed by Paperclip Cloud, some of these features are decided for you. Open the Experimental page there and you'll see a small lock badge reading Managed by Paperclip Cloud next to the feature's name, and its toggle greyed out — the switch still shows you whether the feature is on or off, you just can't move it. Clicking it does nothing.

That's not a permission problem with your account. Paperclip Cloud sets those values for the fleet your instance runs in, and the app re-applies them every time it reads the settings, so the answer can't drift — nothing you or anyone else does inside the instance changes a managed value. If you need one of these features turned on or off, that's a change on the Paperclip Cloud side rather than something you flip on this page.

Only some features are managed this way. Anything without the badge is still yours to turn on and off exactly as described above, and the two kinds sit side by side in the same list — so the badge is what tells you which is which, on any given release.

Self-hosted instances are unaffected. If you run Paperclip yourself, there is no managed configuration, no lock badge, and every card on the page stays editable. What makes the difference is a single environment variable, PAPERCLIP_MANAGED_CONFIG, which only the Paperclip Cloud harness sets.

The features

Where to go next

• Instance settings — the rest of the instance-level settings pages, including where the Experimental page sits.