Skip to main content
The Feed Configuration section lets you control how content is ranked, filtered, and displayed to users.

​
Ranking weights

Configure the relative importance of each ranking signal at Feed → Ranking.

​
Weight sliders

Adjust weights for each signal (must sum to 100%):
SignalDescriptionDefault
RecencyFavor newer content25%
EngagementFavor popular content25%
Geo-relevanceMatch user location15%
Topic affinityMatch user interests20%
Completion rateFavor content users finish15%

​
Advanced settings

Configure how quickly recency score decays:
  • Half-life: Hours until 50% decay (default: 72 hours)
  • Max age: Hard cutoff for content age
Example: With 48-hour half-life, content from 2 days ago has 50% recency score.
Set minimum engagement levels:
  • Min views: Exclude content with fewer views
  • Min completion rate: Exclude poorly-performing content
Useful for filtering out content that’s not resonating with users.
Prevent feed repetition:
  • Topic diversity: Avoid consecutive items with same tag
  • Source diversity: Spread content from different sources

​
Preview changes

Before applying weight changes:
  1. Click Preview
  2. Select a sample user profile (or use anonymous)
  3. See how the feed would look with new weights
  4. Compare side-by-side with current weights

​
Content filters

Create named filters at Feed → Filters.

​
Creating a filter

  1. Click Create Filter
  2. Enter filter name and slug (e.g., “Sports”, “sports”)
  3. Define conditions:
Tags: ANY OF ["sports", "athletics", "nfl", "nba"]
AND
Duration: GREATER THAN 15 seconds
AND
Age: LESS THAN 7 days

​
Filter conditions

ConditionDescription
Tags (ANY OF)Content has at least one matching tag
Tags (ALL OF)Content has all specified tags
Tags (NONE OF)Content has none of specified tags
DurationVideo length range
AgeDays since publish
GeoContent geo-targeting
Custom metadataMatch custom field values

​
Using filters

Filters power:
  • Adjacent feeds: User swipes left/right to filtered content
  • SDK filter parameter: Request specific content subset
  • API requests: Filter feed endpoint results

​
Heuristic rules

Define hard rules at Feed → Ranking → Rules.

​
Creating rules

Rules are evaluated before scoring: 
{
  "name": "Exclude old content",
  "condition": "content.ageInDays > 30",
  "action": "exclude",
  "priority": 1
}

​
Rule builder

Use the visual rule builder:
  1. Click Add Rule
  2. Set condition using dropdowns:
    • If [content.tags] contains [“opinion”]
    • AND [feed.name] equals [“main”]
    • Then [exclude]
  3. Set priority (lower = evaluated first)
  4. Save rule

​
Common rules

IF content.ageInDays > 30
THEN exclude

IF user.region == "MN"
AND content.tags CONTAINS "minnesota"
THEN boost 2.0x

IF content.tags CONTAINS "crime"
AND feed.filter NOT CONTAINS "crime"
THEN exclude

IF content.tags CONTAINS "breaking"
AND content.ageInHours < 4
THEN boost 3.0x

​
Editorial dashboard

Manage editorial overrides at Feed → Editorial.

​
Active overrides

View all content with active pins, boosts, or suppressions:
ColumnDescription
ContentTitle and thumbnail
TypePin, Boost, or Suppress
ValuePosition or factor
ExpiresWhen override ends
Set byWho created the override

​
Quick actions

  • Click content to edit override
  • Bulk remove expired overrides
  • Export override history

​
Editorial calendar

View scheduled overrides:
  • Pins scheduled for specific dates
  • Time-limited boosts
  • Automatic expirations

​
Feed preview

Test your configuration at Feed → Preview.

​
Preview options

  1. User segment: Select from:
    • Anonymous (new user)
    • Sample users with different affinities
    • Specific user ID
  2. Location: Simulate different geos
  3. Filter: Apply content filter
  4. Config: Test different weight configurations

​
Compare mode

Compare two configurations side-by-side:
  1. Left: Current production config
  2. Right: New configuration
See how changes affect feed ordering for the same user.

​
Configuration history

View and restore previous configurations at Feed → History.

​
Version history

Every configuration change is tracked:
ColumnDescription
VersionAuto-incremented version number
ChangedWhat was modified
ByWho made the change
WhenTimestamp

​
Restore version

  1. Find the version to restore
  2. Click Preview to see the configuration
  3. Click Restore to apply
  4. Current config becomes new version

​
A/B testing configurations

Test ranking changes with experiments:
  1. Go to Experiments → Create New
  2. Select Ranking as experiment type
  3. Define variants with different weight configurations
  4. Set traffic allocation
  5. Run experiment and compare metrics
See A/B testing for details.

​
Next steps

A/B testing

Test feed configurations with experiments.

Feed ranking

Technical details on ranking algorithm.