See the complete route index at https://crusible.dev/llms.txt before following links.

# Switch a surface's provider

How a surface comes to point at a connected tool instead of Crusible's own store, or back again, without touching the channel or its conversation.

<!-- https://crusible.dev/docs/admin/switch-a-surfaces-provider/ · doctype: how-to · role: admin · reviewed: 2026-09-05 -->


A <a class="docs-term" href="/docs/reference/glossary/#surface">surface</a> is backed either by
Crusible's own store or by a
<a class="docs-term" href="/docs/reference/glossary/#connected">connected</a> tool, and either direction
is the same action. A team that keeps its issues in Linear points Issues at
Linear, and a team that would rather keep them beside the conversation points
Issues back at Crusible. Neither is a step up from the other.

The control is a tool's row in **Integrations**, which is workspace-level, so
what switches is every surface that tool backs. Most tools back one: Linear
backs Issues, Notion backs Docs, Sentry backs Dashboards. GitHub and GitLab
each back two — Forge and Review — and switching either moves both.

**Planned.** The **Integrations** pane carries no rows yet: it
opens on a blurred picture of the pane, the sentence
“Connect GitHub, Linear, Slack and the rest, and keep their keys in one place.”
and a disabled **Coming soon** control.
 The rows
the switch is made on are the rows below, and none of them can be reached
today.


1. <p>Select <strong>Settings</strong>, then, under <strong>Account</strong>, open <strong>Integrations</strong>.</p>
 (Result: The pane lists every tool the workspace can connect, with the connected ones reading “Connected” under the account they were authorised as. This one pane holds both directions of the switch, for every surface the tool backs.)


1. <p>Find the surface you are switching, by the tool that backs it now and the tool
you want backing it next, and check whether either tool backs a second surface
you did not mean to move.</p>
 (Result: Each row's one-line description names what it backs. A surface is backed by one provider at a time, so the row you are switching to is the row that holds the record afterwards.)


1. <p>Select <strong>Connect</strong> on the tool you are switching to, and authorise it — or
select <strong>Disconnect</strong> on the tool you are leaving.</p>
 (Result: Switching to a connected tool: the row reads “Connected”, names the account, and the surface reads from the tool from then on. Switching back to Crusible: the row loses its “Connected” state, and the surface reads from Crusible's own store from then on.)


1. <p>Open a channel that has the surface enabled and select it in the surface
switcher.</p>
 (Result: Every surface that tool backs changes, and nothing else does. The channel keeps its name, its members, its agents, its other surfaces and its whole conversation. Work already recorded in the tool you left stays in that tool, where it was recorded, under the account that recorded it — so a surface pointed back at Crusible reads Crusible's own store, which holds none of that work.)


- **If this doesn't work:** <p>If <strong>Account</strong> does not appear in Settings, or <strong>Integrations</strong> is missing from
it, your sign-in does not hold the permission that opens it: a pane you may not
open is absent rather than shown and disabled, so ask whoever created the
workspace to grant it. If the surface still shows the old data, the surface is
reading a provider that is still connected — read the <strong>Integrations</strong> rows
again and confirm the one you meant to leave no longer reads <strong>Connected</strong>. If
a second surface changed too, that tool backs both of them, which is what the
row does rather than a fault. If the surface shows nothing after a switch, the
account you authorised may not be able to see the project or repository you
expected on the tool&rsquo;s side. If the channel itself looks different, something
other than this switch changed it: the channel&rsquo;s name, members, agents and
conversation are set in the channel&rsquo;s own settings. If a step still does not
match what you see,
<a href="/docs/troubleshooting/">Troubleshooting</a>
 is written for that moment.</p>





Each surface the tool backs then answers to the provider you chose, and the
**Integrations** pane says which. What does not change is everything else: the
channel, its members, its agents, its other surfaces, and the conversation that
holds the work. The same steps run in the other direction the day the team
wants them to.

- [Connect a provider](https://crusible.dev/docs/admin/connect-a-provider/) — Where an outside tool is connected to the surface it backs, how it is authorised, and what settles the writes agents may make to it.- [Every surface has a provider](https://crusible.dev/docs/concepts/every-surface-has-a-provider/) — Behind every surface is a provider that holds its data, and connecting a tool you already use changes one surface and nothing else in your workspace.

