• Knowledge Base
    • All Articles
    • BuddyBoss Platform
    • BuddyBoss Theme
    • BuddyBoss App
    • Integrations
    • Advanced Setup
    • Troubleshooting
    • Release Notes
      • BuddyBoss Platform
      • BuddyBoss Platform Pro
      • BuddyBoss Theme
      • BuddyBoss App
      • BuddyBoss App Plugin
      • Other Products
  • Developers
    • Developer Tutorials
      • Web Development
      • App Development
    • Code Reference
      • Functions
      • Hooks
      • Classes
      • Methods
      • Commands
      • App Codex
    • REST API
      • BuddyBoss Platform
      • BuddyBoss App
    • Font Cheatsheet
    • Github Project
  • Roadmap
  • Go to BuddyBoss
    Contact Support
    Filter
    • Knowledge Base
      • All Articles
      • BuddyBoss Platform
      • BuddyBoss Theme
      • BuddyBoss App
      • Integrations
      • Advanced Setup
      • Troubleshooting
      • Release Notes
        • BuddyBoss Platform
        • BuddyBoss Platform Pro
        • BuddyBoss Theme
        • BuddyBoss App
        • BuddyBoss App Plugin
        • Other Products
    • Developers
      • Developer Tutorials
        • Web Development
        • App Development
      • Code Reference
        • Functions
        • Hooks
        • Classes
        • Methods
        • Commands
        • App Codex
      • REST API
        • BuddyBoss Platform
        • BuddyBoss App
      • Font Cheatsheet
      • Github Project
    • Roadmap
    • Go to BuddyBoss
    Filter
    Filter

    Contents

    • Description
    • Source
    • Changelog
    • Related
    Code Reference Functions bp_settings_action_delete_account()

    bp_settings_action_delete_account()

    Handles the deleting of a user.

    Description

    Source

    File: bp-settings/actions/delete-account.php

    function bp_settings_action_delete_account() {
    	if ( ! bp_is_post_request() ) {
    		return;
    	}
    
    	// Bail if no submit action.
    	if ( ! isset( $_POST['delete-account-understand'] ) ) {
    		return;
    	}
    
    	// Bail if not in settings.
    	if ( ! bp_is_settings_component() || ! bp_is_current_action( 'delete-account' ) ) {
    		return false;
    	}
    
    	// 404 if there are any additional action variables attached
    	if ( bp_action_variables() ) {
    		bp_do_404();
    		return;
    	}
    
    	// Bail if account deletion is disabled.
    	if ( bp_disable_account_deletion() && ! bp_current_user_can( 'delete_users' ) ) {
    		return false;
    	}
    
    	// Nonce check.
    	check_admin_referer( 'delete-account' );
    
    	// Get username now because it might be gone soon!
    	$username = bp_get_displayed_user_fullname();
    
    	// Delete the users account.
    	if ( bp_core_delete_account( bp_displayed_user_id() ) ) {
    
    		// Add feedback after deleting a user.
    		bp_core_add_message( sprintf( __( '%s was successfully deleted.', 'buddyboss' ), $username ), 'success' );
    
    		// Redirect to the root domain.
    		bp_core_redirect( bp_get_root_domain() );
    	}
    }
    

    Expand full source code Collapse full source code

    Changelog

    Changelog
    Version Description
    BuddyPress 1.6.0 Introduced.

    Related

    Uses

    Uses
    Uses Description
    bp-members/bp-members-functions.php: bp_core_delete_account()

    Process account deletion requests.

    bp-members/bp-members-template.php: bp_get_displayed_user_fullname()

    Get the displayed user’s display name.

    bp-core/bp-core-template.php: bp_is_settings_component()

    Check whether the current page is part of the Settings component.

    bp-core/bp-core-template.php: bp_is_current_action()

    Check to see whether the current page matches a given action.

    bp-core/bp-core-template.php: bp_displayed_user_id()

    Get the ID of the currently displayed user.

    bp-core/bp-core-template.php: bp_get_root_domain()

    Return the “root domain”, the URL of the BP root blog.

    bp-core/bp-core-template.php: bp_action_variables()

    Return the value of $bp->action_variables.

    bp-core/bp-core-caps.php: bp_current_user_can()

    Check whether the current user has a given capability.

    bp-core/bp-core-functions.php: bp_is_post_request()

    Return true|false if this is a POST request.

    bp-core/bp-core-functions.php: bp_do_404()

    Trigger a 404.

    bp-core/bp-core-functions.php: bp_core_add_message()

    Add a feedback (error/success) message to the WP cookie so it can be displayed after the page reloads.

    bp-core/bp-core-functions.php: bp_core_redirect()

    Perform a status-safe wp_redirect() that is compatible with BP’s URI parser.

    bp-core/bp-core-options.php: bp_disable_account_deletion()

    Are members able to delete their own accounts?

    Show 8 more uses Hide more uses

    Questions?

    We're always happy to help with code or other questions you might have! Search our developer docs, contact support, or connect with our sales team.

    © 2025 • BuddyBoss