## Description Enter the fediverse with **ActivityPub** , broadcasting your blog to a wider audience! Attract followers, deliver updates, and receive comments from a diverse user base of **ActivityPub** -compliant platforms. With the ActivityPub plugin installed, your WordPress blog itself functions as a federated profile, along with profiles for each author. For instance, if your website is `example.com`, then the blog-wide profile can be found at `@[email protected]`, and authors like Jane and Bob would have their individual profiles at `@[email protected]` and `@[email protected]`, respectively. An example: I give you my Mastodon profile name: `@[email protected]`. You search, see my profile, and hit follow. Now, any post I make appears in your Home feed. Similarly, with the ActivityPub plugin, you can find and follow Jane’s profile at `@[email protected]`. Once you follow Jane’s `@[email protected]` profile, any blog post she crafts on `example.com` will land in your Home feed. Simultaneously, by following the blog-wide profile `@[email protected]`, you’ll receive updates from all authors. **Note** : If no one follows your author or blog instance, your posts remain unseen. The simplest method to verify the plugin’s operation is by following your profile. If you possess a Mastodon profile, initiate by following your new one. The plugin works with the following tested federated platforms, but there may be more that it works with as well: * Mastodon * Pleroma/Akkoma * friendica * Hubzilla * Pixelfed * Socialhome * Misskey Some things to note: 1. The blog-wide profile is only compatible with sites with rewrite rules enabled. If your site does not have rewrite rules enabled, the author-specific profiles may still work. 2. Many single-author blogs have chosen to turn off or redirect their author profile pages, usually via an SEO plugin like Yoast or Rank Math. This is usually done to avoid duplicate content with your blog’s home page. If your author page has been deactivated in this way, then ActivityPub author profiles won’t work for you. Instead, you can turn your author profile page back on, and then use the option in your SEO plugin to noindex the author page. This will still resolve duplicate content issues with search engines and will enable ActivityPub author profiles to work. 3. Once ActivityPub is installed, _only new posts going forward_ will be available in the fediverse. Likewise, even if you’ve been using ActivityPub for a while, anyone who follows your site will only see new posts you publish from that moment on. They will never see previously-published posts in their Home feed. This process is very similar to subscribing to a newsletter. If you subscribe to a newsletter, you will only receive future emails, but not the old archived ones. With ActivityPub, if someone follows your site, they will only receive new blog posts you publish from then on. So what’s the process? 1. Install the ActivityPub plugin. 2. Go to the plugin’s settings page and adjust the settings to your liking. Click the Save button when ready. 3. Make sure your blog’s author profile page is active if you are using author profiles. 4. Go to Mastodon or any other federated platform, and search for your profile, and follow it. Your new profile will be in the form of either `@[email protected]` or `@[email protected]`, so that is what you’ll search for. 5. On your blog, publish a new post. 6. From Mastodon, check to see if the new post appears in your Home feed. **Note** : It may take up to 15 minutes or so for the new post to show up in your federated feed. This is because the messages are sent to the federated platforms using a delayed cron. This avoids breaking the publishing process for those cases where users might have lots of followers. So please don’t assume that just because you didn’t see it show up right away that something is broken. Give it some time. In most cases, it will show up within a few minutes, and you’ll know everything is working as expected. ## Screenshots * The “Follow me”-Block in the Block-Editor * The “Followers”-Block in the Block-Editor * The “Federated Reply”-Block in the Block-Editor * A “Federated Reply” in a Post * A Blog-Profile on Mastodon ## Blocks This plugin provides 6 blocks. * Fediverse Followers Display your followers from the Fediverse on your website. * Reply Handler: not a block, but block.json is very useful. * Fediverse Reactions Display Fediverse likes and reposts * Federated Reply Respond to posts, notes, videos, and other content on the fediverse. Ensure the URL originates from a federated social network like Mastodon, as other URLs might not function as expected. * Follow me on the Fediverse Display your Fediverse profile so that visitors can follow you. * Editor Plugin: not a block, but block.json is very useful. ## Installation Follow the normal instructions for installing WordPress plugins. #### Automatic Plugin Installation To add a WordPress Plugin using the built-in plugin installer: 1. Go to Plugins > Add New. 2. Type “`activitypub`” into the **Search Plugins** box. 3. Find the WordPress Plugin you wish to install. 1. Click **Details** for more information about the Plugin and instructions you may wish to print or save to help setup the Plugin. 2. Click **Install Now** to install the WordPress Plugin. 4. The resulting installation screen will list the installation as successful or note any problems during the install. 5. If successful, click **Activate Plugin** to activate it, or **Return to Plugin Installer** for further actions. #### Manual Plugin Installation There are a few cases when manually installing a WordPress Plugin is appropriate. * If you wish to control the placement and the process of installing a WordPress Plugin. * If your server does not permit automatic installation of a WordPress Plugin. * If you want to try the latest development version. Installation of a WordPress Plugin manually requires FTP familiarity and the awareness that you may put your site at risk if you install a WordPress Plugin incompatible with the current version or from an unreliable source. Backup your site completely before proceeding. To install a WordPress Plugin manually: * Download your WordPress Plugin to your desktop. * Download from the WordPress directory * Download from GitHub * If downloaded as a zip archive, extract the Plugin folder to your desktop. * With your FTP program, upload the Plugin folder to the `wp-content/plugins` folder in your WordPress directory online. * Go to Plugins screen and find the newly uploaded Plugin in the list. * Click **Activate** to activate it. ## FAQ ### tl;dr This plugin connects your WordPress blog to popular social platforms like Mastodon, making your posts more accessible to a wider audience. Once installed, your blog can be followed by users on these platforms, allowing them to receive your new posts in their feeds. ### What is “ActivityPub for WordPress” _ActivityPub for WordPress_ adds Fediverse features to WordPress, but it is not a replacement for platforms like Friendica or Mastodon. If you’re looking to host a decentralized social network, consider using Mastodon or Friendica. ### Why “ActivityPub”? The name ActivityPub comes from the two core ideas behind the protocol: * Activity: It is based on the concept of activities, like “Create”, “Like”, “Follow”, “Announce”, etc. These are structured messages (usually in ActivityStreams format) that describe what users do on the network. * Pub: Short for publish or publication. It refers to the fact that this is a publish-subscribe (pub-sub) protocol — one user can “follow” another, and receive their published activities. Put together, ActivityPub is a protocol for publishing and subscribing to activities, which enables decentralized social networking — where different servers can interact and users can follow each other across the Fediverse. ### How do I solve… We have a **How-To** section in the docs directory that can help you troubleshoot common issues. ### Constants The plugin uses PHP Constants to enable, disable or change its default behaviour. Please use them with caution and only if you know what you are doing. * `ACTIVITYPUB_REST_NAMESPACE` – Change the default Namespace of the REST endpoint. Default: `activitypub/1.0`. * `ACTIVITYPUB_EXCERPT_LENGTH` – Change the length of the Excerpt. Default: `400`. * `ACTIVITYPUB_MAX_IMAGE_ATTACHMENTS` – Change the number of attachments, that should be federated. Default: `4`. * `ACTIVITYPUB_HASHTAGS_REGEXP` – Change the default regex to detect hashtext in a text. Default: `(?:(?<=\s)|(?<=<p>)|(?<=<br>)|^)#([A-Za-z0-9_]+)(?:(?=\s|[[:punct:]]|$))`. * `ACTIVITYPUB_USERNAME_REGEXP` – Change the default regex to detect @-replies in a text. Default: `(?:([A-Za-z0-9\._-]+)@((?:[A-Za-z0-9_-]+\.)+[A-Za-z]+))`. * `ACTIVITYPUB_URL_REGEXP` – Change the default regex to detect urls in a text. Default: `(www.|http:|https:)+[^\s]+[\w\/]`. * `ACTIVITYPUB_CUSTOM_POST_CONTENT` – Change the default template for Activities. Default: `<strong>[ap_title]</strong>\n\n[ap_content]\n\n[ap_hashtags]\n\n[ap_shortlink]`. * `ACTIVITYPUB_AUTHORIZED_FETCH` – Enable AUTHORIZED_FETCH. * `ACTIVITYPUB_DISABLE_REWRITES` – Disable auto generation of `mod_rewrite` rules. Default: `false`. * `ACTIVITYPUB_DISABLE_INCOMING_INTERACTIONS` – Block incoming replies/comments/likes. Default: `false`. * `ACTIVITYPUB_DISABLE_OUTGOING_INTERACTIONS` – Disable outgoing replies/comments/likes. Default: `false`. * `ACTIVITYPUB_SHARED_INBOX_FEATURE` – Enable the shared inbox. Default: `false`. * `ACTIVITYPUB_SEND_VARY_HEADER` – Enable to send the `Vary: Accept` header. Default: `false`. ### Where can you manage your followers? If you have activated the blog user, you will find the list of his followers in the settings under `/wp-admin/options-general.php?page=activitypub&tab=followers`. The followers of a user can be found in the menu under “Users” -> “Followers” or under `wp-admin/users.php?page=activitypub-followers-list`. For reasons of data protection, it is not possible to see the followers of other users. ## Reviews ### Thank You for Making Fediverse Connections Possible 김지운 September 10, 2025 As someone working on the Korean translation of this plugin, I have seen first-hand how important it is for WordPress users to connect with the Fediverse. This plugin provides a bridge that makes such integration possible. Thanks to the developers, Korean users can now more easily explore and join the open social web. I deeply appreciate the effort, vision, and continuous improvements behind this project. ### Worked out of the box. Brilliant. Writeworks August 3, 2025 I’ve installed and setup other ActivityPub servers usually some time & testing required along with tweaks. However with the WP ActivityPub plug-in it, surprisingly, functioned properly <gasp!> right after install. What a joy. Thank you. ### Excellent plugin, easily join the Fediverse in minutes! Louis Chance July 23, 2025 Great plugin (actively maintained!), great support, a very nice way to join the Fediverse and automatically share posts and any kind of CPT to the Fediverse audience. I was initially sharing posts using my personal Mastodon account, but it’s much nicer to have your dedicated account for your blogs (and/or authors). Thanks for this plugin! ### Best thing since WordPress xuv June 6, 2025 Why wouldn’t you want your blog to federate with Mastodon and all the other apps on the Fediverse? This plugin in such an important piece in the social web ecosystem. Install eyes closed. ### Great out-of-the-box integration Fred Rocha May 22, 2025 1 reply Very solid move from WordPress to decide to integrate ActivityPub into their family. I’ve set up a friend’s website to have ActivityPub and it’s working really nicely. ### Connecting WordPress and Mastodon inselit April 6, 2025 Great Plugin: When I publish a post on WordPress, it also appears on Mastodon.Friendly Support: Thanks to Matthias Pfefferle, who answered my questions during installation and evaluation. Read all 38 reviews ## Contributors & Developers “ActivityPub” is open source software. The following people have contributed to this plugin. Contributors * Automattic * Matthias Pfefferle * Matt Wiebe * Konstantin Obenland * Alex Kirk * Jeremy Herve * Django * nuriapena * Donna Fontenot * André Menrath “ActivityPub” has been translated into 26 locales. Thank you to the translators for their contributions. Translate “ActivityPub” into your language. ### Interested in development? Browse the code, check out the SVN repository, or subscribe to the development log by RSS. ## Changelog ### 7.5.0 – 2025-10-01 #### Added * Added a setting to control who can quote your posts. * Added support for QuoteRequest activities (FEP-044f), enabling proper handling, validation, and policy-based acceptance or rejection of quote requests. * Add upgrade routine to enable ActivityPub feeds in WordPress.com Reader * Add Yoast SEO integration for author archives site health check. * Improved interaction policies with clearer defaults and better Mastodon compatibility. * New site health check warns if active Captcha plugins may block ActivityPub comments. * Sync following meta to enable RSS feed subscriptions for ActivityPub actors in WordPress.com Reader * You can now follow people and see their updates right in the WordPress.com Reader when using Jetpack or WordPress.com. #### Changed * Added support for fetching actors by account identifiers and improved reliability of actor retrieval. * Clarify error messages in account modal to specify full profile URL format. * Improved checks to better identify public Activities. * Improved compatibility by making the ‘implements’ field always use multiple entries. * Improved recipient handling for clarity and improved visibility handling of activities. * Remote reply blocks now sync account info across all blocks on the same page * Standardized notification handling with new hooks for better extensibility and consistency. * Updated sync allowlist to add support for Jetpack notifications of likes and reposts. #### Fixed * Fixed an issue where post metadata in the block editor was missing or failed to update. * Fix Flag activity object list processing to preserve URL arrays * Fix PHP warning in bulk edit scenario when post_author is missing from $_REQUEST * Posts now only fall back to the blog user when blog mode is enabled and no valid author exists, ensuring content negotiation only runs if an Actor is available. ### 7.4.0 – 2025-09-15 #### Added * Add activitypub_json REST field for ap_actor posts to access raw JSON data * Add Delete activity support for permanently deleted federated comments. * Added a new WP-CLI command to manage Actors. * Added confirmation step for bulk removal of ActivityPub capability, asking whether to also delete users from the Fediverse. * Adds support for virtual deletes and restores, allowing objects to be removed from the fediverse without being deleted locally. * Add Yoast SEO integration for media pages site health check * Optimized WebFinger lookups by centralizing and caching account resolution for faster, more consistent handling across lists. #### Changed * Clarified the ‘attachment’ post type description to explain it refers to media library uploads and recommend disabling federation in most cases. * Hide site-wide checkbox in block confirmations when accessed from ActivityPub settings page * Improved ActivityPub compatibility by aligning with Mastodon’s Application Actor. * It’s now possible to reply to multiple posts using multiple reply blocks. * Refactored Reply block to use WordPress core embed functionality for better compatibility and performance. * Use wp_interactivity_config() for static values instead of wp_interactivity_state() to improve performance and code clarity #### Deprecated * ActivityPub now defaults to automated object type selection, with the old manual option moved to Advanced settings for compatibility. #### Fixed * Fix content visibility override issue preventing authors from changing visibility on older posts. * Fix PHP warning when saving ActivityPub settings. * Fix query args preservation in collection pagination links * Fix release script to catch more ‘unreleased’ deprecation patterns that were previously missed during version updates. * Fix reply block rendering inconsistency where blocks were always converted to @-mentions in ActivityPub content. Now only first reply blocks become @-mentions, others remain as regular links. * Stop sending follow notifications to the Application user, since system-level accounts cannot be followed. ### 7.3.0 – 2025-08-28 #### Added * Add actor blocking functionality with list table interface for managing blocked users and site-wide blocks * Add code coverage reporting to GitHub Actions PHPUnit workflow with dedicated coverage job using Xdebug * Add comprehensive blocking and moderation system for ActivityPub with user-specific and site-wide controls for actors, domains, and keywords. * Add comprehensive unit tests for Followers and Following table classes with proper ActivityPub icon object handling. * Added link and explanation for the existing Starter Kit importer on the help tab of the Following pages. * Adds a self-destruct feature to remove a blog from the Fediverse by sending Delete activities to followers. * Adds a User Interface to select accounts during Starter Kit import * Adds support for importing Starter Kits from a link (URL). * Adds support for searching (remote) URLs similar to Mastodon, redirecting to existing replies or importing them if missing. * Adds support for sending Delete activities when a user is removed. * Adds support for Starter Kit collections in the ActivityPub API. * A global Inbox handler and persistence layer to log incoming Create and Update requests for debugging and verifying Activity handling. * Follower lists now include the option to block individual accounts. * Improved handling of deleted content with a new unified system for better tracking and compatibility. * Moderation now checks blocked keywords across all language variants of the content, summary and name fields. * When activated or deactivated network-wide, the plugin now refreshes rewrite rules across all sites. #### Changed * Add default avatars for actors without icons in admin tables * Added support for list of Actor IDs in Starter Kits. * Improve Following class documentation and optimize count methods for better performance * Refactor actor blocking with unified API for better maintainability #### Fixed * Blocks relying on user selectors no longer error due to a race condition when fetching users. * Fix duplicate HTML IDs and missing form labels in modal blocks * Fix malformed ActivityPub handles for users with email-based logins (e.g., from Site Kit Google authentication) * Fix PHP 8.4 deprecation warnings by preventing null values from being passed to WordPress core functions * Improves handling of author URLs by converting them to a proper format. * Improves REST responses by skipping invalid actors in Followers and Following controllers. * More reliable Actor checks during the follow process. * Prevents Application users from being followed. * Proper implementation of FEP 844e. * Switches ActivityPub summaries to plain text for better compatibility. ### 7.2.0 – 2025-07-30 #### Added * Add image attachment support to federated comments – HTML images in comment content now include proper ActivityStreams attachment fields. * Link to the following internal dialog for remote interactions, if the feature is enabled. * The followers list now shows follow status and allows quick follow-back actions. * Trigger Actor updates on (un)setting a post as sticky. * You can now use `OrderedCollection`s as starter packs — just drop in the output from a Follower or Following endpoint. #### Changed * Ensure that tests run in production-like conditions, avoiding interference from local development tools. * Moved HTTP request signing to a filter instead of calling it directly. #### Fixed * Allow non-administrator users to use Follow Me and Followers blocks * Correct linking from followers to the following list * Fix avatar rendering for followers with missing icon property * Fix multibyte character corruption in post summaries, preventing Greek and other non-ASCII text from being garbled during text processing. * Informational Fediverse blocks are no longer rendered when posts get added to the Outbox. ### 7.1.0 – 2025-07-23 #### Added * Added a first version of the Follow form, allowing users to follow other Actors by username or profile link. * Added initial support for Fediverse Starter Kits, allowing users to follow recommended accounts from a predefined list. * Ensure that all schedulers are registered during every plugin update. * Followers and Following list tables now support Columns and Pagination screen options. * The featured tags endpoint is now available again for all profiles, showing the most frequently used tags by each user. * The `following` endpoint now returns the actual list of users being followed. #### Changed * Follower tables now look closer to what other tables in WordPress look like. * Improved Account-Aliases handling by internally normalizing input formats. * Minor performance improvement when querying posts of various types, by avoiding double queries. * Set older unfederated posts to local visibility by default. * Step counts for the Welcome checklist now only take into account steps that are added in the Welcome class. * Table actions are now faster by using the Custom Post Type ID instead of the remote user URI, thanks to the unified Actor Model. * The following tables now more closely match the appearance of other WordPress tables and can be filtered by status. #### Fixed * Ensure correct visibility handling for `Undo` and `Follow` requests * Ensure that the Actor-ID is always a URL. * Fixed a bug in how follow requests were accepted to ensure they work correctly. * Fixed an issue where the number of followers shown didn’t always match the actual follower list. * Fixed a PHP error that prevented the Follower overview from loading. * Fixed missing avatar class so that CSS styles are correctly applied to ActivityPub avatars on the Dashboard. * Fixed potential errors when unrelated requests get caught in double-knocking callback. * Improved WebFinger fallback to better guess usernames from profile links. * Prevent WordPress from loading all admin notices twice on ActivityPub settings pages. * Removed follower dates to avoid confusion, as they may not have accurately reflected the actual follow time. * Stop purging Follow activities from the Outbox to allow proper Unfollow (Undo) handling. ### 7.0.1 – 2025-07-10 #### Fixed * When deleting interactions for cleaned up actors, we use the actor’s URL again to retrieve their information instead of our internal ID. ### 7.0.0 – 2025-07-09 #### Added * Added basic support for handling remote rejections of follow requests. * Added basic support for RFC-9421 style signatures for incoming activities. * Added initial Following support for Actors, hidden for now until plugins add support. * Added missing “Advanced Settings” details to Site Health debug information. * Added option to auto-approve reactions like likes and reposts. * Added support for namespaced attributes and the dcterms:subject field (FEP-b2b8), as a first step toward phasing out summary-based content warnings. * Added support for the WP Rest Cache plugin to help with caching REST API responses. * Documented support for FEP-844e. * Optional support for RFC-9421 style signatures for outgoing activities, including retry with Draft-Cavage-style signature. * Reactions block now supports customizing colors, borders, box-shadows, and typography. * Support for sending follow requests to remote actors is now in place, including outbox delivery and status updates—UI integration will follow later. #### Changed * Comment feeds now show only comments by default, with a new `type` filter (e.g., `like`, `all`) to customize which reactions appear. * Consistent naming of Blog user in Block settings. * hs2019 signatures for incoming REST API requests now have their algorithm determined based on their public key. * Likes, comments, and reposts from the Fediverse now require either a name or `preferredUsername` to be set when the Discussion option `require_name_email` is set to true. It falls back to “Anonymous”, if not. * Management of public/private keys for Actors now lives in the Actors collection, in preparation for Signature improvements down the line. * Notification emails for new reactions received from the Fediverse now link to the moderation page instead of the edit page, preventing errors and making comment management smoother. * Plugins now have full control over which Settings tabs are shown in Settings > Activitypub. * Reworked follower structure to simplify handling and enable reuse for following mechanism. * Screen options in the Activitypub settings page are now filterable. * Setting the blog identifier to empty will no longer trigger an error message about it being the same as an existing user name. * Step completion tracking in the Welcome tab now even works when the number of steps gets reduced. * The image attachment setting is no longer saved to the database if it matches the default value. * The welcome page now links to the correct profile when Blog Only mode was selected in the profile mode step. * Unified retrieval of comment avatars and re-used core filters to give access to third-part plugins. #### Fixed * Allow interaction redirect URLs that contain an ampersand. * Comments received from the Fediverse no longer show an Edit link in the comment list, despite not being editable. * Fixed an issue where links to remote likes and boosts could open raw JSON instead of a proper page. * Fixed a potential error when getting an Activitypub ID based on a user ID. * HTTP signatures using the hs2019 algorithm now get accepted without error. * Improved compatibility with older follower data. * Inbox requests that are missing an `algorithm` parameter in their signature no longer create a PHP warning. * Interaction attempts that pass a webfinger ID instead of a URL will work again. * Names containing HTML entities now get displayed correctly in the Reactions block’s list of users. * Prevent storage of empty or default post meta values. * The amount of avatars shown in the Reactions block no longer depends on the amount of likes, but is comment type agnostic. * The command-line interface extension, accidentally removed in a recent cleanup, has been restored. * The image attachment setting now correctly respects a value of 0, instead of falling back to the default. * The Welcome screen now loads with proper styling when shown as a fallback. * Using categories as hashtags has been removed to prevent conflicts with tags of the same name. * When verifying signatures on incoming requests, the digest header now gets checked as expected. See full Changelog on GitHub.