The YouTube integration automatically publishes videos from your YouTube channel as Ghost posts. You can import your existing video library and have new uploads automatically create posts — each with an embedded player, and you control how metadata, descriptions, tags, and templates are applied.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.
The YouTube integration requires the Luna Plan.
How it works
- You enter your YouTube Channel ID and configure import settings
- Outpost checks for new videos on your channel
- Each video is created as a Ghost post with an embedded YouTube player
- Tags, author, description, and template are applied based on your settings
- Posts are created as drafts or published automatically, depending on your publish mode
Settings
| Field | Description |
|---|---|
| Channel ID | Your YouTube channel ID. Required to enable all other settings. |
| Mode | Import Existing Videos imports your full video library. Add Only New Videos only imports videos published after connecting. |
| Post Tags | Tags to automatically apply to every imported video post. |
| Post Author | The Ghost author to assign to imported posts. Populated from your Ghost site’s author list. |
| Add YouTube Description to the Post | No — skip the description. First Paragraph — include only the first paragraph. All Text — include the full video description. |
| Add YouTube Description to the Metadata field | No or Yes — controls whether the video description is also included in the post’s excerpt. |
| Hide the Featured Image on the Post | No or Yes — choose whether the video thumbnail appears as the post’s featured image. |
| Post Template | Assign a custom Ghost theme template to imported posts. Leave blank for the default template. |
| Embed Options | Embed YouTube Video — embeds the video player directly in the post. Deferred Loading — relies on a theme-side script to inject the player at view time (your theme must support the deferred-loading helper). None — no player embed, just the post text. |
| Publish Mode | Draft — imported posts are saved as drafts for review. Published — posts go live immediately. |
| Visibility | Public — all visitors can see the post. Public and Unlisted — includes unlisted videos. Unlisted — only unlisted videos are imported. |
Unlisted videos and account access
If you select Public and Unlisted or Unlisted visibility, Outpost needs access to your YouTube account to read unlisted videos:- Click Connect API in the visibility section
- Sign in with Google to authorize Outpost to access your YouTube account
- Outpost can now import unlisted videos alongside public ones
Post creation
When a video is imported, Outpost creates a Ghost post with:- Title — The video’s YouTube title
- Content — An embedded YouTube player (based on your embed options), plus the video description if configured
- Featured image — The video’s thumbnail (unless hidden)
- Tags — Your configured default tags
- Author — Your configured default author
- Template — Your configured theme template
- Status — Draft or published per your publish mode setting
Related features
Contextly
Drive content recommendations that include imported video posts.
Trending Posts
Track which imported videos are trending on your site.
FAQ
How often does Outpost check for new videos?
How often does Outpost check for new videos?
Outpost regularly checks your YouTube channel for new uploads and imports them automatically based on your configured settings.
Can I import videos from multiple channels?
Can I import videos from multiple channels?
Each YouTube integration connects to one channel. If you need to import from multiple channels, contact support.
What happens if I change my import settings?
What happens if I change my import settings?
Settings changes apply to future imports only. Already-imported posts are not retroactively updated. To re-import with new settings, disconnect and reconnect the integration.
Does deferred loading affect SEO?
Does deferred loading affect SEO?
Deferred loading uses a theme-side script to inject the embed at view time, which can improve page speed scores. Confirm with your theme developer that the deferred-loading helper is wired up; otherwise the player may not appear.