update docs for json mass assignment

marvil07-adapt · Oct 2, 2020 · e61c0bb · e61c0bb
1 parent 81f8727
commit e61c0bb
Showing 1 changed file with 13 additions and 0 deletions.
diff --git a/eloquent.md b/eloquent.md
@@ -547,6 +547,19 @@ If you already have a model instance, you may use the `fill` method to populate
 
     $flight->fill(['name' => 'Flight 22']);
 
+#### Mass Assignment & JSON Columns
+
+When assigning JSON columns, each column mass-assignable key must be specified in your model's `$fillable` array. For security, Laravel does not support updating nested JSON attributes when using the `guarded` property:
+
+    /**
+     * The attributes that are mass assignable.
+     *
+     * @var array
+     */
+    $fillable = [
+        'options->enabled',
+    ];
+
 #### Allowing Mass Assignment
 
 If you would like to make all attributes mass assignable, you may define the `$guarded` property as an empty array: