{"id":920,"date":"2026-10-18T13:14:04","date_gmt":"2026-10-18T13:14:04","guid":{"rendered":"http:\/\/plugin-docs.com\/?post_type=doc&p=920"},"modified":"2026-10-18T13:27:13","modified_gmt":"2026-10-18T13:27:13","slug":"trigger-workflows-post-status-updates","status":"publish","type":"doc","link":"https:\/\/dragwyb.com\/docs\/trigger-workflows-post-status-updates\/","title":{"rendered":"Trigger Workflows on Post Status Updates"},"content":{"rendered":"\n

The On Post Status Update<\/strong> trigger is available in the WordPress Post<\/strong> group in the AI Agent Workflows editor. It starts a workflow when WordPress fires the transition_post_status<\/code> hook. The exact timing depends on the event represented by that hook.<\/p>\n\n\n\n

Screenshot to add: [Workflow editor showing the On Post Status Update trigger and its configuration]<\/p>\n\n\n

When this trigger fires<\/h2>\n\n\n

This trigger listens to the transition_post_status<\/code> hook. Several post-related hooks can fire during a single editing or publishing operation; choose the one that matches the point in the lifecycle when you need the workflow to start.<\/p>\n\n\n

Data available to later nodes<\/h2>\n\n\n

For recognized post hooks, the plugin normalizes the event into fields such as source<\/code>, event<\/code>, post_id<\/code>, post_title<\/code>, post_content<\/code>, post_content_text<\/code>, post_excerpt<\/code>, post_status<\/code>, post_type<\/code>, post_name<\/code>, post_author<\/code>, post_date<\/code>, post_modified<\/code>, and post_parent<\/code> when the corresponding post data is available. Some hooks add event-specific values, such as old and new status or an update flag. Inspect a captured sample in the editor before relying on a particular field.<\/p>\n\n\n

Configure the trigger<\/h2>\n\n\n
    \n\n
  1. Open the workflow in the visual editor and open the node picker.<\/li>\n\n\n
  2. Select WordPress<\/strong>, then the Post<\/strong> group, and add On Post Status Update<\/strong>.<\/li>\n\n\n
  3. If the node exposes Post Types<\/strong>, leave it empty to include supported posts, pages, and custom post types, or enter comma-separated slugs such as post,page<\/code>. Internal WordPress content types are skipped.<\/li>\n\n\n
  4. Save the workflow and test the relevant event on a test site or with non-critical content. Inspect the trigger sample before mapping values to later nodes.<\/li>\n\n<\/ol>\n\n\n

    Source hook<\/h2>\n\n\n

    Catalog hook: transition_post_status<\/code>. This reference describes the trigger registration in the supplied plugin source; it does not claim that a live event has been tested.<\/p>\n\n","protected":false},"excerpt":{"rendered":"

    Start a workflow when a post, page, or supported custom post type changes status. Review old and new status values and map post fields into later steps.<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":956,"menu_order":0,"template":"","class_list":["post-920","doc","type-doc","status-publish","hentry"],"acf":[],"_links":{"self":[{"href":"https:\/\/dragwyb.com\/docs\/wp-json\/wp\/v2\/doc\/920","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/dragwyb.com\/docs\/wp-json\/wp\/v2\/doc"}],"about":[{"href":"https:\/\/dragwyb.com\/docs\/wp-json\/wp\/v2\/types\/doc"}],"author":[{"embeddable":true,"href":"https:\/\/dragwyb.com\/docs\/wp-json\/wp\/v2\/users\/1"}],"version-history":[{"count":1,"href":"https:\/\/dragwyb.com\/docs\/wp-json\/wp\/v2\/doc\/920\/revisions"}],"predecessor-version":[{"id":971,"href":"https:\/\/dragwyb.com\/docs\/wp-json\/wp\/v2\/doc\/920\/revisions\/971"}],"up":[{"embeddable":true,"href":"https:\/\/dragwyb.com\/docs\/wp-json\/wp\/v2\/doc\/956"}],"wp:attachment":[{"href":"https:\/\/dragwyb.com\/docs\/wp-json\/wp\/v2\/media?parent=920"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}