Skip to main content
This page explains how Console administrators manage live streams with multi-stream capabilities: create parent streams, add device-specific child feeds, monitor broadcast status, and integrate with posts. Multi-stream support enables professional, device-optimized live stream experiences.

Create Streams

Set up parent streams with title, description & thumbnail

Multi-Stream

Add up to 2 child feeds for device-specific views

Monitor Status

Track live, finished, and not started broadcasts

Edit Details

Update stream information with custom feed names

Post Integration

Create posts linked to parent and child streams

Moderate

Review moderation status across all feeds

​
Overview

Live Stream Management with multi-stream support allows you to deliver professional, device-optimized viewing experiences. By associating multiple camera feeds with a single live stream post, you can provide:
  • Vertical streams (9:16) optimized for mobile devices
  • Horizontal streams (16:9) optimized for desktop and tablets
  • Custom aspect ratios for specialized viewing scenarios
This eliminates the “one-size-fits-all” compromise and ensures your live events look polished on every screen.
UIKit Compatibility: Multi-stream (child streams) functionality is not supported in UIKit. UIKit will only work with the parent stream. For multi-stream implementation, use the SDK or API directly.
Stream Metadata: You can use live stream metadata to distinguish between parent and child streams and define their specific use cases (e.g., “mobile-view”, “desktop-view”). This metadata can be integrated using either the API or SDK to enable custom stream selection logic in your application.

​
Quick Start

1

Create Parent Stream

Set up the main live stream with title, description, and thumbnail.
2

Add Child Streams (Optional)

Add up to 2 additional feeds for device-specific views.
3

Create Post

Link the live stream to a post for audience engagement.
4

Monitor Broadcast

Track status, duration, and moderation across all feeds.

​
Creating Parent Streams

A parent stream is the primary live stream that serves as the default feed. It contains the essential information for your live event.
  • Title: Clear, descriptive name for the live stream event (required)
  • Description: Additional context about the event (optional)
  • Thumbnail: Preview image for the stream (recommended)
  • Secure Streaming: Enable to restrict stream access with authentication
  • Camera Feed Name: Defaults to “Main Feed” (customizable, 30 character limit)
  • Upon creation, a unique stream ID is automatically generated
  • This ID is used to link child streams and create posts
  • Stream configuration cannot be changed after going live
1

Navigate to live streams

Go to Console → Management → live streams.
2

Create New Stream

Click “Create live stream” button.
3

Enter Details

Fill in title, description, and upload thumbnail image.
4

Configure Options

Enable secure streaming if needed and customize feed name.
5

Confirm Creation

Review details and click “Create” to generate the parent stream.

​
Adding Child Streams

Child streams enable multi-stream functionality by providing device-specific video feeds under a parent stream. Add up to 2 child streams for a total of 3 simultaneous feeds.

​
Use Cases for Child Streams

Mobile Optimization

Vertical (9:16) feed for mobile viewers

Desktop Optimization

Horizontal (16:9) feed for desktop and tablets

Multi-Camera Events

Different camera angles for the same event

Language Variants

Same content with different commentary tracks

​
Adding a Child Stream

1

Select Parent Stream

Open the parent stream details from the live stream list.
2

Add Child Stream

Click “Add Child Stream” (available if fewer than 2 child streams exist).
3

Inherited Information

Child streams automatically inherit title and description from parent.
4

Customize Feed Name

Set a custom name (default: “Additional feed 1/2”, 30 character limit).
5

Configure Stream

Complete setup and receive a unique stream ID for the child feed.
  • Inherits title and description from parent stream
  • Can have custom camera feed name (e.g., “Mobile View”, “Desktop View”)
  • Receives unique stream ID for independent broadcasting
  • Shares moderation and post association with parent
  • Use descriptive names: “Mobile View”, “Desktop View”, “Camera 2”
  • Keep names concise (30 character limit)
  • Maintain consistent naming conventions across events
  • Consider audience perspective in naming
Limitation: You can add a maximum of 2 child streams per parent stream (3 total feeds). Plan your multi-stream strategy accordingly.

​
Editing Stream Details

Update stream information to keep event details accurate. Changes are allowed before and during broadcasts, with some restrictions.

​
Editable Fields

  • Title: Main event title
  • Description: Event description and context
  • Thumbnail: Preview image
  • Camera Feed Name: Default “Main Feed” (customizable)
Share your live stream with audiences using the copy link feature:
No copy link button availableLink generation begins when broadcast starts.
“Copy live stream link”Share real-time access to the active live stream.
“Copy live stream post link”Share link to the recorded content and engagement.

​
Deleting Child Streams

Remove child streams that are no longer needed or were created in error.
1

Select Stream

Open parent stream and locate the child stream to delete.
2

Initiate Deletion

Click delete icon next to the child stream.
3

Confirm Deletion

Review confirmation modal with status warning if stream is live.
4

Complete Removal

Confirm to permanently delete the child stream.
Live Stream Warning: If the child stream is currently broadcasting, the confirmation modal will warn that deletion will immediately disconnect the stream. Active viewers will lose access.
Parent Stream Protection: Parent streams cannot be deleted if they have associated posts or child streams. Remove child streams and unlink posts first.

​
Live Stream Management List

The live stream management page displays all streams with unified status reflecting both parent and child stream states.

​
List View Columns

ColumnDescriptionLogic
TitleParent stream titleAlways displays parent stream title
CreatorStream creatorParent stream creator information
Broadcast StatusCurrent stream stateUnified status across all feeds (see below)
DurationStream lengthLongest completed stream duration
Moderation StatusContent review stateUp to 5 unique status codes (see below)
Created AtStream creation timeParent stream creation timestamp

​
Broadcast Status Logic

The broadcast status reflects the unified state of parent and child streams:
Displayed when: None of the parent or child streams have started broadcasting.This is the initial state after stream creation.
Displayed when: At least one stream (parent or child) is currently broadcasting.Priority status - displayed even if other streams are finished or not started.
Displayed when:
  • All streams have finished broadcasting, OR
  • At least one stream finished and others have not started
Indicates the live event has concluded.

​
Duration Display

The duration field shows the longest completed stream among parent and child feeds:
  • Calculates from stream start to end time
  • Displays only when at least one stream has finished
  • Uses longest duration if multiple streams have different lengths
  • Remains empty if no streams have completed

​
Moderation Status Logic

Moderation status provides a consolidated view of content review across all streams:
  • Shows up to 5 unique status codes across parent and child streams
  • Hides duplicate status codes from different streams
  • Displays codes sorted by severity: Red > Yellow > Green
Moderation Priority: Focus on Red status codes first, as they indicate critical content that may violate community guidelines or require immediate action.

​
Post Integration

Create live stream posts that link to parent streams and automatically include all associated child streams.
For detailed information about creating and managing posts, see Posts Management.
Client-Side Intelligence: When users view a live stream post, client applications (iOS, Android, Web) using SDK or API can automatically select the optimal stream (parent or child) based on device type and screen orientation for the best viewing experience. UIKit applications will display the parent stream only.
Metadata Integration: Use stream metadata to identify stream purposes and implement custom stream selection logic. For example, add metadata like {"deviceType": "mobile", "orientation": "vertical"} to help your application choose the appropriate stream for each user’s context.

​
API-Created Streams

API Integration: Streams created via API without a specified camera feed name will display default names in the Console. You can edit these names at any time through the Console interface.

​
Best Practices

  • Plan ahead: Determine which devices need optimized feeds before going live
  • Test thoroughly: Verify all streams are properly configured before broadcast
  • Name clearly: Use descriptive camera feed names for easy identification
  • Monitor unified: Watch all feeds’ status during live events
  • Use metadata: Add meaningful metadata to identify stream purposes and enable smart selection
  • SDK/API only: Remember that multi-stream requires SDK or API integration, not UIKit
  • Thumbnail selection: Choose engaging, high-quality preview images
  • Title optimization: Write clear, compelling event titles
  • Description detail: Provide context and expectations for viewers
  • Secure streaming: Enable for private or restricted-access events
  • Bandwidth planning: Ensure sufficient upload capacity for multiple streams
  • Redundancy: Have backup feeds ready for critical events
  • Status monitoring: Keep Console open during broadcasts to track status
  • Child stream limits: Respect the 2 child stream maximum
  • Timing optimization: Schedule streams during peak audience availability
  • Post integration: Create posts before going live to build anticipation
  • Link sharing: Use copy link feature to promote across channels
  • Post-event access: Keep streams available for replay engagement

​
Troubleshooting

IssueLikely CauseResolution
Cannot add child streamAlready have 2 child streamsMaximum limit reached - delete existing child stream first
Stream not showing as LiveStatus update delay or network issueRefresh page; verify stream is actually broadcasting
Cannot delete parent streamHas associated posts or child streamsRemove child streams and unlink posts before deletion
Copy link not availableStream has not startedLink generation begins when broadcast starts
Child stream creation failsNetwork error or permission issueVerify permissions and retry; check connection
Duration not displayingNo streams have completedDuration appears only after at least one stream finishes
Moderation status unclearMultiple flags across streamsReview each stream individually for detailed status
Unsaved changes lostExited without confirmingAlways confirm save or discard in modal prompt
Stream disconnects on deletionDeleted live child streamDeletion confirmation warned of active stream - plan deletions
Feed name too longExceeds 30 character limitShorten name to meet character limit
Child streams not showing in UIKitUIKit doesn’t support multi-streamUse SDK or API for multi-stream functionality; UIKit shows parent only
Cannot identify stream purposeMissing metadataAdd metadata when creating streams via API/SDK for identification

​
Use Cases

Mobile-First Events

Host events optimized for mobile audiences with vertical video while providing horizontal backup for desktop viewers.

Professional Productions

Multi-camera productions with main stage view (horizontal) and close-up view (any orientation) for enhanced experience.

Responsive Broadcasting

Single event with automatic device optimization - viewers get the best feed for their screen automatically.

Global Conferences

Corporate events requiring professional desktop viewing with mobile accessibility for remote attendees.

​
Technical Specifications

  • Parent streams: Unlimited creation
  • Child streams per parent: Maximum 2
  • Total concurrent feeds: 3 (1 parent + 2 children)
  • Camera feed name length: 30 characters
  • Title length: No specified limit
  • Description length: No specified limit
  • Broadcast status updates in real-time
  • Moderation status refreshes on page reload
  • Duration calculates after stream completion
  • List view updates on manual refresh
  • Streams created via API appear in Console
  • Default camera feed names applied if not specified
  • Full editing capabilities for API-created streams
  • Unified status logic applies to all creation methods
  • UIKit does not support multi-stream functionality
  • UIKit will only display and interact with parent streams
  • Child streams are ignored in UIKit implementations
  • For multi-stream features, integrate using SDK or API directly
  • Add custom metadata to streams for identification purposes
  • Use metadata to distinguish parent/child stream use cases
  • Common metadata fields: device type, orientation, camera angle
  • Accessible via SDK and API for custom stream selection logic
  • Example: {"streamType": "mobile", "aspectRatio": "9:16", "purpose": "vertical-feed"}

​
Next Steps

Posts Management

Learn how to create and manage posts with live stream integration

Communities Management

Configure community settings for live stream hosting

Moderation Overview

Understand content moderation workflows for live streams

Analytics

Track live stream performance and engagement metrics