WpStream 4.15.1 has 50 actions and 59 filters, read directly from its source code on Nov 18, 2026. The list updates automatically when a new version is released.
How to use these hooks
Actions let you run your own code at a specific moment. Filters let you change a value before the plugin uses it. Put your code in a child theme's functions.php or a code-snippets plugin, never in the plugin's own files, because updates overwrite them.
// Run your own code when WpStream fires an action
add_action( 'wpstream_onboarding_step_completed', function( $arg1, $post_id, $arg3 ) {
// Your code runs here.
}, 10, 3 );
// Change a value WpStream is about to use
add_filter( 'wpstream_account_list_item_html', function( $html, $product_id, $arg3 ) {
// Change $html here.
return $html;
}, 10, 3 );Parts of a name in {braces} are filled in at runtime (for example a post type or field ID). Choose Example on any hook for a ready-to-edit snippet.
Changes by version
4.15 → 4.15.1 · Nov 18, 2026 · 0 added, 0 removed
No hooks were added or removed in this release.
All hooks
-
/** * Fires when an onboarding step creates Streaming Content. */ do_action( 'wpstream_onboarding_step_completed', 'live_free', $post_id, 'live_channel' ); -
/** * This filter is documented in templates/myaccount/video_list.php */ apply_filters( 'wpstream_account_list_item_html', $html, $product_id, 'event_list' ); -
/** * Filters the WP HTTP args of an outgoing WpStream API request. */ apply_filters( 'wpstream_api_request_args', $args, $endpoint ); -
/** * Fires when a dashboard save moved a channel between free and paid. */ do_action( 'wpstream_channel_access_changed', intval( $postID ), $access, $previous_access ); -
/** * Fires when a live channel stops streaming (counterpart of * wpstream_channel_became_active). Guarded by the previously stored status, so * it fires once per live session — repeat polls after the stop see a * non-active previous status and do not re-fire it. */ do_action( 'wpstream_channel_became_inactive', $channel_id, $response, $notes ); -
/** * Fires after a channel's own (customized) settings were saved, before they * are pushed to Baker. */ do_action( 'wpstream_channel_settings_saved', $channel_id, $submitted, $previous ); -
/** * Filters how many live channels one non-admin user may own. */ apply_filters( 'wpstream_max_channels_per_user', $value, $owner_id ); -
/** * Filter the WooCommerce features a WpStream product type supports. */ apply_filters( 'wpstream_product_supports', $this->supports, 'live_stream' ); -
/** * Fires after WpStream account credentials were accepted and saved. */ do_action( 'wpstream_account_connected', $username ); -
/** * Fires after the WpStream account was logged out. */ do_action( 'wpstream_account_disconnected', $previous_username ); -
/** * Filter the products listed on a My Account tab. */ apply_filters( 'wpstream_account_list_products', $product_ids, $context, $user_id ); -
/** * Fires after the My Account event list, in the theme-renderer and the * fallback branch. */ do_action( 'wpstream_after_account_event_list', $wpstream_account_user_id ); -
/** * Fires after the My Account video list, in the theme-renderer and the * fallback branch. */ do_action( 'wpstream_after_account_video_list', $wpstream_account_user_id ); -
/** * Fires after one Media List item, in the free and the paid branch. */ do_action( 'wpstream_after_media_list_item', $post_id, $kind, $options ); -
/** * Filter the address allowed to fetch the channel's HLS keys. */ apply_filters( 'wpstream_allow_key_access_from', $detected, (int) $channel_id ); -
/** * Fires when the WpStream account could not be authenticated (wrong or revoked * credentials, API down). */ do_action( 'wpstream_api_authentication_failed' ); -
/** * Fires when the API connection outcome changes (healthy ↔ failing). */ do_action( 'wpstream_api_connection_state_changed', $marker, $previous ); -
/** * Fires when a call to the WpStream API failed (transport, HTTP status or * malformed body). */ do_action( 'wpstream_api_request_failed', $error, (string) $endpoint ); -
/** * Fires before the My Account event list, in the theme-renderer and the * fallback branch. */ do_action( 'wpstream_before_account_event_list', $wpstream_account_user_id ); -
/** * Fires before the My Account video list, in the theme-renderer and the * fallback branch. */ do_action( 'wpstream_before_account_video_list', $wpstream_account_user_id ); -
/** * Fires before one Media List item, in the free and the paid branch. */ do_action( 'wpstream_before_media_list_item', $post_id, $kind, $options ); -
/** * Filters the arguments passed to bp_activity_post_update() for the "went * live" timeline activity. Return an empty array to suppress the activity for * this channel. */ apply_filters( 'wpstream_buddyboss_activity_args', $new_activity, $channel_id ); -
/** * Filter the origin an unlocked channel may be played from. */ apply_filters( 'wpstream_channel_allowed_origin', '*', (int) $channel_id ); -
/** * Filter the channel configuration sent to Baker. */ apply_filters( 'wpstream_channel_baker_configuration', array( 'allow_access_from' => $allowed, 'record' => 1 === $options['record'] ? 'true' : 'false', 'encrypt' => $encrypted, 'low_latency' => $low_latency, 'abr' => $abr_enabled ? 'common' : 'none', 'autostart' => 'true', 'options' => $options, ), (int) $channel_id ); -
/** * Fires when the Channel status transitions to `active` (the broadcaster has * connected). This is NOT "Live": a channel is Live only when it is active AND * a playback URL exists, and the playback URL may not exist yet at this moment * — do not embed a player from this hook. Fires once per live session * (guarded by the previously stored status). */ do_action( 'wpstream_channel_became_active', $channel_id, $response, $notes ); -
/** * Fires once a Live Channel has been Created: the post is published and fully * initialized locally. It is NOT yet Provisioned in the cloud — listen to * `wpstream_channel_provisioned` for that. */ do_action( 'wpstream_channel_created', $content_id, $owner_id ); -
/** * Filter the settings a newly created channel starts with. */ apply_filters( 'wpstream_channel_default_settings', $this->channel_values( $this->storage->read_defaults() ), $channel_id ); -
/** * Fires at the end of the Live Streaming sidebar metabox. */ do_action( 'wpstream_channel_meta_options_after', intval( $post->ID ), $post ); -
/** * Fires when a Live Channel becomes Provisioned: its cloud identity * (`channelId` meta) is persisted and it can be started. Also fires when a * previously failed provisioning is retried successfully. */ do_action( 'wpstream_channel_provisioned', $content_id ); -
/** * Fires when a Live Channel could not obtain its cloud identity. */ do_action( 'wpstream_channel_provisioning_failed', $content_id, $result ); -
/** * Fires when Baker refused to start a channel. */ do_action( 'wpstream_channel_start_failed', intval( $channel_id ), $plumer_error, intval( $userID ) ); -
/** * Filter the metadata sent with channel/start. */ apply_filters( 'wpstream_channel_start_metadata', $metadata_array, (int) $schannel_id ); -
/** * Fires when a go-live request passed ownership and streaming permission, just * before Baker is asked to start the channel. Quota has only been read to pick * the feature tier; it is enforced upstream and an exhausted account surfaces * through wpstream_channel_start_failed. */ do_action( 'wpstream_channel_start_requested', intval( $channel_id ), intval( $userID ), $channel_configuration ); -
/** * Fires when Baker issued the ingest for a channel — earlier than * wpstream_channel_became_active, which waits for the status poll. The ingest * credentials are deliberately not passed. */ do_action( 'wpstream_channel_started', intval( $channel_id ), intval( $userID ) ); -
/** * Fires when Baker refused (or failed) a stop request. */ do_action( 'wpstream_channel_stop_failed', intval( $channel_id ), is_wp_error( $response ) ? array( 'error' => $response->get_error_message() ) : (array) $response ); -
/** * Fires when an authorised stop request is about to be sent to Baker. */ do_action( 'wpstream_channel_stop_requested', intval( $channel_id ), intval( $userID ) ); -
/** * Fires after a Better Messages chat room is created and bound to its content * — on first creation and when a dead room is replaced. */ do_action( 'wpstream_chat_room_created', $chat_post_id, $post_id ); -
/** * Filters the post array used to create the Better Messages chat room bound to * a Live Channel or VOD. */ apply_filters( 'wpstream_chat_room_post_args', $post, $post_id ); -
/** * Filters the Creation Eligibility verdict. */ apply_filters( 'wpstream_creation_eligibility_error', $error, $is_live, $access, $owner_id ); -
/** * Fires after a channel was saved from the front-end dashboard. */ do_action( 'wpstream_dashboard_channel_saved', intval( $postID ), get_current_user_id() ); -
/** * Fires after the site's Default Channel Settings were saved. */ do_action( 'wpstream_default_channel_settings_saved', $validation['values'], array_merge( $this->channel_values( $previous_defaults ), array( 'ses_encrypt' => isset( $previous_defaults['ses_encrypt'] ) ? (int) $previous_defaults['ses_encrypt'] : 0 ) ), get_current_user_id() ); -
/** * Filter the catalog of per-channel options shown as toggles. */ apply_filters( 'wpstream_default_event_options', $this->global_event_options ); -
/** * Fires after a DRM key was delivered. No key material is passed. */ do_action( 'wpstream_drm_key_delivered', $kind, intval( $product_id ), get_current_user_id() ); -
/** * Fires when a DRM key request was refused. */ do_action( 'wpstream_drm_key_denied', $kind, intval( $product_id ), get_current_user_id(), $reason ); -
/** * Filter the HLS key delivery URL prefix. */ apply_filters( 'wpstream_hls_keys_url_prefix', get_site_url() . '?wpstream_livedrm=', (int) $channel_id ); -
/** * Filter the maximum upload size of the dashboard uploader. */ apply_filters( 'wpstream_max_upload_bytes', WPSTREAM_MAX_UPLOAD_BYTES, (string) $button_id, get_current_user_id() ); -
/** * Filter the complete Media List markup. */ apply_filters( 'wpstream_media_list_html', $html, $kind, $options, $query ); -
/** * Filter one Media List item. */ apply_filters( 'wpstream_media_list_item_html', $item, $post_id, $kind ); -
/** * Filter the WP_Query arguments of a Media List before it runs. */ apply_filters( 'wpstream_media_list_query_args', $query_args, $kind, $options ); -
/** * Filter the attributes of the [wpstream_list_media_channels] and * [wpstream_list_media_vod] shortcodes before the list renders. */ apply_filters( 'wpstream_media_list_shortcode_atts', $attributes, $kind ); -
/** * Fires after the cloud accepted a completed multipart VOD upload. */ do_action( 'wpstream_multipart_upload_completed', $file_name, $handle, $parts ); -
/** * Filter the "not live" overlay rendered inside the in-page live player. */ apply_filters( 'wpstream_not_live_html', $not_live_html, intval( $channel_id ), $state ); -
/** * Filter the "we are not live" message. */ apply_filters( 'wpstream_not_live_message', $message, intval( $channel_id ) ); -
/** * Fires after a playback session was issued to a viewer. */ do_action( 'wpstream_playback_session_issued', $product_id, get_current_user_id(), intval( $ttl ) ); -
/** * Filter whether the plugin inserts its player into the page automatically. */ apply_filters( 'wpstream_player_auto_insert', $enabled, $post_id, $context ); -
/** * Filter the complete player markup before it is returned to the caller. */ apply_filters( 'wpstream_player_html', $html, $content_id, $intent ); -
/** * Filter a localized player config object. */ apply_filters( 'wpstream_player_js_config', array_diff_key( $config, $nonces ), $object_name ); -
/** * Filter the player logo / watermark image URL. */ apply_filters( 'wpstream_player_logo', $logo, intval( $product_id ) ); -
/** * Filter the player logo placement. */ apply_filters( 'wpstream_player_logo_data', array( 'player_logo_src' => $player_logo_src, 'player_logo_position' => $player_logo_position, 'player_logo_opacity' => $player_logo_opacity, ), intval( $product_id ) ); -
/** * Filter the whole access notice block shown in place of the player. */ apply_filters( 'wpstream_player_not_entitled_html', $html, $product_id, $reason ); -
/** * Filter the wording of the access notice shown in place of the player. */ apply_filters( 'wpstream_player_not_entitled_message', $message, $product_id, $reason ); -
/** * Filter the player poster image URL. */ apply_filters( 'wpstream_player_poster_url', $url, intval( $content_id ) ); -
/** * Re-route the resolved presentation intent for one piece of content. */ apply_filters( 'wpstream_player_render_intent', $intent, $content_id ); -
/** * Fires once after the player markup for one piece of content was built. */ do_action( 'wpstream_player_rendered', $content_id, $intent, $this->engine( $content_id, $intent ) ); -
/** * Filter the registration arguments of one plugin post type. */ apply_filters( 'wpstream_post_type_args', $args, $fields['slug'] ); -
/** * Filter the list of post type definitions the plugin registers. */ apply_filters( 'wpstream_post_type_definitions', $post_types_fields ); -
/** * Filter the product-type slug => WC_Product subclass map. */ apply_filters( 'wpstream_product_class_map', array( 'live_stream' => 'WC_Product_Live_Stream', 'video_on_demand' => 'WC_Product_Video_On_Demand', ) ); -
/** * Fires when a quota refresh failed and the retry cool-down started; any * previously cached payload is kept. */ do_action( 'wpstream_quota_refresh_failed', $context ); -
/** * Fires after fresh quota data was fetched and cached. Listeners compare * consecutive snapshots to notice a pack running out. */ do_action( 'wpstream_quota_refreshed', $quota_data, $context ); -
/** * Fires after the cloud confirmed a recording was deleted. */ do_action( 'wpstream_recording_deleted', $video_name ); -
/** * Filter the cloud recordings listing shown on the Recordings screen. */ apply_filters( 'wpstream_recordings_list', $response ); -
/** * Fires after the plugin registered its metaboxes for the edit screen. */ do_action( 'wpstream_registered_metaboxes', intval( $post_id ), $post ); -
/** * Filter the structured data emitted for a WpStream singular view. */ apply_filters( 'wpstream_seo_schema', $this->build_schema( $post ), $post ); -
/** * Filter the settings field definitions. */ apply_filters( 'wpstream_settings_fields', $this->wpstream_settings_fields(), $active_tab ); -
/** * Fires inside the options wrapper of a settings tab, after its fields. */ do_action( "wpstream_settings_tab_{$active_tab}", $active_tab ); -
/** * Filter the settings tabs. */ apply_filters( 'wpstream_settings_tabs', array( 'general_options' => esc_html__( 'General Options', 'wpstream' ), 'default_options' => esc_html__( 'Default Channel Settings', 'wpstream' ), 'default_options_vod' => esc_html__( 'VOD Settings', 'wpstream' ), 'subscription_options' => esc_html__( 'Subscription Options', 'wpstream' ), 'messages_options' => esc_html__( 'Customize Messages', 'wpstream' ), 'support_tab' => esc_html__( 'Suppor... ); -
/** * Fires when a creation command is refused or could not be completed. */ do_action( 'wpstream_streaming_content_creation_failed', $error, $request ); -
/** * Filter the creation command before it is validated. */ apply_filters( 'wpstream_streaming_content_creation_request', (array) $request ); -
/** * Filter the post the Streaming Content item is stored as. */ apply_filters( 'wpstream_streaming_content_post_args', array( 'post_title' => $title, 'post_content' => '', 'post_status' => 'publish', 'post_type' => $post_type, 'post_author' => $owner_id, ), $request ); -
/** * Filter the registration arguments of one plugin taxonomy. */ apply_filters( 'wpstream_taxonomy_args', $args, $tax_fields['taxonomy'], (array) $tax_fields['post_types'] ); -
/** * Filter the pre-roll trailer URL. */ apply_filters( 'wpstream_trailer_url', $url, intval( $content_id ) ); -
/** * Filter the upload types the dashboard uploader accepts. */ apply_filters( 'wpstream_upload_allowed_mimes', $mimes, (string) $button_id ); -
/** * Fires after a dashboard upload was stored as an attachment. */ do_action( 'wpstream_upload_completed', intval( $attachment['id'] ), (string) $button_id, get_current_user_id() ); -
/** * Filters whether the current (logged-in) user may broadcast. */ apply_filters( 'wpstream_user_can_stream', $can, intval( $current_user->ID ) ); -
/** * Filters whether the current viewer may watch a product. */ apply_filters( 'wpstream_user_is_entitled', wpstream_user_entitled_for_product_rule( $product_id ), $product_id, get_current_user_id() ); -
/** * Fires once a VOD has been Created: the post is published and its source * recording is attached. VODs need no cloud provisioning. */ do_action( 'wpstream_vod_created', $content_id, $owner_id ); -
/** * Fires at the end of the Video On Demand Settings metabox. */ do_action( 'wpstream_vod_meta_options_after', intval( $post->ID ), $post ); -
apply_filters( "{$tax_fields['taxonomy']}_args", $args ); -
apply_filters( 'bp_core_template_plugin', 'members/single/plugins' ); -
apply_filters( 'bp_stream_filter', $template ); -
do_action( 'bs_after_primary' ); -
apply_filters( 'redux_demo_opt_name', $wpstream_opt_name ); -
do_action( 'set_current_user' ); -
apply_filters( 'widget_comments_args', array( 'number' => $number, 'status' => 'approve', 'post_status' => 'publish', ), $instance ); -
apply_filters( 'widget_title', $title, $instance, $this->id_base ); -
do_action( 'wpstream_after_broadcaster_page', (int) $channel_id, $is_onboarding ); -
apply_filters( 'wpstream_author_content_simple_post_type_message', '', $post_type ); -
do_action( 'wpstream_before_broadcaster_page', (int) $channel_id, $is_onboarding ); -
do_action( 'wpstream_broadcaster_settings_panel_after', (int) $id ); -
do_action( 'wpstream_broadcaster_settings_panel_before', (int) $id ); -
apply_filters( 'wpstream_live_channel_embed_ancestor', $this->wpstream_get_site_origin_for_embed(), $live_channel_id ); -
apply_filters( 'wpstream_live_channel_validate_playback_session_url', $this->playback_session->wpstream_get_default_validate_playback_session_url( (int) $channel_id ), $live_channel_id ); -
apply_filters( 'wpstream_playback_session_ttl_seconds', 10 * MINUTE_IN_SECONDS ); -
apply_filters( 'wpstream_playback_session_validation_available', $available, $host ); -
do_action( 'wpstream_settings_saved', $active_tab, $saved_options, $previous_options ); -
apply_filters( 'wpstream_show_sidebar_for_post_type', false, $post_type ); -
apply_filters( 'wpstream_vod_embed_ancestor', $this->wpstream_get_site_origin_for_embed(), $product_id ); -
do_action( 'wpstream_vod_title_overlay', $overlay_id, $title_text, esc_html__( 'Playing:', 'wpstream' ) ); -
apply_filters( 'wpstream_vod_validate_playback_session_url', $this->playback_session->wpstream_get_default_validate_playback_session_url( (int) $product_id ), $product_id );
Generated from WpStream's GPL-licensed source code. Hooks inside bundled third-party libraries are not listed.
Done for you
Rather have it built for you?
Tell us what should change and we’ll write and test the code using these hooks.
Custom hook snippet
from $49
A small, update-safe change built on the plugin’s own hooks.
- Code written against the plugin’s actions and filters
- Tested on a staging copy of your site
- Install instructions included
Typical turnaround: 2–3 business days
Choose thisPlugin customisation
from $149
New features or changed behaviour, without editing the plugin’s files.
- Built as a companion plugin, so updates never wipe it
- Exact quote before we start
- Tested on staging, then deployed
Typical turnaround: 3–7 business days
Choose thisNot sure which fits? Describe what you need and we’ll suggest the simplest option.
Can't find the right hook?
We can build the customisation for you. Describe what you need: