Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/lougriffith/cerrito-substack/archive/refs/heads/main.zipUpdates itself. It ships its own updater, so new versions appear under Dashboard → Updates.
A WordPress plugin that automatically imports posts from cerrito.substack.com into your WordPress site via RSS feed.
Features
- Fetches the Substack RSS feed on a configurable schedule (hourly, twice daily, or daily)
- Prevents duplicate imports using Substack's GUID
- Optionally sideloads featured images into your Media Library
- Strips Substack subscribe/footer boilerplate from post content
- Stores the original Substack URL as post meta for reference
- Manual Import Now button for on-demand runs
- Shortcode to display imported posts anywhere on your site
Installation
- Download the latest ZIP from Releases
- In WordPress, go to Plugins → Add New → Upload Plugin
- Upload the ZIP and click Activate
- Go to Settings → Substack Importer to configure
Configuration
| Setting | Description |
|---|---|
| Import Frequency | How often the feed is checked (hourly / twice daily / daily) |
| Post Status | Import as Published, Draft, or Pending Review |
| Assign Category | Automatically assign a WordPress category to imported posts |
| Post Author | WordPress user credited as the post author |
| Import Featured Images | Sideload the post's image into the Media Library |
Shortcode
Display imported Substack posts anywhere using:
[cerrito_substack_posts]
Shortcode Attributes
| Attribute | Default | Description |
|---|---|---|
count |
5 |
Number of posts to display |
category |
(all) | Filter by category slug or ID |
show_excerpt |
1 |
Show post excerpt (1 = yes, 0 = no) |
Example:
[cerrito_substack_posts count="3" category="news" show_excerpt="1"]
Post Meta
Each imported post stores two custom meta fields:
_csi_substack_guid— The Substack GUID used to prevent re-importing_csi_substack_url— The original Substack post URL
Requirements
- WordPress 5.8+
- PHP 7.4+
Changelog
See CHANGELOG.md
Author
License
GPL v2 — see LICENSE
Releases
1 release.
Tag
Published
v1.1
latest
Feb 20, 2026 8mo ago
These releases are tags only. The author does not attach a packaged zip, so there are no download counts to report.