allow callback to modify required contents