diff --git a/manual/new/docs/en/working-with-objects/component-overview/record.txt b/manual/new/docs/en/working-with-objects/component-overview/record.txt
index 383e19c4d..c975273d7 100644
--- a/manual/new/docs/en/working-with-objects/component-overview/record.txt
+++ b/manual/new/docs/en/working-with-objects/component-overview/record.txt
@@ -204,6 +204,16 @@ $user->save();
 $user->id; // 1
 </code>
 
+++++ Mapping custom values
+
+There might be situations where you want to map custom values to records. For example values that depend on some outer sources and you only want these values to be availible at runtime not persisting those values into database. This can be achieved as follows:
+
+<code type="php">
+$user->mapValue('isRegistered', true);
+
+$user->isRegistered; // true
+</code>
+
 
 ++++ Serializing