Layer Migration

LAST EDIT Feb 16 2021

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

Export Copied!

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

Frontend ComponentsCopied!

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.


  • 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:



Message Attachments (docs here)






  • 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 LiveCopied!

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


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