Managing Queues

Queues are where your aggregated content comes to life. Each topic has a corresponding queue that displays all collected content, allowing you to manually curate, organize, and prepare content for your widgets. This guide covers everything you need to know about effective queue management.

Understanding Queues

A queue is a one-to-one mapping with a topic that provides:

• Real-time content display from all configured sources
• Manual curation controls to show/hide individual items
• Pinning capabilities for up to 10 priority items
• Drag-and-drop reordering for pinned content
• Content preview before publishing to widgets

Placeholder: Detailed queue interface showing content items with controls

Accessing Your Queue

1. Navigate to Topics

   From your dashboard, go to the Topics section.

   Placeholder: Topics list showing “View Queue” buttons

2. Open Queue

   Click “View Queue” next to any topic to access its corresponding queue.

3. Queue Interface Overview

   The queue interface displays:

   • Content items from all sources
   • Manual control buttons for each item
   • Pinning and visibility controls
   • Search and filter options

Content Item Management

Show/Hide Content

Control which content appears in your widgets:

Placeholder: Individual content items with show/hide toggle buttons

Show/Hide Actions:

• Visible Items: ✅ Will appear in widgets and API responses
• Hidden Items: ❌ Excluded from widgets but remain in queue
• Batch Operations: Select multiple items for bulk show/hide

Strategic Hiding

Use the hide function to remove outdated, irrelevant, or low-quality content without permanently deleting it. You can always unhide items later.

Content Item Details

Each content item in the queue displays:

┌─────────────────────────────────────────────┐
│ [Source Icon] Title of Content Item         │
│ Author/Channel Name • Published Date        │
│ Brief excerpt or description...             │
│ ──────────────────────────────────────────  │
│ [👁️ Show/Hide] [📌 Pin] [⋯ More Options]     │
└─────────────────────────────────────────────┘

Placeholder: Detailed view of a single content item with all metadata

Pinning and Prioritization

Understanding Pinned Content

Pinned items are priority content that:

• Always appear first in your widgets
• Can be manually reordered within the pinned section
• Are limited to 10 items maximum per queue
• Remain pinned across all widgets using the topic

Placeholder: Queue showing pinned items section at the top

Pinning Content

1. Select Items to Pin

   Click the pin icon (📌) next to any content item.

   Placeholder: Content item with highlighted pin button

2. Manage Pin Limit

   If you already have 10 pinned items, you’ll need to unpin an existing item first.

   Placeholder: Warning dialog about pin limit

3. Verify Pinned Status

   Pinned items move to the top section with a pin indicator.

Note

The 10-item pin limit ensures optimal widget performance and prevents overly long priority sections.

Reordering Pinned Content

Pinned items can be reordered using drag-and-drop:

1. Access Pinned Section

   Pinned items appear in a dedicated section at the top of your queue.

   Placeholder: Clearly marked pinned items section

2. Drag and Drop

   Click and drag any pinned item to reorder within the pinned section.

   Placeholder: Animation or illustration of drag-and-drop reordering

3. Save Order

   The new order saves automatically and applies to all widgets using this topic.

Reordering Limitations

You can only reorder items within the pinned section. Regular (unpinned) content maintains chronological order and cannot be manually reordered.

Advanced Queue Management

Search and Filtering

Quickly find specific content in large queues:

Placeholder: Search bar and filter options in queue interface

Search Options:

• Text Search: Find items by title, description, or author
• Source Filter: Show only content from specific sources
• Date Range: Filter by publication date
• Status Filter: Show only visible, hidden, or pinned items

Bulk Operations

Manage multiple items simultaneously:

Placeholder: Checkbox selection and bulk action buttons

Available Bulk Actions:

• Show/Hide multiple items
• Pin/Unpin selections (within 10-item limit)
• Export selected items
• Delete outdated content

1. Select Multiple Items

   Use checkboxes to select multiple content items.

2. Choose Bulk Action

   Use the bulk action toolbar that appears after selection.

3. Confirm Changes

   Review and confirm your bulk operation.

Content Preview

Preview how content will appear in widgets:

Placeholder: Modal showing how content appears in different widget types

Preview Options:

• Widget-specific rendering
• Mobile and desktop views
• Different layout configurations

Queue Analytics

Monitor your queue performance:

Placeholder: Analytics showing content engagement and performance metrics

Key Metrics:

• Total content items
• Visibility ratio (shown vs. hidden)
• Pinned content performance
• Source contribution breakdown
• Engagement metrics (if available)

Best Practices

Regular Curation

Review your queue weekly. Remove outdated content and pin fresh, relevant items to keep your widgets engaging.

Strategic Pinning

Pin your most important, timely, or evergreen content. Use the full 10-pin limit for maximum impact.

Balance Sources

Ensure pinned content represents a good mix from your different sources. Don’t let one source dominate.

Monitor Performance

Track which pinned items perform best in your widgets and adjust your pinning strategy accordingly.

Workflow Optimization

Daily Queue Management

Quick Daily Review (5 minutes):

1. Check for new high-priority content to pin
2. Hide any inappropriate or outdated items
3. Verify pinned content is still relevant

Weekly Queue Cleanup

Comprehensive Weekly Review (15 minutes):

1. Unpin outdated priority content
2. Pin fresh, relevant items
3. Bulk hide old content beyond your date threshold
4. Review queue analytics for insights

Content Lifecycle

Understanding the typical content lifecycle in queues:

New Content → Queue → Manual Review → Pin/Show/Hide → Widget Display → Archive/Remove

Placeholder: Flowchart showing content movement through the system

Troubleshooting

Common Issues

Pinned Items Not Appearing First:

• Check if the widget is using the correct topic
• Verify pinned items are also set to “show”
• Refresh widget cache if using cached implementation

Cannot Pin More Items:

• You’ve reached the 10-item limit
• Unpin an existing item before pinning new ones
• Consider creating multiple topics for different content priorities

Reordering Not Working:

• Only pinned items can be reordered
• Ensure you’re dragging within the pinned section
• Check for JavaScript conflicts on the page

Content Not Updating:

• Verify source feeds are active and accessible
• Check topic filtering settings
• Review content collection logs

Performance Tips

For Large Queues (500+ items):

• Use search and filters to navigate efficiently
• Implement regular cleanup routines
• Consider archiving very old content
• Use date-based filtering in your topic configuration

Integration with Widgets

Your queue management directly impacts widget display:

Placeholder: Diagram showing how queue organization affects widget display

Widget Behavior:

• Pinned items always appear first
• Pinned item order is preserved
• Hidden items are excluded
• Regular items follow chronological order

---

Ready to display your curated content? Learn how to create and manage widgets or explore API integration.