basic co entity functions