rename-clear_children.md

---

title: Renamed `clear_children` and `clear_related` methods to `detach_*`
pull_requests: [21470, 21537]

---

In summary, we renamed clear_* and remove_* methods to detach_*. This should clarify that these methods do not despawn the child entities or related entities.

We renamed several related methods on both EntityCommands and EntityWorldMut:

• The method EntityCommands::clear_children has been renamed to EntityCommands::detach_all_children.

• The method EntityWorldMut::clear_children has been renamed to EntityWorldMut::detach_all_children.

• The method EntityCommands::remove_children has been renamed to EntityCommands::detach_children.

• The method EntityWorldMut::remove_children has been renamed to EntityWorldMut::detach_children.

• The method EntityCommands::remove_child has been renamed to EntityCommands::detach_child.

• The method EntityWorldMut::remove_child has been renamed to EntityWorldMut::detach_child.

• The method EntityCommands::clear_related has been renamed to EntityCommands::detach_all_related.

• The method EntityWorldMut::clear_related has been renamed to EntityWorldMut::detach_all_related.