diff --git a/core/src/components/segment/usage/angular.md b/core/src/components/segment/usage/angular.md
index 2227c474a5..9492d6d283 100644
--- a/core/src/components/segment/usage/angular.md
+++ b/core/src/components/segment/usage/angular.md
@@ -78,6 +78,16 @@
     </ion-segment-button>
   </ion-segment>
 </ion-toolbar>
+
+<!-- Segment with default selection -->
+<ion-segment (ionChange)="segmentChanged($event)" value="javascript">
+  <ion-segment-button value="python">
+    <ion-label>Python</ion-label>
+  </ion-segment-button>
+  <ion-segment-button value="javascript">
+    <ion-label>Javascript</ion-label>
+  </ion-segment-button>
+</ion-segment>
 ```
 
 ```typescript
diff --git a/core/src/components/segment/usage/javascript.md b/core/src/components/segment/usage/javascript.md
index 52b844b40a..ff167b7f5f 100644
--- a/core/src/components/segment/usage/javascript.md
+++ b/core/src/components/segment/usage/javascript.md
@@ -78,6 +78,16 @@
     </ion-segment-button>
   </ion-segment>
 </ion-toolbar>
+
+<!-- Segment with default selection -->
+<ion-segment value="javascript">
+  <ion-segment-button value="python">
+    <ion-label>Python</ion-label>
+  </ion-segment-button>
+  <ion-segment-button value="javascript">
+    <ion-label>Javascript</ion-label>
+  </ion-segment-button>
+</ion-segment>
 ```
 
 ```javascript