diff --git a/BREAKING.md b/BREAKING.md
index f88688db4d..97183f9cbc 100644
--- a/BREAKING.md
+++ b/BREAKING.md
@@ -928,22 +928,71 @@ $app-md-statusbar-padding: 20px;
### Attributes Renamed
-The attributes to position an `ion-buttons` element inside of a toolbar have been renamed, as well as the behavior attached to the name. We noticed there was some confusion behind the behavior of the `start` and `end` attributes, and with the new support for RTL we wanted to make the behavior of these match RTL. In order to do this we had to rename the old `start`/`end` to something that makes more sense with their behavior.
+The attributes to position an `ion-buttons` element inside of a toolbar have been either removed or renamed, as well as the behavior of the attributes. We noticed there was some confusion behind the behavior of the `start` and `end` attributes, and with the new support for RTL we wanted to make these match RTL. In order to do this we have removed the old functionality behind the `start`/`end` attributes and renamed the `left`/`right` attributes.
-The names and behavior of each of the properties was previously:
+**Old Properties:**
-| Old Property | Property Behavior |
-|--------------|--------------------------------------------------------------------------------------------------------------|
-| `start` | Positions element to the left of the content in `ios` mode, and directly to the right in `md` and `wp` mode. |
-| `end` | Positions element to the right of the content in `ios` mode, and to the far right in `md` and `wp` mode. |
-| `left` | Positions element to the left of all other elements. |
-| `right` | Positions element to the right of all other elements. |
+| Old Property | Old Behavior |
+|--------------|------------------------------------------------------------------------------------------------------------------|
+| `start` | Positions element to the `left` of the content in `ios` mode, and directly to the `right` in `md` and `wp` mode. |
+| `end` | Positions element to the `right` of the content in `ios` mode, and to the far `right` in `md` and `wp` mode. |
+| `left` | Positions element to the `left` of all other elements. |
+| `right` | Positions element to the `right` of all other elements. |
-The properties have been renamed to the following:
+**New Properties:**
-| Old Property | New Property | Property Behavior |
-|--------------|---------------------|------------------------------------------------------------------------------------------------------------------|
-| `start` | `slot="mode-start"` | Positions element to the `left` of the content in `ios` mode, and directly to the `right` in `md` and `wp` mode. |
-| `end` | `slot="mode-end"` | Positions element to the `right` of the content in `ios` mode, and to the far right in `md` and `wp` mode. |
-| `left` | `slot="start"` | Positions element to the `left` of all other elements in `LTR`, and to the `right` in `RTL`. |
-| `right` | `slot="end"` | Positions element to the `right` of all other elements in `LTR`, and to the `left` in `RTL`. |
+| New Property | New Behavior |
+|------------------|--------------------------------------------------------------------------------------------------------------|
+| `slot="start"` | Positions element to the `left` of all other elements in `LTR`, and to the `right` in `RTL`. |
+| `slot="end"` | Positions element to the `right` of all other elements in `LTR`, and to the `left` in `RTL`. |
+
+
+**Old Usage Example:**
+
+```html
+
+
+
+
+
+
+ Filter Sessions
+
+
+
+
+
+
+```
+
+**New Usage Example:**
+
+```html
+
+
+ Cancel
+
+
+
+ Filter Sessions
+
+
+
+ Done
+
+
+```
+
+If you need to position buttons based on the mode, we recommend something like the following:
+
+```html
+
+
+ Cancel
+
+
+
+ Filter Sessions
+
+
+```
diff --git a/core/src/components/button/test/toolbar/index.html b/core/src/components/button/test/toolbar/index.html
index 2e34aea1d2..c0475527dd 100644
--- a/core/src/components/button/test/toolbar/index.html
+++ b/core/src/components/button/test/toolbar/index.html
@@ -6,7 +6,7 @@
-
+
@@ -25,7 +25,7 @@
-
+
@@ -33,7 +33,7 @@
-
+
@@ -42,7 +42,7 @@
-
+
Close
@@ -50,7 +50,7 @@
-
+
@@ -59,7 +59,7 @@
-
+
@@ -67,7 +67,7 @@
-
+
@@ -76,7 +76,7 @@
-
+
@@ -84,7 +84,7 @@
-
+
@@ -93,7 +93,7 @@
-
+
@@ -103,7 +103,7 @@
Solid
-
+
Help
@@ -112,7 +112,7 @@
-
+
@@ -122,7 +122,7 @@
Solid Activated
-
+
Help
@@ -131,7 +131,7 @@
-
+
@@ -140,7 +140,7 @@
Star
-
+
@@ -149,7 +149,7 @@
-
+
@@ -158,7 +158,7 @@
Star
-
+
@@ -167,13 +167,13 @@
-
+
Clear
-
+
Edit
@@ -183,12 +183,12 @@
-
+
Go Back
-
+
Edit
@@ -200,7 +200,7 @@
-
+
@@ -209,7 +209,7 @@
-
+
@@ -221,7 +221,7 @@
-
+
@@ -252,5 +252,20 @@
+
+
diff --git a/core/src/components/toolbar/test/basic/index.html b/core/src/components/toolbar/test/basic/index.html
index 49c5ac1818..7511a166f3 100644
--- a/core/src/components/toolbar/test/basic/index.html
+++ b/core/src/components/toolbar/test/basic/index.html
@@ -6,30 +6,144 @@
-
+
+
+
+ Toolbar
+
-
-
- Toolbar - Basic
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Subheader
+
+
-
- Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec vitae lobortis felis, eu sodales enim. Nam risus nibh, placerat at rutrum ac, vehicula vel velit. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vestibulum quis elementum ligula, ac aliquet nulla. Mauris non placerat mauris. Aenean dignissim lacinia porttitor. Praesent fringilla at est et ullamcorper. In ac ante ac massa porta venenatis ut id nibh. Fusce felis neque, aliquet in velit vitae, venenatis euismod libero. Donec vulputate, urna sed sagittis tempor, mi arcu tristique lacus, eget fringilla urna sem eget felis. Fusce dignissim lacus a scelerisque vehicula. Nulla nec enim nunc.
+
+
+
+ Card Header
+
+
+
+ Title
+
+ Some normal text in content.
+
h3 in content
+
+ Paragraph in content.
+
+
+ Another paragraph in content.
+
+
+
- Quisque nec dui eu nibh pulvinar bibendum quis ut nunc. Duis ex odio, sollicitudin ac mollis nec, fringilla non lacus. Maecenas sed tincidunt urna. Nunc feugiat maximus venenatis. Donec porttitor, felis eget porttitor tempor, quam nulla dapibus nisl, sit amet posuere sapien sapien malesuada tortor. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Quisque luctus, sapien nec tincidunt efficitur, nibh turpis faucibus felis, in sodales massa augue nec erat. Morbi sollicitudin nisi ex, et gravida nisi euismod eu. Suspendisse hendrerit dapibus orci, non viverra neque vestibulum id. Quisque vitae interdum ligula, quis consectetur nibh.
+
+
+ Card Header
+
+
+
+ Title
+
+ Some normal text in content.
+
h3 in content
+
+ Paragraph in content.
+
+
+ Another paragraph in content.
+
+
+
- Phasellus in mi at erat ultrices semper. Fusce sollicitudin at dolor ac lobortis. Morbi sit amet sem quis nulla pellentesque imperdiet. Nullam eu sem a enim maximus eleifend non vulputate leo. Proin quis congue lacus. Pellentesque placerat, quam at tempus pulvinar, nisl ligula tempor risus, quis pretium arcu odio et nulla. Nullam mollis consequat pharetra. Phasellus dictum velit sed purus mattis maximus. In molestie eget massa ut dignissim. In a interdum elit. In finibus nibh a mauris lobortis aliquet. Proin rutrum varius consequat. In mollis dapibus nisl, eu finibus urna viverra ac. Quisque scelerisque nisl eu suscipit consectetur.
-
+
+
+ Card Header
+
+
+
+ Title
+
+ Some normal text in content.
+
h3 in content
+
+ Paragraph in content.
+
+
+ Another paragraph in content.
+
+
+
-
-
- Footer Toolbar
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Footer
+
+
+
+
+
+
+
diff --git a/core/src/components/toolbar/test/scenarios/index.html b/core/src/components/toolbar/test/scenarios/index.html
index 7c0d17a95c..a1b1678101 100644
--- a/core/src/components/toolbar/test/scenarios/index.html
+++ b/core/src/components/toolbar/test/scenarios/index.html
@@ -6,239 +6,249 @@
-
+
+
+
+ This should have no padding
+
-
-
- This should have no padding
-
+
+ This is the title that never ends. It just goes on and on my friend.
+
-
- This is the title that never ends. It just goes on and on my friend.
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ This is a long title with buttons. It just goes on and on my friend.
+
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Defaults
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Defaults.activated
+
+
+
+
+
+
+
+
+
+ Solid
+
+
+ Solid
+
+
+ Help
+
+
+
+
+
+
+
+
+
+
+
+
+ Solid
+
+
+ Solid Activated
+
+
+ Help
+
+
+
+
+
+
+
+
+
+
+
+
+ Star
+
+
+
+
+
+
+
+ Outline
+
+
+
+
+
+
+
+
+
+ Star
+
+
+
+
+
+
+
+ Outline.activated
+
+
+
+
+
+
+ Clear
+
+
+
+
+ Edit
+
+
+
+ Icon/Color Attr
+
+
+
+
+
+ Go Back
+
+
+
+
+ Edit
+
+
+ Text Only
+
+
+
+
+
-
+
+
+
+
+
+
+
+
+ Left side menu toggle
+
+
+
+
+
+
+
+
+ Right side menu toggle
+
+
-
+
-
-
-
-
-
-
- This is a long title with buttons. It just goes on and on my friend.
-
+
+
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- Defaults
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- Defaults.activated
-
-
-
-
-
-
-
-
-
- Solid
-
-
- Solid
-
-
- Help
-
-
-
-
-
-
-
-
-
-
-
-
- Solid
-
-
- Solid Activated
-
-
- Help
-
-
-
-
-
-
-
-
-
-
-
-
- Star
-
-
-
-
-
-
-
- Outline
-
-
-
-
-
-
-
-
-
- Star
-
-
-
-
-
-
-
- Outline.activated
-
-
-
-
-
-
- Clear
-
-
-
-
- Edit
-
-
-
- Icon/Color Attr
-
-
-
-
-
- Go Back
-
-
-
-
- Edit
-
-
- Text Only
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- Left side menu toggle
-
-
-
-
-
-
-
-
- Right side menu toggle
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- Something
-
-
- Else
-
-
-
-
-
-
-
- Light
-
-
- Toolbar
-
-
- Default Segment
-
-
-
-
+
+
+
+
+
+
+
+
+ Something
+
+
+ Else
+
+
+
+
+
+
+ Light
+
+
+ Toolbar
+
+
+ Default Segment
+
+
+
+