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
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.Required Information
Required Information
- Title: Clear, descriptive name for the live stream event (required)
- Description: Additional context about the event (optional)
- Thumbnail: Preview image for the stream (recommended)
Stream Options
Stream Options
- Secure Streaming: Enable to restrict stream access with authentication
- Camera Feed Name: Defaults to “Main Feed” (customizable, 30 character limit)
Stream ID & Configuration
Stream ID & Configuration
- 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.
Child Stream Characteristics
Child Stream Characteristics
- 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
Naming Best Practices
Naming Best Practices
- 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
- Parent Stream
- Child Stream
- Title: Main event title
- Description: Event description and context
- Thumbnail: Preview image
- Camera Feed Name: Default “Main Feed” (customizable)
Copy live stream Link
Share your live stream with audiences using the copy link feature:Broadcast Not Started
Broadcast Not Started
No copy link button availableLink generation begins when broadcast starts.
Broadcast Ongoing
Broadcast Ongoing
“Copy live stream link”Share real-time access to the active live stream.
Broadcast Ended
Broadcast Ended
“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
| Column | Description | Logic |
|---|---|---|
| Title | Parent stream title | Always displays parent stream title |
| Creator | Stream creator | Parent stream creator information |
| Broadcast Status | Current stream state | Unified status across all feeds (see below) |
| Duration | Stream length | Longest completed stream duration |
| Moderation Status | Content review state | Up to 5 unique status codes (see below) |
| Created At | Stream creation time | Parent stream creation timestamp |
Broadcast Status Logic
The broadcast status reflects the unified state of parent and child streams:Not Started
Not Started
Displayed when: None of the parent or child streams have started broadcasting.This is the initial state after stream creation.
Live
Live
Displayed when: At least one stream (parent or child) is currently broadcasting.Priority status - displayed even if other streams are finished or not started.
Finished
Finished
Displayed when:
- All streams have finished broadcasting, OR
- At least one stream finished and others have not started
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:- Display Rules
- Status Types
- Overflow Handling
- 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
Multi-Stream Strategy
Multi-Stream Strategy
- 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
Production Quality
Production Quality
- 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
Performance & Reliability
Performance & Reliability
- 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
Audience Engagement
Audience Engagement
- 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
| Issue | Likely Cause | Resolution |
|---|---|---|
| Cannot add child stream | Already have 2 child streams | Maximum limit reached - delete existing child stream first |
| Stream not showing as Live | Status update delay or network issue | Refresh page; verify stream is actually broadcasting |
| Cannot delete parent stream | Has associated posts or child streams | Remove child streams and unlink posts before deletion |
| Copy link not available | Stream has not started | Link generation begins when broadcast starts |
| Child stream creation fails | Network error or permission issue | Verify permissions and retry; check connection |
| Duration not displaying | No streams have completed | Duration appears only after at least one stream finishes |
| Moderation status unclear | Multiple flags across streams | Review each stream individually for detailed status |
| Unsaved changes lost | Exited without confirming | Always confirm save or discard in modal prompt |
| Stream disconnects on deletion | Deleted live child stream | Deletion confirmation warned of active stream - plan deletions |
| Feed name too long | Exceeds 30 character limit | Shorten name to meet character limit |
| Child streams not showing in UIKit | UIKit doesn’t support multi-stream | Use SDK or API for multi-stream functionality; UIKit shows parent only |
| Cannot identify stream purpose | Missing metadata | Add 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
Stream Limits & Constraints
Stream Limits & Constraints
- 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
Status Update Frequency
Status Update Frequency
- Broadcast status updates in real-time
- Moderation status refreshes on page reload
- Duration calculates after stream completion
- List view updates on manual refresh
API Integration
API Integration
- 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 Limitations
UIKit Limitations
- 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
Stream Metadata
Stream Metadata
- 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"}