diff --git a/BREAKING.md b/BREAKING.md
index e2ac3d26b3..3e1c997dbf 100644
--- a/BREAKING.md
+++ b/BREAKING.md
@@ -470,6 +470,40 @@ The `menuToggle` attribute should not be added to an element anymore. Elements t
 
 ## Item Sliding
 
+### Markup Changed
+
+The option component should not be written as a `button` with an `ion-button` directive anymore. It should be written as an `ion-item-option`. This will render a native button element inside of it.
+
+**Old Usage Example:**
+
+```html
+<ion-item-sliding>
+  <ion-item>
+    Item 1
+  </ion-item>
+  <ion-item-options side="right">
+    <button ion-button expandable>
+      <ion-icon name="star"></ion-icon>
+    </button>
+  </ion-item-options>
+</ion-item-sliding>
+```
+
+**New Usage Example:**
+
+```html
+<ion-item-sliding>
+  <ion-item>
+    <ion-label>Item 1</ion-label>
+  </ion-item>
+  <ion-item-options side="right">
+    <ion-item-option expandable>
+      <ion-icon name="star"></ion-icon>
+    </ion-item-option>
+  </ion-item-options>
+</ion-item-sliding>
+```
+
 ### Method Renamed
 
 The `getSlidingPercent` method has been renamed to `getSlidingRatio` since the function is returning a ratio of the open amount of the item compared to the width of the options.