Layer Migration

Last Edit: Sep 22 2020

Migrating from Layer is easy. This guide will help you complete the migration quickly:

Export

The first step is downloading an export of your Layer data. The Layer docs specify how to create an export. Next email support@getstream.io your data export to have it imported to Stream. This process typically takes 1 business day.

Frontend Components

Layer doesn’t provide frontend components. You will want to decide if you want to customize one of Stream’s frontend components, or work with the chat API from your own frontend. Implementing a fully featured Chat in React can be very time consuming.

Have a look at these 5 examples and see if you can customize them. Swapping the front end components is the fastest way to integrate with Stream.

Differences

  • Stream provides 5 built-in chat types for the most common use cases. The commerce chat type is the most similar to Layer, so you’ll likely want to use it as a starting point.
  • Layer has the concept of Distinct Conversations and Non Distinct conversations. With Stream you initialize a channel with a channel type and channel id. You simply need to make sure the ID is unique when you want to create a new conversation.
  • Stream's naming conventions are slightly different from Layer's:

STREAM

LAYER

Message Attachments (docs here)

MessageParts

Channels

Conversations

Members

Participants

  • Another difference is that Layer allows you to specify a Metadata field. Stream allows you to add custom data directly to users, channels, messages, attachments and events.

Go Live

After testing your awesome new chat solution discuss a go-live date with Stream’s support team. We’ll re-import your data backup.

Help

If you have more tips for migrating from Layer to Stream be sure to contact us. We’re refining this guide continuously.