Skip to content

Migrating to v3

How Spaces, groups, and collections fit together

Section titled “How Spaces, groups, and collections fit together”

Access always stays inside a single Space. Your group memberships in a Space decide which of that Space’s collections you can see, and you attach those collections to a chat to use them as context. Nothing crosses a Space boundary — a group in one Space can never grant access to a collection in another, and the same group name in two Spaces means two entirely separate groups.

Diagram

In this example, Nico is a member of Group Y in Space A and Group Z in Space B:

  • In Space A, he sees Collections 2 and 3, because Group Y has access to them. Collection 1 is only shared with Group X — which Nico is not in — so he cannot see it.
  • In Space B, he sees only Collection 4, because Group Z has access to it. Collection 5 is not shared with any group, so no one reaches it through a group.
  • Access never crosses Spaces. Group Z can never be granted access to Collections 1–3, and vice versa. Dashed items are the ones Nico cannot access.

New: assistants, collections, and prompt templates in every Space

Section titled “New: assistants, collections, and prompt templates in every Space”

Previously, assistants, collections, and prompt templates were only available in My Space. With v3, every Space has its own. You can create them directly in the respective Space and combine them with the Space’s data. The workspace view always shows only the elements of the currently selected Space.

New: “{Space Name} - General” collection

Section titled “New: “{Space Name} - General” collection”

Each Space with pre-existing synced data (e.g. from Confluence or S3 AutoSync) gets a special “{Space Name} - General” collection. It contains all the data that was in the Space before the update. Previously this data was automatically available as context; now you need to attach the collection explicitly via # or the + icon.

Since assistants can now be created in the Space, you can also attach this collection to an assistant. This means assistants can access synced Space data for the first time.

Space-level data sync continues to operate as before; only the delivery side changed.

AutoSync (Confluence, S3, etc.) can now also be pointed at other collections in the same Space, not just the default “{Space Name} - General” collection. This lets you organize synced data into separate, topic-specific collections within a Space.

BeforeAfter
Workspace items (collections, assistants, prompt templates)Only in My SpaceIn every Space; each Space has its own isolated set
Item portability between SpacesN/A (only My Space had them)Items don’t cross Space boundaries, only through migration
RAG / Confluence-synced dataAuto-loaded as context on Space switchMust be manually attached via # and the {Space Name} - General collection
File upload (drag & drop)Only in My SpaceAvailable in all Spaces
GroupsOne group per Space synced into My Space (so you saw membership there)Synced into both My Space and the respective Space
Group identitySame group name → same group everywhereSame group name in different Spaces = different groups, with different permissions
  • Your chats are untouched. Chat history is preserved as-is; the chat list shows chats from all Spaces mixed together. Opening a chat automatically switches the active Space to the one the chat belongs to.
  • You can now upload files in any Space, not just My Space.
  • You can now create assistants, collections, and prompt templates in any Space. They stay in the Space where you create them and won’t follow you across Spaces.
  • If you used an assistant in My Space and want it in another Space, you’ll need to recreate it there — or use the migration tooling once we release it. Same for collections and prompt templates.
  • In Spaces with synced data (e.g. Confluence), RAG content no longer attaches automatically. In each new chat, add the relevant collections (e.g. {Space Name} - General) via # or the + icon to make the synced data available as context.
  • Sharing is per Space. A workspace item shared in one Space isn’t visible in another, even if both Spaces have a group with the same name. Items don’t move between Spaces; sharing applies only within the Space they live in.
  • Groups are now scoped per Space. A group with the same name in two Spaces is treated as two completely separate groups, each with its own membership and permissions. Sharing config you set in Space A does not apply in Space B, even if both have a group called engineering.
  • A user can be in groups of the same name in multiple Spaces and have different permissions in each — the permissions you see depend on the active Space.
  • Groups are synced into both My Space and the respective Space. The previous behavior (sync only into My Space) has been extended; groups now also appear in the Space they belong to.

Review your sharing config (which groups can see which workspace items) in each Space you own — sharing rules are now scoped per Space and need to be set up there.

  • Login, SSO, and user accounts
  • Chat history (preserved across the migration; mixed view across all Spaces in the sidebar)
  • The list of available LLMs in each Space
  • Per-Space Confidentiality and other Space-level configuration
  • Roles (User, Space Owner, Application Owner, Data Scientist, OpenWebUI-Admin)

Now that every Space supports collections, assistants, and prompt templates, you can build assistants directly in a Space using the Space’s data. Previously this was only possible in My Space, so it’s likely that data which logically belongs to a Space was kept in My Space to be used with assistants.

We recommend two migration paths to align your data with the new model:

If you have collections, assistants, or other items in My Space that logically belong to a specific Space, move them there. Now that each Space has its own workspace items, there is no reason to keep Space-related data in My Space.

You have two options:

  • Self-service: move individual elements yourself from My Space into the target Space.
  • Bulk migration: contact us and we can move all elements that belong to a specific Space for you in one go.

With the introduction of collections, there is no longer a need to maintain multiple Spaces that are accessed by the same set of users. Data that was previously separated across Spaces can now be organized using collections within a single Space.

We recommend merging Spaces whose members are identical (or nearly identical) into one Space. This simplifies administration and makes it easier to combine data in assistants and chats. AutoSync configurations (S3) and data connections (Confluence) are migrated along with the Space merge.

Contact us to request a Space merge.