added safeguard to hierarchy API to avoid confusion