=== Subsync - RSS Sync for Substack === Contributors: stormhill Donate link: https://stormhillmedia.com/plugins/donate/ Tags: newsletter, rss, feed, substack, sync Requires at least: 6.0 Tested up to: 6.9 Stable tag: 1.0.0 Requires PHP: 7.4 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html Sync and display your Substack posts on WordPress. Perfect for newsletter publishers. == Description == **Bring your Substack to your WordPress site.** Subsync automatically imports your Substack posts into WordPress, making them searchable, discoverable, and part of your website. Perfect for Substack writers who want to maintain a presence on their own domain. = Why Subsync? = **Own Your Content** Keep a backup of your posts on your WordPress site. If you ever decide to move platforms, you'll have all your content ready to go. **Improve Discoverability** Make your posts searchable on Google and accessible to readers who prefer your website over email subscriptions. **Grow Your Audience** Give readers multiple ways to find and engage with your content. Your website visitors can browse your entire archive without needing to subscribe. **Set It and Forget It** Once configured, Subsync runs automatically. New posts appear on your site within 24 hours of publication. = Key Features = * **Setup Wizard** — Get started in under 2 minutes with our guided setup process * **Automatic Syncing** — Daily or weekly sync keeps your WordPress site updated automatically * **Featured Images** — Automatically imports and sets featured images from your posts * **Custom Post Type** — Posts appear in their own section, separate from your regular blog * **Flexible Display** — Use shortcodes or Gutenberg blocks to display posts anywhere on your site * **Smart Content** — Shows post excerpts with "Read More" buttons that link back to your Substack * **Responsive Design** — Mobile-friendly display works beautifully on all devices * **Missing Post Handling** — Choose what happens when you delete a post (keep or draft) * **Clean Uninstall** — Optionally removes all data when you deactivate * **Translation Ready** — Fully internationalized and ready for translation = How It Works = 1. Install and activate the plugin 2. Enter your RSS feed URL (e.g., `yourname.substack.com/feed`) 3. Run the initial sync to import your existing posts 4. Add the `[sstack_posts]` shortcode or Gutenberg block to any page 5. Your posts now display on your WordPress site! New posts are automatically synced daily (or weekly, your choice). Manual sync is always available if you want to update immediately after publishing. = Display Options = **Shortcode Usage:** `[sstack_posts]` — Show all posts (default 10, recommended) `[sstack_posts count="5"]` — Show 5 most recent posts `[sstack_posts orderby="title" order="ASC"]` — Sort alphabetically You can also use `[subsync_posts]` or `[substack_posts]` (backwards compatibility). **Gutenberg Block:** Use the "Subsync Posts" block in the editor with live preview and visual controls for number of posts, sorting, and ordering. = Perfect For = * Substack writers who want to maintain a website presence * Newsletter publishers on any platform with RSS * Content creators building a multi-platform audience * Authors keeping a backup of their content * Publications growing their SEO and discoverability = Pro Version Features = Upgrade to **Subsync Pro** for advanced features: * **Multi-Column Layouts** — Display posts in 2 or 3 column grids * **Author Info Box** — Display your bio, avatar, and subscribe button alongside posts * **Divi Module** — Native integration with Divi Builder for visual page building * **Priority Support** — Email support with faster response times [Learn more about Subsync Pro →](https://stormhillmedia.com/plugins/subsync-pro/) = Privacy & Data = Subsync does not collect, store, or transmit any personal data from your site visitors. The plugin only reads publicly available RSS feed data. No tracking, no analytics. = External Services = This plugin connects to external services to function properly: **Substack RSS Feeds and Images** * **What:** The plugin fetches your RSS feed from Substack and downloads featured images from Substack's CDN * **When:** During sync operations (manual or automatic based on your schedule) * **Data sent:** Standard HTTP requests to retrieve publicly available RSS feed data and image files * **Purpose:** To display your Substack posts and their associated images on your WordPress site * **Terms:** [Substack Terms of Service](https://substack.com/tos) * **Privacy:** [Substack Privacy Policy](https://substack.com/privacy) The plugin does not send any personal or sensitive data to external services. All data retrieved is publicly available content from your Substack publication. == Installation == = Automatic Installation = 1. Go to **Plugins → Add New** in your WordPress admin 2. Search for "Newsletter RSS Sync" 3. Click **Install Now** 4. Click **Activate** 5. Follow the setup wizard to configure your RSS feed = Manual Installation = 1. Download the plugin ZIP file 2. Go to **Plugins → Add New → Upload Plugin** 3. Choose the ZIP file and click **Install Now** 4. Click **Activate Plugin** 5. Follow the setup wizard to configure your RSS feed = After Activation = The setup wizard will guide you through: 1. **Feed URL** — Enter your RSS feed (e.g., `yourname.substack.com/feed`) 2. **Display Settings** — Choose how posts appear 3. **Initial Sync** — Import your existing posts Once complete, add the `[sstack_posts]` shortcode to any page or use the "Subsync Posts" block in Gutenberg. = Finding Your RSS Feed = Most newsletter platforms provide an RSS feed: * **Substack:** `https://yourname.substack.com/feed` * **Other platforms:** Check your platform settings for the RSS feed URL You can test it by pasting the URL into your browser — you should see XML content. == Frequently Asked Questions == = Will this work with my existing content? = Yes! Subsync uses a custom post type that's completely separate from your regular WordPress posts. Your existing blog content is never affected. = Do I need to stop publishing on my newsletter platform? = No! Continue publishing exactly as you do now. Subsync simply mirrors your posts to your WordPress site. Readers who click "Read More" are taken to your Substack where they can subscribe. = How often does it sync? = By default, Subsync checks for new posts daily. You can change this to hourly, twice daily, or manually sync anytime from the settings page. = What happens if I delete a post? = You choose! Options include: * **Keep** — Leave it on WordPress (no longer synced) * **Draft** — Change it to draft status (hidden from frontend) * **Trash** — Move to trash (recoverable) * **Delete** — Permanently delete from WordPress = Will it import my images? = Yes! Featured images are automatically downloaded and set. Images within post content link back to your Substack (the post content is displayed as an excerpt). = Can I customize how posts look? = Absolutely. Posts use your theme's default styling. You can add custom CSS to style the posts section, or use the Pro version for additional layout options like multi-column grids. = Does this work with Substack? = Yes! Subsync works perfectly with Substack, and any other newsletter service that provides an RSS feed. = Will this hurt my SEO? = No! Each post links back to your Substack as the canonical source, and the excerpt display (not full content) prevents duplicate content issues. You're essentially creating landing pages for your content. = Can I display posts from multiple feeds? = Currently, Subsync supports one RSS feed per WordPress site. If you need multiple feeds, consider using separate WordPress sites or contact us about custom development. = Is there a limit on how many posts I can sync? = No limits! Sync all your posts, whether you have 5 or 5,000. The plugin handles large feeds efficiently with background processing. = Does it work with multisite? = Yes! Subsync works on WordPress multisite installations. Each site can connect to its own feed. = How do I upgrade to Pro? = Visit [Subsync Pro](https://stormhillmedia.com/plugins/subsync-pro/) to purchase a license. After purchasing, install the Pro add-on plugin and activate it with your license key. All Pro features unlock immediately. = What if I need help? = Free support is available via the [WordPress.org support forums](https://wordpress.org/support/plugin/subsync/). Pro customers receive priority email support with faster response times. == Screenshots == 1. Setup wizard guides you through initial configuration in under 2 minutes 2. Synced posts appear in your WordPress admin under "Newsletter Posts" 3. Simple, clean settings page with all configuration options in one place 4. Posts display beautifully on your site with your theme's styling 5. Gutenberg block with live preview and visual controls 6. Shortcode works anywhere — pages, posts, widgets, or custom templates 7. Comprehensive help documentation built into the plugin 8. Pro upgrade options clearly displayed with locked feature previews == Changelog == = 1.0.0 = *Release Date: May 2, 2026* **Initial WordPress.org Release** Core Features: * Automatic RSS sync from Substack publications * Multiple sync frequencies (hourly, twice daily, daily, manual) * Gutenberg block and shortcode for displaying posts * Full content or excerpt display options * Category import and assignment * Customizable Substack link * SEO controls (noindex, canonical links) * Featured image import and local storage * Missing post handling (keep, draft, trash, delete) * Setup wizard for easy configuration * Manual sync button * Responsive design Pro Features Available (separate plugin): * Multi-Column Layouts * Author Info Box * Divi Module Integration == Upgrade Notice == = 1.1.0 = Major update with setup wizard, Gutenberg block, improved security, and reliability enhancements. Highly recommended upgrade for all users.