add public interface for promoting values onto entities