Skip to main content

Documentation Index

Fetch the complete documentation index at: https://documentation.outpost.pub/llms.txt

Use this file to discover all available pages before exploring further.

Trending Posts requires the Contextly integration to be connected. Contextly itself requires Outpost’s advanced subscription plan.
The Trending Posts feature uses traffic data from Contextly to identify your most popular content, then automatically applies Ghost tags to those posts. By configuring your Ghost theme to display posts with the specified tag, you can create a “trending” or “popular” section on your homepage or sidebar that updates on the schedule you set.
Trending Posts settings with enable toggle, tag selector, update frequency, and number of stories

​
How it works

  1. Outpost checks your Contextly traffic data at the interval you set (e.g., every 4 hours)
  2. It identifies the top-performing posts based on Contextly’s popularity metrics
  3. It applies the tag(s) you’ve chosen to those posts in Ghost
  4. It removes the tag from posts that are no longer trending
  5. Your Ghost theme displays posts with that tag in a “Trending” section
Once configured, the trending tags update on the schedule you set.

​
Configuration

Toggle the Enable Trending stories checkbox to turn the feature on or off. When enabled, the following settings appear:
SettingDescription
Post tags:Select one or more Ghost tags to apply to trending posts. These should match what your theme uses to display the trending section.
Update stories every:How often Outpost refreshes the trending list. Options: 1 hour, 2 hours, 4 hours, 8 hours, 12 hours, or 1 day.
Number of stories:How many posts to tag as trending at any given time.

​
Saving your settings

Click Save to apply your configuration. Outpost will immediately run the tagging process and show the results:
  • Success: A list of the posts that were tagged, with clickable titles linking to each post on your site.
  • Error: If something goes wrong during tagging, the error details are displayed.

​
Removing tags from previously tagged posts

If you change the tags in your configuration, Outpost asks whether you want to untag posts that had the previous tag(s). A confirmation dialog appears:
“Do you want us to untag any posts with tags: [previous tag list].”
Click Ok to remove the old tags, or Cancel to leave them in place.

​
Setting up your theme

For trending posts to appear on your site, your Ghost theme needs to display posts with the tag you’ve configured. This typically involves:
  1. A section on your homepage or sidebar that queries posts by tag
  2. Displaying the post title, excerpt, and/or featured image
Consult your theme’s documentation or your developer for how to add a tag-based post section. The tag name you select in the Trending Posts settings must match exactly.

Contextly Integration

Connect Contextly to power trending post detection and content recommendations.

Analytics

View engagement metrics and member growth across your publication.

​
FAQ

Trending Posts relies entirely on Contextly’s traffic and popularity data. Contextly tracks page views, engagement, and recirculation across your site to determine which posts are trending.
Yes. You can select multiple tags in the Post tags field. All selected tags will be applied to each trending post. This is useful if your theme has different display sections for different tag-based queries.
Yes. Trending Posts is powered entirely by Contextly’s traffic data. Without a connected Contextly account, this feature is unavailable.