Use this page to determine which thread type is best for your use case before getting started!
3Box Threads are available as either persistent threads (open, members, personal), where messages are available in a persistent OrbitDB feed store shared between users unless explicitly removed by the author or a moderator, or ghost threads, where messages are not persisted in a database but whose history is kept in-memory by online peers and can be requested by new users. For ghost threads, if all peers go offline then messages disappear.
Persistent Threads are best suited for comment systems or message/content feeds that have one of more of the following requirements: strong message persistence guarantees; high availability guarantees; can tolerate offline peers; can support members-only write permissions; can support personal feeds. See example use cases for Persistent Threads.
The drawback to Persistent Threads is that threads are less scalable and chatty, since every message is saved in an append-only OrbitDB log which can get very long. This can cause persistent threads to load slowly on the client at scale.
Ghost Threads are best suited for chatrooms that have one or more of the following requirements: many messages; lots of activity; fast load speeds; or disappearing messages. See example use cases for Ghost Threads.
The drawback to Ghost Threads is that messages are weakly persisted, since they only exist ephemerally in peer memory. If all peers simultaneously go offline, the message history will be lost.
In Persistent Open Threads, any user that knows the thread name can post new messages but moderators and authors can remove posts. Any user can read all messages. Get started building with persistent open threads.
In Persistent Members Threads, only members can post new messages but moderators and authors can remove messages. Any user can read all messages. Get started building with persistent members threads.
Personal threads are a specific kind of members thread that allow only a single user to post new messages and moderate their own thread. Everyone can read the thread. Personal threads are achieved when the
firstModerator does not add additional
members. Get started building with persistent personal threads.
In Ghost Open Threads, any user that knows the chatroom name can join and post new messages in the thread. Any user can read messages. Get started building with Ghost Threads.