diff --git a/.remarkrc.mjs b/.remarkrc.mjs
index 0da0b1e6a67..bb247faa0db 100644
--- a/.remarkrc.mjs
+++ b/.remarkrc.mjs
@@ -3,6 +3,8 @@
* `mdx/remark` rule in `eslint.config.mjs`.
*/
+import remarkFrontmatter from 'remark-frontmatter';
+
// Schemes such as https: and mailto:, in-page anchors, and protocol-relative URLs.
const NOT_A_PAGE_LINK = /^([a-z][a-z\d+.-]*:|#|\/\/)/i;
@@ -68,6 +70,51 @@ function docLinks() {
};
}
+/**
+ * Every page needs a `description` in its frontmatter. Docusaurus uses it for
+ * the meta description, link previews, and llms.txt. Without it, Docusaurus
+ * builds one from the opening text of the page, which can pick up an import, a
+ * heading id comment, or the first line of a code sample.
+ *
+ * A `` in `
` only sets the meta tag, so it does
+ * not count. Docusaurus skips files and folders starting with `_`, so those
+ * partials are not pages and need no description.
+ */
+function pageDescription() {
+ return (tree, file) => {
+ const report = (reason, place) => {
+ const message = file.message(reason, place);
+ message.source = 'ionic-docs';
+ message.ruleId = 'page-description';
+ };
+ if (file.path?.split(/[\\/]/).some((segment) => segment.startsWith('_'))) return;
+
+ const frontmatter = tree.children[0]?.type === 'yaml' ? tree.children[0].value : '';
+ if (!/^description:\s*\S/m.test(frontmatter)) {
+ report(
+ 'Add a `description` to the frontmatter. Without it, Docusaurus builds one from the opening text of the page.',
+ { line: 1, column: 1 }
+ );
+ }
+
+ for (const node of tree.children) {
+ if (node.type !== 'mdxJsxFlowElement' || node.name !== 'head') continue;
+ for (const child of node.children) {
+ const isDescription = child.name === 'meta' && child.attributes?.some((a) => a.name === 'name' && a.value === 'description');
+ if (isDescription) {
+ report(
+ 'Move this description to the frontmatter `description`. Docusaurus does not read it from ``, so link previews and llms.txt use the opening text of the page instead.',
+ child
+ );
+ }
+ }
+ }
+ };
+}
+
export default {
- plugins: [docLinks],
+ // remark-frontmatter parses the frontmatter as YAML, as Docusaurus does.
+ // Without it, the lint reads it as Markdown, and a `<` in a description
+ // becomes an unclosed JSX tag.
+ plugins: [remarkFrontmatter, docLinks, pageDescription],
};
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index d0ed437a46f..a12dabdee8e 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -200,6 +200,10 @@ The content of the Ionic docs is written as [Markdown](https://commonmark.org/)
`/docs` maps to `docs/index.mdx` through `slug: /` in its frontmatter. Older versions live in `versioned_docs/` and are served under their version, such as `/docs/v8/`.
+Every page needs a `description` in its frontmatter. Docusaurus uses it for the meta description, link previews, and llms.txt, and `npm run lint` flags a page without one. Files and folders whose names start with `_` are not pages, so use that prefix for a file that other pages only import, such as `developing/config/_global.mdx`.
+
+The frontmatter `title` names the page everywhere: its heading, the sidebar, cards, and link previews. To show a longer title only in search results and the browser tab, put it in ``, such as `ion-button: Style Buttons with Custom CSS Properties`. A description in `` has no such use, since Docusaurus only reads it from the frontmatter.
+
Versions listed in [`versions.json`](versions.json) are actively maintained. If your change also applies to one of them, make the same change in its `versioned_docs/version-/` folder. Versions listed in [`versionsArchived.json`](versionsArchived.json) are frozen deployments that are no longer built, so changes to their folders never reach the site.
Markdown links resolve within their own version, but JSX paths such as `` and `useBaseUrl` do not. In an older version, prefix them with the version, such as ``.
diff --git a/docs/angular/add-to-existing.mdx b/docs/angular/add-to-existing.mdx
index 1ab3c14e641..5cd84231b1b 100644
--- a/docs/angular/add-to-existing.mdx
+++ b/docs/angular/add-to-existing.mdx
@@ -1,5 +1,6 @@
---
title: Add to Existing Angular Project
+description: 'Learn how to add Ionic Angular to your existing Angular project. Step-by-step guide for integrating Ionic components and features into an existing Angular application.'
sidebar_label: Add to Existing
---
@@ -8,10 +9,6 @@ import DocsCards from '@components/global/DocsCards';
Add Ionic Angular to Existing Project: Integration Guide
-
This guide covers how to add Ionic Angular to an existing Angular project. If you're looking to start a new project from scratch, check out the [Ionic Angular Quickstart](./quickstart.mdx) guide. For an overview of how Ionic Angular works with Angular, including version support and tooling, check out the [Ionic Angular Overview](./overview.mdx).
diff --git a/docs/angular/build-options.mdx b/docs/angular/build-options.mdx
index a6de6ba6cec..8bf6c014027 100644
--- a/docs/angular/build-options.mdx
+++ b/docs/angular/build-options.mdx
@@ -1,3 +1,7 @@
+---
+description: 'Choose between standalone components and NgModules when using Ionic in an Angular app, with the benefits and downsides of each approach.'
+---
+
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';
diff --git a/docs/angular/injection-tokens.mdx b/docs/angular/injection-tokens.mdx
index 653f5bcadf7..5e2c909d405 100644
--- a/docs/angular/injection-tokens.mdx
+++ b/docs/angular/injection-tokens.mdx
@@ -1,14 +1,11 @@
---
title: Angular Injection Tokens
+description: "Learn how to use Ionic's Angular injection tokens to access Ionic elements through Angular's dependency injection system for more streamlined component interactions."
sidebar_label: Injection Tokens
---
Angular Injection Tokens | Access Ionic Elements via Dependency Injection
-
Ionic provides Angular injection tokens that allow you to access Ionic elements through Angular's dependency injection system. This provides a more Angular-idiomatic way to interact with Ionic components programmatically.
diff --git a/docs/angular/lifecycle.mdx b/docs/angular/lifecycle.mdx
index a8c17e4bf12..6f3d36efc9c 100644
--- a/docs/angular/lifecycle.mdx
+++ b/docs/angular/lifecycle.mdx
@@ -1,14 +1,11 @@
---
title: Ionic Page Life Cycle
+description: 'This guide covers how the page life cycle works in an Ionic app built with Angular. Learn how Ionic embraces life cycle events provided by Angular components.'
sidebar_label: Lifecycle
---
Angular Page Component Life Cycle - App Events Documentation
-
This guide covers how the page life cycle works in an app built with Ionic and Angular.
diff --git a/docs/angular/navigation.mdx b/docs/angular/navigation.mdx
index f1440eac70a..b09cdb7c7b7 100644
--- a/docs/angular/navigation.mdx
+++ b/docs/angular/navigation.mdx
@@ -1,5 +1,6 @@
---
title: Angular Navigation
+description: 'Our Angular Navigation guide covers how routing works in an app built with Ionic and Angular. Read to learn more about basic routing and redirects in Angular.'
sidebar_label: Navigation/Routing
---
@@ -7,10 +8,6 @@ import useBaseUrl from '@docusaurus/useBaseUrl';
Angular Navigation: How Routing & Redirects Work in Angular Apps
-
This guide covers how routing works in an app built with Ionic and Angular.
diff --git a/docs/angular/overlays.mdx b/docs/angular/overlays.mdx
index cbe6a85dbbc..6ceacd67cf8 100644
--- a/docs/angular/overlays.mdx
+++ b/docs/angular/overlays.mdx
@@ -1,14 +1,11 @@
---
title: Overlay Components
+description: 'Learn how to use overlay components like modals and popovers in Ionic Angular, including passing custom injectors for dependency injection.'
sidebar_label: Overlays
---
Angular Overlay Components: Modals, Popovers with Custom Injectors
-
Ionic provides overlay components such as modals and popovers that display content on top of your application. In Angular, these overlays can be created using controllers like `ModalController` and `PopoverController`.
diff --git a/docs/angular/overview.mdx b/docs/angular/overview.mdx
index a19b9752b7f..0ee4c11d1a9 100644
--- a/docs/angular/overview.mdx
+++ b/docs/angular/overview.mdx
@@ -1,14 +1,11 @@
---
title: 'Ionic Angular Overview'
+description: '@ionic/angular combines the Ionic experience with the tooling and APIs tailored to Angular Developers. Learn more about version support in our Angular Overview.'
sidebar_label: Overview
---
Ionic Angular Overview | Angular Version Support and Tooling
-
import DocsCard from '@components/global/DocsCard';
diff --git a/docs/angular/performance.mdx b/docs/angular/performance.mdx
index 0faa660c24d..ffea6580cee 100644
--- a/docs/angular/performance.mdx
+++ b/docs/angular/performance.mdx
@@ -1,14 +1,11 @@
---
title: Angular Performance
+description: 'Learn how Angular manages change propagation using ngFor with Ionic Components. Read for more information about Angular performance on Ionic apps.'
sidebar_label: Performance
---
Angular Performance: Manage App Component Change with ngFor
-
## \*ngFor with Ionic Components {/* #ngfor-with-ionic-components */}
diff --git a/docs/angular/platform.mdx b/docs/angular/platform.mdx
index 55bc767c9c7..3869df3e0ca 100644
--- a/docs/angular/platform.mdx
+++ b/docs/angular/platform.mdx
@@ -1,5 +1,6 @@
---
title: Platform
+description: 'Ionic Platform service can be used to get information about your current device. With this information you can completely customize your app to fit any device.'
---
import Tabs from '@theme/Tabs';
@@ -7,10 +8,6 @@ import TabItem from '@theme/TabItem';
Platform | Ionic Platform to Customize Apps to Fit Any Device
-
The Platform service can be used to get information about your current device. You can get all of the platforms associated with the device using the `platforms` method, including whether the app is being viewed from a tablet, if it's on a mobile device or browser, and the exact platform (iOS, Android, etc). You can also get the orientation of the device, if it uses right-to-left language direction, and much much more. With this information you can completely customize your app to fit any device.
diff --git a/docs/angular/pwa.mdx b/docs/angular/pwa.mdx
index 007acd39449..fcb19ed7b71 100644
--- a/docs/angular/pwa.mdx
+++ b/docs/angular/pwa.mdx
@@ -1,14 +1,11 @@
---
title: Progressive Web Apps in Angular
+description: "When Making an Angular app a Progressive Web App, the two main requirements are a Service Worker and a Web Manifest. Read to learn more in Ionic's PWA tutorial."
sidebar_label: Progressive Web Apps
---
Make Progressive Web Apps (PWA) in Angular - Ionic Tutorial
-
## Making your Angular app a PWA {/* #making-your-angular-app-a-pwa */}
diff --git a/docs/angular/quickstart.mdx b/docs/angular/quickstart.mdx
index 2eeaa67cdd0..e51b2c8501c 100644
--- a/docs/angular/quickstart.mdx
+++ b/docs/angular/quickstart.mdx
@@ -1,14 +1,11 @@
---
title: Ionic Angular Quickstart
+description: 'Ionic Angular Quickstart covers the basics of Angular and Ionic, including any Ionic-specific features. Learn how to build Angular apps using the Ionic CLI.'
sidebar_label: Quickstart
---
Ionic Angular Quickstart Using Ionic CLI: Angular Basics
-
import DocsCard from '@components/global/DocsCard';
diff --git a/docs/angular/slides.mdx b/docs/angular/slides.mdx
index f0999333e5f..4d54aa0fc70 100644
--- a/docs/angular/slides.mdx
+++ b/docs/angular/slides.mdx
@@ -1,5 +1,6 @@
---
title: Migrating from ion-slides to Swiper.js
+description: 'Read this guide to learn how to get Swiper.js for Angular set up in your Ionic Framework application for a modern touch slider component.'
---
import Tabs from '@theme/Tabs';
@@ -7,10 +8,6 @@ import TabItem from '@theme/TabItem';
Set Up Swiper.js for Angular Slides [Example] | Ionic
-
:::warning[Looking for `ion-slides`?]
diff --git a/docs/angular/storage.mdx b/docs/angular/storage.mdx
index f5d1950e58f..84c3fb0a713 100644
--- a/docs/angular/storage.mdx
+++ b/docs/angular/storage.mdx
@@ -1,14 +1,11 @@
---
title: Data Storage
+description: 'A variety of options are available for storing data within Ionic apps made using Angular. Choose the options that best fit your storage needs.'
sidebar_label: Storage
---
Angular App Data Storage Options - Ionic Documentation
-
There are a variety of options available for storing data within an Ionic application. It is best to choose options that best fit the needs of your application. A single application may have requirements that span multiple options.
diff --git a/docs/angular/testing.mdx b/docs/angular/testing.mdx
index 772638118ef..230d0c645e9 100644
--- a/docs/angular/testing.mdx
+++ b/docs/angular/testing.mdx
@@ -1,13 +1,10 @@
---
title: Testing
+description: 'Angular apps created using Ionic are automatically set up for unit and end-to-end testing. Read to learn more about testing tools for Ionic components.'
---
Angular Unit and End-to-End Testing for Ionic App Components
-
When an `@ionic/angular` application is generated using the Ionic CLI, it is automatically set up for unit testing and end-to-end testing of the application:
diff --git a/docs/angular/virtual-scroll.mdx b/docs/angular/virtual-scroll.mdx
index d3b799e1fbc..654f1e76326 100644
--- a/docs/angular/virtual-scroll.mdx
+++ b/docs/angular/virtual-scroll.mdx
@@ -1,3 +1,7 @@
+---
+description: 'ion-virtual-scroll was removed in Ionic 7. Learn how to render long lists in Angular with virtual scrolling from the @angular/cdk package.'
+---
+
# Virtual Scroll
:::warning[Looking for `ion-virtual-scroll`?]
diff --git a/docs/angular/your-first-app.mdx b/docs/angular/your-first-app.mdx
index 8e49383a74f..5db117afba5 100644
--- a/docs/angular/your-first-app.mdx
+++ b/docs/angular/your-first-app.mdx
@@ -1,14 +1,11 @@
---
title: 'Your First Ionic App: Angular'
+description: 'This Angular tutorial teaches the fundamentals of Ionic app development by creating a realistic app step-by-step. Learn to run your first Ionic app with Angular.'
sidebar_label: Build Your First App
---
Build Your First Ionic Mobile App with Angular | Ionic Capacitor Camera
-
The great thing about Ionic is that with one codebase, you can build for any platform using just HTML, CSS, and JavaScript. Follow along as we learn the fundamentals of Ionic app development by creating a realistic app step by step.
diff --git a/docs/angular/your-first-app/2-taking-photos.mdx b/docs/angular/your-first-app/2-taking-photos.mdx
index 8dab03dd0fd..2c8de41e3e5 100644
--- a/docs/angular/your-first-app/2-taking-photos.mdx
+++ b/docs/angular/your-first-app/2-taking-photos.mdx
@@ -1,14 +1,11 @@
---
title: Taking Photos with the Camera
+description: "Add the ability to take photos with your device's camera using the Ionic Capacitor Camera API for mobile iOS, Android, and the web. Learn how here."
sidebar_label: Taking Photos
---
Take Photos with Camera API for iOS, Android & Web with Angular | Ionic Capacitor Camera
-
Now for the fun part - adding the ability to take photos with the device’s camera using the Capacitor [Camera API](../../native/camera.mdx). We’ll begin with building it for the web, then make some small tweaks to make it work on mobile (iOS and Android).
diff --git a/docs/angular/your-first-app/3-saving-photos.mdx b/docs/angular/your-first-app/3-saving-photos.mdx
index 33fe92a56a7..051af03f197 100644
--- a/docs/angular/your-first-app/3-saving-photos.mdx
+++ b/docs/angular/your-first-app/3-saving-photos.mdx
@@ -1,14 +1,11 @@
---
title: Saving Photos to the Filesystem
+description: 'We’re now able to take multiple photos and display them in a photo gallery. Learn how to save these photos to the filesystem using the Ionic Capacitor Filesystem API.'
sidebar_label: Saving Photos
---
Saving Photos to the Filesystem with Angular | Ionic Capacitor Camera
-
We’re now able to take multiple photos and display them in a photo gallery on the second tab of our app. These photos, however, are not currently being stored permanently, so when the app is closed, they will be deleted.
diff --git a/docs/angular/your-first-app/4-loading-photos.mdx b/docs/angular/your-first-app/4-loading-photos.mdx
index 2cc91d12e70..52dee84bc8e 100644
--- a/docs/angular/your-first-app/4-loading-photos.mdx
+++ b/docs/angular/your-first-app/4-loading-photos.mdx
@@ -1,14 +1,11 @@
---
title: Loading Photos from the Filesystem
+description: 'We’ve implemented photo taking and saving to the filesystem, now learn how Ionic leverages Capacitor Preferences API for loading our photos in a key-value store.'
sidebar_label: Loading Photos
---
Loading Photos from the Filesystem with Angular | Ionic Capacitor Camera
-
We’ve implemented photo taking and saving to the filesystem. There’s one last piece of functionality missing: the photos are stored in the filesystem, but we need a way to save pointers to each file so that they can be displayed again in the photo gallery.
diff --git a/docs/angular/your-first-app/5-adding-mobile.mdx b/docs/angular/your-first-app/5-adding-mobile.mdx
index 864c1062bdf..57bfb02b955 100644
--- a/docs/angular/your-first-app/5-adding-mobile.mdx
+++ b/docs/angular/your-first-app/5-adding-mobile.mdx
@@ -1,14 +1,11 @@
---
title: Adding Mobile
+description: 'Learn how to add mobile support to your Ionic Capacitor photo gallery app, enabling it to run on iOS, Android, and the web using one codebase.'
strip_number_prefixes: false
---
Adding Mobile Support with Angular | Ionic Capacitor Camera
-
Our photo gallery app won’t be complete until it runs on iOS, Android, and the web - all using one codebase. All it takes is some small logic changes to support mobile platforms, installing some native tooling, then running the app on a device. Let’s go!
diff --git a/docs/angular/your-first-app/6-deploying-mobile.mdx b/docs/angular/your-first-app/6-deploying-mobile.mdx
index bf2b0963591..69d6b864593 100644
--- a/docs/angular/your-first-app/6-deploying-mobile.mdx
+++ b/docs/angular/your-first-app/6-deploying-mobile.mdx
@@ -1,14 +1,11 @@
---
title: Deploying to iOS and Android
+description: 'Deploying to iOS and Android is easy with Capacitor setup for Ionic Framework apps. Read to learn more about deployment in our Ionic Documentation.'
sidebar_label: Deploying Mobile
---
Adding Mobile Support with Angular | Ionic Capacitor Camera
-
Since we added Capacitor to our project when it was first created, there’s only a handful of steps remaining until the Photo Gallery app is on our device!
diff --git a/docs/angular/your-first-app/7-live-reload.mdx b/docs/angular/your-first-app/7-live-reload.mdx
index 9473e6e9cc3..9a610a5f787 100644
--- a/docs/angular/your-first-app/7-live-reload.mdx
+++ b/docs/angular/your-first-app/7-live-reload.mdx
@@ -1,14 +1,11 @@
---
title: Rapid App Development with Live Reload
+description: 'Use the Ionic CLI’s Live Reload functionality to boost your productivity when building Ionic apps. Learn how you can utilize rapid app development.'
sidebar_label: Live Reload
---
Rapid App Development with Live Reload with Angular | Ionic Capacitor Camera
-
So far, we’ve learned how easy it is to develop a cross-platform app that works everywhere. The development experience is pretty quick, but what if I told you there was a way to go faster?
diff --git a/docs/angular/your-first-app/8-distribute.mdx b/docs/angular/your-first-app/8-distribute.mdx
index d397a887f3e..276413b2501 100644
--- a/docs/angular/your-first-app/8-distribute.mdx
+++ b/docs/angular/your-first-app/8-distribute.mdx
@@ -1,14 +1,11 @@
---
title: Build and Distribute your App
+description: 'Learn how to build and deploy your Ionic app using Appflow. Discover how to create builds, push live updates, and distribute your app to users.'
sidebar_label: Distribute
---
Build and Deploy your App with Angular | Ionic Capacitor Camera
-
Now that you have built your first app, you are going to want to get it distributed so everyone can start using it. The mechanics of building and deploying your application can be quite cumbersome. That is where [Appflow](https://ionic.io/docs/appflow/) comes into play. Appflow allows you to effectively generate web and native builds, push out live app updates, publish your app to the app stores, and automate the whole process. Refer to the [Appflow Quickstart guide](https://ionic.io/docs/appflow/quickstart).
diff --git a/docs/angular/zoneless.mdx b/docs/angular/zoneless.mdx
index d39b0ee6f6d..9cd28939c2e 100644
--- a/docs/angular/zoneless.mdx
+++ b/docs/angular/zoneless.mdx
@@ -1,14 +1,11 @@
---
title: Zoneless Change Detection
+description: "Run Ionic Angular apps without Zone.js. Learn the change detection contract for overlays, lifecycle hooks, and platform events when using Angular's zoneless change detection."
sidebar_label: Zoneless
---
Zoneless Change Detection with Ionic and Angular
-
Angular 21 made [zoneless change detection](https://angular.dev/guide/zoneless) the default, removing the dependency on Zone.js. This guide covers what you need to know to run an Ionic Angular app without Zone.js.
diff --git a/docs/api.mdx b/docs/api.mdx
index 501f9a836be..3fa34b786b4 100644
--- a/docs/api.mdx
+++ b/docs/api.mdx
@@ -1,15 +1,12 @@
---
title: API Index
+description: 'Each component in the Ionic Docs API Index consists of one or more custom elements—which each, in turn, may expose methods, events, and CSS custom properties.'
---
import APIList from '@components/page/api/APIList';
API Index | Ionic Docs API Index for all API Custom Elements
-
Each Ionic [component](./components.mdx) consists of one or more [custom elements](https://developer.mozilla.org/en-US/docs/Web/Web_Components/Using_custom_elements). Each custom element, in turn, may expose properties, methods, events, and CSS custom properties.
diff --git a/docs/api/accordion-group.mdx b/docs/api/accordion-group.mdx
index 8504a503c25..da6d8a6882a 100644
--- a/docs/api/accordion-group.mdx
+++ b/docs/api/accordion-group.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-accordion-group'
+description: 'ion-accordion-group is a container for accordions that manages their expanded state and provides keyboard navigation between them.'
---
import Props from '@ionic-internal/component-api/v9/accordion-group/props.mdx';
diff --git a/docs/api/accordion.mdx b/docs/api/accordion.mdx
index d97f81f4653..7db483dd435 100644
--- a/docs/api/accordion.mdx
+++ b/docs/api/accordion.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-accordion'
+description: 'Ion-accordion components provide collapsible sections in content to reduce vertical space and organize information. Learn how to build one and explore examples.'
---
import Props from '@ionic-internal/component-api/v9/accordion/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/accordion/slots.mdx';
ion-accordion: Accordion Components: How to Build & Examples
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/action-sheet.mdx b/docs/api/action-sheet.mdx
index 166b0e68f48..49d68d2a442 100644
--- a/docs/api/action-sheet.mdx
+++ b/docs/api/action-sheet.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-action-sheet'
+description: 'Action Sheets are dialogs that display a set of options above app content and must be manually dismissed. Read to learn about use on iOS and Android devices.'
---
import Tabs from '@theme/Tabs';
@@ -14,10 +15,6 @@ import Slots from '@ionic-internal/component-api/v9/action-sheet/slots.mdx';
ion-action-sheet: Action Sheet Dialog for iOS and Android
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/alert.mdx b/docs/api/alert.mdx
index 850e6d1070e..7c458960d5d 100644
--- a/docs/api/alert.mdx
+++ b/docs/api/alert.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-alert'
+description: "ion-alert dialog presents or collects information using inputs. Custom alert button messages appear above the app's content and must be manually dismissed."
---
import Tabs from '@theme/Tabs';
@@ -14,10 +15,6 @@ import Slots from '@ionic-internal/component-api/v9/alert/slots.mdx';
ion-alert: Ionic Alert Buttons with Custom Message Prompts
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/app.mdx b/docs/api/app.mdx
index 32c36ced242..4e01d2d8e8d 100644
--- a/docs/api/app.mdx
+++ b/docs/api/app.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-app'
+description: 'ion-app is a container element for an Ionic application. Apps can have many Ionic components including menus, headers, content, and footers. Read to learn more.'
---
import Props from '@ionic-internal/component-api/v9/app/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/app/slots.mdx';
ion-app: Container Element for an Ionic Application
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/avatar.mdx b/docs/api/avatar.mdx
index 851aa6dbbba..f86af4b56ee 100644
--- a/docs/api/avatar.mdx
+++ b/docs/api/avatar.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-avatar'
+description: 'Ion-avatars are circular application components that wrap an image or icon. They can represent a person or an object, by themselves or inside of any element.'
---
import Props from '@ionic-internal/component-api/v9/avatar/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/avatar/slots.mdx';
ion-avatar: Circular Application Avatar Icon Component
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/back-button.mdx b/docs/api/back-button.mdx
index 6ad1eb452c9..18130029f8b 100644
--- a/docs/api/back-button.mdx
+++ b/docs/api/back-button.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-back-button'
+description: 'The ion-back-button is a custom menu icon for Android, iOS, and Progressive Web Apps. Use Ionic Framework components to easily build applications.'
---
import Props from '@ionic-internal/component-api/v9/back-button/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/back-button/slots.mdx';
ion-back-button: Custom Menu Back Button for Applications
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/backdrop.mdx b/docs/api/backdrop.mdx
index ad0e88f4090..05e377ab327 100644
--- a/docs/api/backdrop.mdx
+++ b/docs/api/backdrop.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-backdrop'
+description: 'ion-backdrop is a full screen overlay that sits behind components that transition in on top of content, and can be tapped to dismiss them.'
---
import Props from '@ionic-internal/component-api/v9/backdrop/props.mdx';
diff --git a/docs/api/badge.mdx b/docs/api/badge.mdx
index 053eca7328a..4a5b90a5cda 100644
--- a/docs/api/badge.mdx
+++ b/docs/api/badge.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-badge'
+description: 'Badges are inline block elements that appear near other elements on iOS & Android apps—use ion-badges as notifications that indicate how many items there are.'
---
import Props from '@ionic-internal/component-api/v9/badge/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/badge/slots.mdx';
ion-badge: iOS & Android App Notification Badge Icons
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/breadcrumb.mdx b/docs/api/breadcrumb.mdx
index 010b10cbfcb..fa318fea290 100644
--- a/docs/api/breadcrumb.mdx
+++ b/docs/api/breadcrumb.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-breadcrumb'
+description: 'ion-breadcrumb is a single navigation item inside ion-breadcrumbs. It can link elsewhere in an app or be plain text, with an optional icon.'
---
import Props from '@ionic-internal/component-api/v9/breadcrumb/props.mdx';
diff --git a/docs/api/breadcrumbs.mdx b/docs/api/breadcrumbs.mdx
index c49ba51ab78..7eaedf45085 100644
--- a/docs/api/breadcrumbs.mdx
+++ b/docs/api/breadcrumbs.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-breadcrumbs'
+description: 'ion-breadcrumbs shows where a user is in an app or site with hierarchical pages, and can collapse items when there are more than fit.'
---
import Props from '@ionic-internal/component-api/v9/breadcrumbs/props.mdx';
diff --git a/docs/api/button.mdx b/docs/api/button.mdx
index 0a3c4d2d5c9..3ebc7596bdc 100644
--- a/docs/api/button.mdx
+++ b/docs/api/button.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-button'
+description: 'ion-button provides a clickable element for use anywhere needing standard button functionality. Design and style button elements with custom CSS properties.'
---
import Props from '@ionic-internal/component-api/v9/button/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/button/slots.mdx';
ion-button: Style Buttons with Custom CSS Properties
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/buttons.mdx b/docs/api/buttons.mdx
index bf828f6364a..fd6f3a170f5 100644
--- a/docs/api/buttons.mdx
+++ b/docs/api/buttons.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-buttons'
+description: 'The Buttons component is a container element. Buttons placed in a toolbar should be inside the ion-buttons element and can be positioned using named slots.'
---
import Props from '@ionic-internal/component-api/v9/buttons/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/buttons/slots.mdx';
ion-buttons: Toolbar Element with Named Slots for Buttons
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/card-content.mdx b/docs/api/card-content.mdx
index 3df180c4006..b2b1abc10fd 100644
--- a/docs/api/card-content.mdx
+++ b/docs/api/card-content.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-card-content'
+description: 'ion-card-content adds padding around the content of an ion-card. Place any text content for a card inside of it.'
---
import Props from '@ionic-internal/component-api/v9/card-content/props.mdx';
diff --git a/docs/api/card-header.mdx b/docs/api/card-header.mdx
index b3c0141a468..1332b89b51b 100644
--- a/docs/api/card-header.mdx
+++ b/docs/api/card-header.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-card-header'
+description: 'ion-card-header goes before the card content in an ion-card, and can contain a card title and a card subtitle.'
---
import Props from '@ionic-internal/component-api/v9/card-header/props.mdx';
diff --git a/docs/api/card-subtitle.mdx b/docs/api/card-subtitle.mdx
index 9d435fdd47b..f07dd093916 100644
--- a/docs/api/card-subtitle.mdx
+++ b/docs/api/card-subtitle.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-card-subtitle'
+description: 'ion-card-subtitle displays the subtitle of an ion-card, and is placed inside of an ion-card-header.'
---
import Props from '@ionic-internal/component-api/v9/card-subtitle/props.mdx';
diff --git a/docs/api/card-title.mdx b/docs/api/card-title.mdx
index 2272dee3be5..3d957a79ca0 100644
--- a/docs/api/card-title.mdx
+++ b/docs/api/card-title.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-card-title'
+description: 'ion-card-title is a child component of ion-card. Read to learn more about card title properties and how this component is used on Ionic Framework apps.'
---
import Props from '@ionic-internal/component-api/v9/card-title/props.mdx';
@@ -13,10 +14,6 @@ import EncapsulationPill from '@components/page/api/EncapsulationPill';
ion-card-title: Ionic App Card Title Component
-
diff --git a/docs/api/card.mdx b/docs/api/card.mdx
index 4a0cc037b75..d374f61563e 100644
--- a/docs/api/card.mdx
+++ b/docs/api/card.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-card'
+description: 'ion-card UI components are entry points to more detailed information. Cards can be single components or made up of some header, title, subtitle, and content.'
---
import Props from '@ionic-internal/component-api/v9/card/props.mdx';
@@ -13,10 +14,6 @@ import EncapsulationPill from '@components/page/api/EncapsulationPill';
ion-card: Card UI Components for Ionic Framework API
-
diff --git a/docs/api/checkbox.mdx b/docs/api/checkbox.mdx
index 40436990d32..44bc8ab3e55 100644
--- a/docs/api/checkbox.mdx
+++ b/docs/api/checkbox.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-checkbox'
+description: 'ion-checkboxes allow selection of multiple options from a set and appear as checked (ticked) when activated. Learn about the checkbox component for Ionic apps.'
---
import Props from '@ionic-internal/component-api/v9/checkbox/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/checkbox/slots.mdx';
ion-checkbox: Ionic App Checkbox to Select Multiple Options
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/chip.mdx b/docs/api/chip.mdx
index 1c7a39f5827..b108c4d8ffd 100644
--- a/docs/api/chip.mdx
+++ b/docs/api/chip.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-chip'
+description: 'ion-chips represent complex entities in small blocks, such as a contact. A chip can contain several different elements such as names, avatars, text, and icons.'
---
import Props from '@ionic-internal/component-api/v9/chip/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/chip/slots.mdx';
ion-chip: Text, Icon and Avatar for Ionic Framework Apps
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/col.mdx b/docs/api/col.mdx
index 71fe4c2cac6..ae38780d1ba 100644
--- a/docs/api/col.mdx
+++ b/docs/api/col.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-col'
+description: 'ion-col is a column component that goes inside a row. Content within a grid goes inside of a column. Read more on column padding, size, and other properties.'
---
import Props from '@ionic-internal/component-api/v9/col/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/col/slots.mdx';
ion-col: Column Component Padding and Other Properties
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/content.mdx b/docs/api/content.mdx
index a6a82fff70b..1444725ac3a 100644
--- a/docs/api/content.mdx
+++ b/docs/api/content.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-content'
+description: 'ion-content provides an easy to use content area with useful methods to control the scrollable area. Learn more about this CSS component for Ionic apps.'
---
import Props from '@ionic-internal/component-api/v9/content/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/content/slots.mdx';
ion-content: Scrollable Component for Ionic App Content
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/datetime-button.mdx b/docs/api/datetime-button.mdx
index 85d4e134f83..7a8cc3e1568 100644
--- a/docs/api/datetime-button.mdx
+++ b/docs/api/datetime-button.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-datetime-button'
+description: 'Datetime button links with a datetime instance to easily a datetime in a popover, modal, and more.'
---
import Props from '@ionic-internal/component-api/v9/datetime-button/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/datetime-button/slots.mdx';
ion-datetime-button: Ionic Input for Datetime Picker
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/datetime.mdx b/docs/api/datetime.mdx
index cd0e2beec37..b17efa18c45 100644
--- a/docs/api/datetime.mdx
+++ b/docs/api/datetime.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-datetime'
+description: "Datetimes present a picker interface to select dates and times. Ionic's API Datetime input component easily displays a preferred format, and manages values."
---
import Props from '@ionic-internal/component-api/v9/datetime/props.mdx';
@@ -49,10 +50,6 @@ import WheelStyling from '@site/static/usage/v9/datetime/styling/wheel-styling/i
ion-datetime: Ionic API Input for Datetime Format Picker
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/fab-button.mdx b/docs/api/fab-button.mdx
index 08c96625f98..cb43dde127b 100644
--- a/docs/api/fab-button.mdx
+++ b/docs/api/fab-button.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-fab-button'
+description: 'Floating Action Buttons (FABs) represent the primary action in an app. The icons are circular and, when pressed, the button may open more related actions.'
---
import Props from '@ionic-internal/component-api/v9/fab-button/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/fab-button/slots.mdx';
ion-fab-button: Ionic FAB Button Icon for Primary Action
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/fab-list.mdx b/docs/api/fab-list.mdx
index bdb6b13a913..e84c02855e5 100644
--- a/docs/api/fab-list.mdx
+++ b/docs/api/fab-list.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-fab-list'
+description: 'ion-fab-list holds the fab buttons for actions related to the main fab button. It opens on click and can show its buttons on any side.'
---
import Props from '@ionic-internal/component-api/v9/fab-list/props.mdx';
diff --git a/docs/api/fab.mdx b/docs/api/fab.mdx
index 75d4f18967d..da1f4c04c38 100644
--- a/docs/api/fab.mdx
+++ b/docs/api/fab.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-fab'
+description: 'Fabs, floating action buttons, are container elements that contain one or more fab buttons. Use ion-fab when creating Android and iOS apps with Ionic Framework.'
---
import Props from '@ionic-internal/component-api/v9/fab/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/fab/slots.mdx';
ion-fab: Ionic Floating Action Button for Android and iOS
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/footer.mdx b/docs/api/footer.mdx
index efd532cf1cd..2d53aeff5e5 100644
--- a/docs/api/footer.mdx
+++ b/docs/api/footer.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-footer'
+description: 'A footer is a root component that sits at the bottom of a page. Ionic footers can be a wrapper for ion-toolbar to make sure the content area is sized correctly.'
---
import Props from '@ionic-internal/component-api/v9/footer/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/footer/slots.mdx';
ion-footer: Page Footer | Ionic App Footer Root Component
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/grid.mdx b/docs/api/grid.mdx
index ba270bc6160..3f1ae810e7a 100644
--- a/docs/api/grid.mdx
+++ b/docs/api/grid.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-grid'
+description: 'Ion-Grid is a mobile-first flexbox system to build custom application display layouts with a 12 column layout and different breakpoints based on screen size.'
---
import Props from '@ionic-internal/component-api/v9/grid/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/grid/slots.mdx';
ion-grid: Display Grids for Mobile-First Custom App Layout
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/header.mdx b/docs/api/header.mdx
index 1936e949f40..8b79e2601be 100644
--- a/docs/api/header.mdx
+++ b/docs/api/header.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-header'
+description: "Ion-header is a parent component that holds the toolbar. It's important to note that ion-header needs to be the one of the three root elements of a page."
---
import Props from '@ionic-internal/component-api/v9/header/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/header/slots.mdx';
ion-header: Header Parent Component for Ionic Framework Apps
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/icon.mdx b/docs/api/icon.mdx
index 7c9c2342714..d0de76abe84 100644
--- a/docs/api/icon.mdx
+++ b/docs/api/icon.mdx
@@ -1,13 +1,10 @@
---
title: 'ion-icon'
+description: 'Ion-icon is a component for displaying premium designed icons with support for SVG and web font.'
---
ion-icon: Icon Component for Ionic Framework Apps
-
Icon is a universal container for displaying icons. While [Ionicons](https://ionic.io/ionicons) is included by default with all Ionic Framework applications, the component can display Ionicons, custom SVGs, font-based icon libraries, and other icon systems. It provides consistent styling and sizing regardless of where an icon comes from.
diff --git a/docs/api/img.mdx b/docs/api/img.mdx
index 3725bddc46a..82103b569c7 100644
--- a/docs/api/img.mdx
+++ b/docs/api/img.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-img'
+description: 'The ion-img component lazily loads images as they enter the viewport. It is deprecated in favor of a native img tag with lazy loading.'
---
import Props from '@ionic-internal/component-api/v9/img/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/img/slots.mdx';
ion-img: Img Tag to Lazy Load Images in Viewport
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/infinite-scroll-content.mdx b/docs/api/infinite-scroll-content.mdx
index 9a9f9eea386..1da2003e800 100644
--- a/docs/api/infinite-scroll-content.mdx
+++ b/docs/api/infinite-scroll-content.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-infinite-scroll-content'
+description: 'ion-infinite-scroll-content is the default child of ion-infinite-scroll. It shows a platform-specific spinner while more content loads.'
---
import Props from '@ionic-internal/component-api/v9/infinite-scroll-content/props.mdx';
diff --git a/docs/api/infinite-scroll.mdx b/docs/api/infinite-scroll.mdx
index dbc14708bcd..5070f197848 100644
--- a/docs/api/infinite-scroll.mdx
+++ b/docs/api/infinite-scroll.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-infinite-scroll'
+description: 'The ion-infinite-scroll component calls an action to be performed when the user scrolls a specified distance from the bottom or top of the page.'
---
import Props from '@ionic-internal/component-api/v9/infinite-scroll/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/infinite-scroll/slots.mdx';
ion-infinite-scroll: Infinite Scroller Action Component
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/input-otp.mdx b/docs/api/input-otp.mdx
index 80cd9dd0a6b..7640f3cfccf 100644
--- a/docs/api/input-otp.mdx
+++ b/docs/api/input-otp.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-input-otp'
+description: 'ion-input-otp is a component for entering one-time passwords (OTP) with support for multiple input boxes and automatic focus management.'
---
import Props from '@ionic-internal/component-api/v9/input-otp/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/input-otp/slots.mdx';
ion-input-otp: One-Time Password Input Component
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/input-password-toggle.mdx b/docs/api/input-password-toggle.mdx
index 6a185e2e8f3..6db4cf86054 100644
--- a/docs/api/input-password-toggle.mdx
+++ b/docs/api/input-password-toggle.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-input-password-toggle'
+description: 'ion-input-password-toggle is a companion component to ion-input. It allows users to toggle the visibility of text in a password input.'
---
import Props from '@ionic-internal/component-api/v9/input-password-toggle/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/input-password-toggle/slots.
ion-input-password-toggle: Toggle the visibility of a password in Input
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/input.mdx b/docs/api/input.mdx
index ff4a352dd2c..f59116838c1 100644
--- a/docs/api/input.mdx
+++ b/docs/api/input.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-input'
+description: 'ion-input is a wrapper to the HTML input element, with custom value type styling and functionality. It integrates with the keyboard on mobile devices.'
---
import Props from '@ionic-internal/component-api/v9/input/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/input/slots.mdx';
ion-input: Custom Input With Styling and CSS Properties
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/item-divider.mdx b/docs/api/item-divider.mdx
index 42fa77d09ea..548ede093c2 100644
--- a/docs/api/item-divider.mdx
+++ b/docs/api/item-divider.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-item-divider'
+description: 'Item Dividers are block elements that can be used to separate items in a list. They are similar to list headers, but instead, go in between groups of items.'
---
import Props from '@ionic-internal/component-api/v9/item-divider/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/item-divider/slots.mdx';
ion-item-divider: Item Divider Block Element for Ionic Apps
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/item-group.mdx b/docs/api/item-group.mdx
index 5c52954e358..85124d9fd53 100644
--- a/docs/api/item-group.mdx
+++ b/docs/api/item-group.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-item-group'
+description: 'Item groups are containers that organize similar items together. ion-item-groups can contain item dividers to divide the items into multiple sections. '
---
import Props from '@ionic-internal/component-api/v9/item-group/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/item-group/slots.mdx';
ion-item-group: Group Items to Divide into Multiple Sections
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/item-option.mdx b/docs/api/item-option.mdx
index 91c929484ff..6f48064da8b 100644
--- a/docs/api/item-option.mdx
+++ b/docs/api/item-option.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-item-option'
+description: 'ion-item-option is the option button for an ion-item-sliding and must be placed inside of an . Read to learn more about properties.'
---
import Props from '@ionic-internal/component-api/v9/item-option/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/item-option/slots.mdx';
ion-item-option: Option Button for Sliding Item in Ionic
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/item-options.mdx b/docs/api/item-options.mdx
index 8578252a535..331f02bb6f1 100644
--- a/docs/api/item-options.mdx
+++ b/docs/api/item-options.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-item-options'
+description: 'ion-item-options are for ion-item-sliding. These option buttons can be placed either on the start or end side. Read to learn more about use on Ionic apps.'
---
import Props from '@ionic-internal/component-api/v9/item-options/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/item-options/slots.mdx';
ion-item-options: Option Button Components for Ionic Apps
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/item-sliding.mdx b/docs/api/item-sliding.mdx
index 26f64dc9209..8524ea3c295 100644
--- a/docs/api/item-sliding.mdx
+++ b/docs/api/item-sliding.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-item-sliding'
+description: 'ion-item-sliding component contains items that are dragged to reveal buttons. Options are revealed when the sliding item is swiped from left to right.'
---
import Props from '@ionic-internal/component-api/v9/item-sliding/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/item-sliding/slots.mdx';
ion-item-sliding: Slide Buttons | Slide Right to Left
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/item.mdx b/docs/api/item.mdx
index 3d9c22431f7..de12b4f679e 100644
--- a/docs/api/item.mdx
+++ b/docs/api/item.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-item'
+description: "ion-item elements for iOS/Android contain text, icons, images, and other custom elements. They're placed in a list and can be input, deleted, edited, and more."
---
import Props from '@ionic-internal/component-api/v9/item/props.mdx';
@@ -17,10 +18,6 @@ import TabItem from '@theme/TabItem';
ion-item: Input, Edit, or Delete iOS and Android Item Elements
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/label.mdx b/docs/api/label.mdx
index 7635d0d87b0..80fceda5826 100644
--- a/docs/api/label.mdx
+++ b/docs/api/label.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-label'
+description: 'Label is a wrapper element that can be used in combination with other Ionic components. Easily design item label colors and other properties with ion-label.'
---
import Props from '@ionic-internal/component-api/v9/label/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/label/slots.mdx';
ion-label: Item Label Color and Properties for Applications
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/list-header.mdx b/docs/api/list-header.mdx
index 4b6fdfe42d2..cc0114f166b 100644
--- a/docs/api/list-header.mdx
+++ b/docs/api/list-header.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-list-header'
+description: 'ion-list-header describes the contents of an ion-list. Unlike item dividers, use it only once, at the top of a list.'
---
import Props from '@ionic-internal/component-api/v9/list-header/props.mdx';
diff --git a/docs/api/list.mdx b/docs/api/list.mdx
index 7e3c65e3afb..de322262532 100644
--- a/docs/api/list.mdx
+++ b/docs/api/list.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-list'
+description: 'ion-lists are made up of multiple rows of items containing text, icons, toggles, and more. Learn about the list view component for iOS and Android Ionic apps.'
---
import Props from '@ionic-internal/component-api/v9/list/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/list/slots.mdx';
ion-list: Item List View Component for iOS and Android Apps
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/loading.mdx b/docs/api/loading.mdx
index fad28bb27d0..d3bbf076116 100644
--- a/docs/api/loading.mdx
+++ b/docs/api/loading.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-loading'
+description: "The ion-loading overlay indicates activity while blocking user interaction. The loading indicator appears on top of the app's content, and can be dismissed."
---
import Props from '@ionic-internal/component-api/v9/loading/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/loading/slots.mdx';
ion-loading: Loading | Application Loading Indicator Overlay
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/menu-button.mdx b/docs/api/menu-button.mdx
index 03a966850a9..d406374f404 100644
--- a/docs/api/menu-button.mdx
+++ b/docs/api/menu-button.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-menu-button'
+description: 'Menu Button is component that automatically creates the icon and functionality to open a menu on an app page. Read to learn more about ion-menu-button.'
---
import Props from '@ionic-internal/component-api/v9/menu-button/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/menu-button/slots.mdx';
ion-menu-button: Menu Button to Open an App Menu on a Page
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/menu-toggle.mdx b/docs/api/menu-toggle.mdx
index b1ccce96709..313d73013a5 100644
--- a/docs/api/menu-toggle.mdx
+++ b/docs/api/menu-toggle.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-menu-toggle'
+description: "The MenuToggle component can be used to toggle a menu open or closed—by default, it's only visible when the selected menu is active. Read more about usage."
---
import Props from '@ionic-internal/component-api/v9/menu-toggle/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/menu-toggle/slots.mdx';
ion-menu-toggle: MenuToggle Component to Open/Close Menus
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/menu.mdx b/docs/api/menu.mdx
index c16580c843f..66e7b35cfc5 100644
--- a/docs/api/menu.mdx
+++ b/docs/api/menu.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-menu'
+description: 'ion-menu components are navigation drawers that slide in from the side of the current view. Read our framework docs for the available menu types on Ionic API.'
---
import Props from '@ionic-internal/component-api/v9/menu/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/menu/slots.mdx';
ion-menu: API Framework Docs for Types of Menu Components
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/modal.mdx b/docs/api/modal.mdx
index bd64ab5603f..3c06516b69b 100644
--- a/docs/api/modal.mdx
+++ b/docs/api/modal.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-modal'
+description: 'ion-modal is a dialog that appears on top of mobile app content, and must be dismissed before interaction resumes. Learn more about custom modal components.'
---
import Props from '@ionic-internal/component-api/v9/modal/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/modal/slots.mdx';
ion-modal: Ionic Mobile App Custom Modal API Component
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/nav-link.mdx b/docs/api/nav-link.mdx
index a10d9001a15..3c5fbe55e3c 100644
--- a/docs/api/nav-link.mdx
+++ b/docs/api/nav-link.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-nav-link'
+description: 'Navigation links navigate to specified components. It is the element form of calling the push(), pop(), and setRoot() methods. Read for more on ion-nav-link.'
---
import Props from '@ionic-internal/component-api/v9/nav-link/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/nav-link/slots.mdx';
ion-nav-link: Navigation Links to a Specified Component
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/nav.mdx b/docs/api/nav.mdx
index 3022a0bd7d9..95ee6639936 100644
--- a/docs/api/nav.mdx
+++ b/docs/api/nav.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-nav'
+description: "ion-nav is a standalone for loading arbitrary, and pushing new, components on to the stack. Loading Nav view, and pushing others, won't affect overall routers."
---
import Props from '@ionic-internal/component-api/v9/nav/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/nav/slots.mdx';
ion-nav: Nav View Component for Ionic Framework Apps
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/note.mdx b/docs/api/note.mdx
index a2a2cdfd65f..d381bde34e6 100644
--- a/docs/api/note.mdx
+++ b/docs/api/note.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-note'
+description: 'ion-notes are text elements generally used as subtitles that provide more information. Learn how notes can be used and styled on iOS and Android Ionic apps.'
---
import Props from '@ionic-internal/component-api/v9/note/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/note/slots.mdx';
ion-note: Note Text Elements for iOS and Android Ionic Apps
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/picker-column-option.mdx b/docs/api/picker-column-option.mdx
index 259fa0a8e83..c205a59f8f5 100644
--- a/docs/api/picker-column-option.mdx
+++ b/docs/api/picker-column-option.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-picker-column-option'
+description: 'An individual column option in a picker.'
---
import Props from '@ionic-internal/component-api/v9/picker-column-option/props.mdx';
@@ -11,7 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/picker-column-option/slots.m
ion-picker-column-option: The individual options within a column in a picker.
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/picker-column.mdx b/docs/api/picker-column.mdx
index 6c26ebff166..698c5c98c7d 100644
--- a/docs/api/picker-column.mdx
+++ b/docs/api/picker-column.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-picker-column'
+description: 'An individual column within a picker.'
---
import Props from '@ionic-internal/component-api/v9/picker-column/props.mdx';
@@ -11,7 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/picker-column/slots.mdx';
ion-picker-column: Individual columns within a picker
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/picker.mdx b/docs/api/picker.mdx
index dc15c94dffa..35739b1cdf9 100644
--- a/docs/api/picker.mdx
+++ b/docs/api/picker.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-picker'
+description: 'A Picker displays one or more columns with options for users to choose from.'
---
import Props from '@ionic-internal/component-api/v9/picker/props.mdx';
@@ -11,7 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/picker/slots.mdx';
ion-picker: Display a list of options in columns
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/popover.mdx b/docs/api/popover.mdx
index bddd46a5c44..02b331dc983 100644
--- a/docs/api/popover.mdx
+++ b/docs/api/popover.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-popover'
+description: 'ion-popover is a dialog that appears on top of the current page. Learn about the popover UI component and CSS custom properties for iOS and Android devices.'
---
import Props from '@ionic-internal/component-api/v9/popover/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/popover/slots.mdx';
ion-popover: iOS / Android Popover UI Dialog Component
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/progress-bar.mdx b/docs/api/progress-bar.mdx
index 0a6a65a15e0..fb7799cf3c1 100644
--- a/docs/api/progress-bar.mdx
+++ b/docs/api/progress-bar.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-progress-bar'
+description: 'ion-progress-bars are horizontal loading indicators that inform users about the status of ongoing app processes—such as submitting a form or saving updates.'
---
import Props from '@ionic-internal/component-api/v9/progress-bar/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/progress-bar/slots.mdx';
ion-progress-bar: App Progress Bar for Loading Indicator
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/radio-group.mdx b/docs/api/radio-group.mdx
index 95c34268654..1d5c475d42c 100644
--- a/docs/api/radio-group.mdx
+++ b/docs/api/radio-group.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-radio-group'
+description: 'A radio group is a group of radio buttons. Radio groups allow a user to select at most one radio button from a set. Learn more about ion-radio-group usage.'
---
import Props from '@ionic-internal/component-api/v9/radio-group/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/radio-group/slots.mdx';
ion-radio-group: Radio Button Group Usage for Ionic Apps
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/radio.mdx b/docs/api/radio.mdx
index 2f14519c43b..82d5e2d670a 100644
--- a/docs/api/radio.mdx
+++ b/docs/api/radio.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-radio'
+description: 'Radio components should be used inside of ion-radio-groups on iOS and Android devices. Read to learn more about radio property usage and installation.'
---
import Props from '@ionic-internal/component-api/v9/radio/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/radio/slots.mdx';
ion-radio: Radio Component for iOS and Android
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/range.mdx b/docs/api/range.mdx
index 34353f615b7..47d0771b899 100644
--- a/docs/api/range.mdx
+++ b/docs/api/range.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-range'
+description: 'ion-range lets you select from a range of values by moving the slider. It accepts dual knobs but one controls the value and labels can be placed on either side.'
---
import Props from '@ionic-internal/component-api/v9/range/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/range/slots.mdx';
ion-range: Range Slider Knob Controls with Labels
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/refresher-content.mdx b/docs/api/refresher-content.mdx
index 990203b22cc..765658ff16d 100644
--- a/docs/api/refresher-content.mdx
+++ b/docs/api/refresher-content.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-refresher-content'
+description: 'ion-refresher-content displays the icon, spinner, and text for a pull-to-refresh, with platform defaults that can be customized for each state.'
---
import Props from '@ionic-internal/component-api/v9/refresher-content/props.mdx';
diff --git a/docs/api/refresher.mdx b/docs/api/refresher.mdx
index b6d5e406eb6..47baece63c9 100644
--- a/docs/api/refresher.mdx
+++ b/docs/api/refresher.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-refresher'
+description: 'ion-refresher provides pull-to-refresh functionality on content components. Learn how this lets users pull down on a page using touch to retrieve more data.'
---
import Props from '@ionic-internal/component-api/v9/refresher/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/refresher/slots.mdx';
ion-refresher: Pull-to-Refresh Page Content on Ionic Apps
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/reorder-group.mdx b/docs/api/reorder-group.mdx
index ab72b271600..ec175f1e969 100644
--- a/docs/api/reorder-group.mdx
+++ b/docs/api/reorder-group.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-reorder-group'
+description: 'ion-reorder-group is a wrapper component for items using the ion-reorder component on Ionic apps. Read to learn more about ion-reorder-group usage.'
---
import Props from '@ionic-internal/component-api/v9/reorder-group/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/reorder-group/slots.mdx';
ion-reorder-group: Wrapper Component for Reorder Items
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/reorder.mdx b/docs/api/reorder.mdx
index 8b9417c2e85..f1d5fc262dc 100644
--- a/docs/api/reorder.mdx
+++ b/docs/api/reorder.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-reorder'
+description: 'Ion-reorder is the anchor used to drag and drop the items inside of the ion-reorder-group. Read to learn more about custom reorder icons and items.'
---
import Props from '@ionic-internal/component-api/v9/reorder/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/reorder/slots.mdx';
ion-reorder: Drag and Drop Icon to Reorder Items
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/ripple-effect.mdx b/docs/api/ripple-effect.mdx
index ce38d0e9e9b..c8dd9d8f362 100644
--- a/docs/api/ripple-effect.mdx
+++ b/docs/api/ripple-effect.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-ripple-effect'
+description: 'The ripple effect button component adds the Material Design ink ripple interaction effect. It can only be used in an ion-app and can be added to any component.'
---
import Props from '@ionic-internal/component-api/v9/ripple-effect/props.mdx';
@@ -13,10 +14,6 @@ import EncapsulationPill from '@components/page/api/EncapsulationPill';
ion-ripple-effect: Ripple Effect Component for Ionic Apps
-
diff --git a/docs/api/route-redirect.mdx b/docs/api/route-redirect.mdx
index 693634ff843..f551a7f9e2f 100644
--- a/docs/api/route-redirect.mdx
+++ b/docs/api/route-redirect.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-route-redirect'
+description: "ion-route-redirect is used with as a direct child of an ion-router and redirects 'from' a URL 'to' another URL. Read to learn about the route redirect plugin."
---
import Props from '@ionic-internal/component-api/v9/route-redirect/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/route-redirect/slots.mdx';
ion-route-redirect: Redirect 'from' a URL 'to' Another URL
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/route.mdx b/docs/api/route.mdx
index eac4cd54dc9..b88b78bdc1d 100644
--- a/docs/api/route.mdx
+++ b/docs/api/route.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-route'
+description: 'The ion-route component takes a component and renders it when the Browser URL matches the URL property. Learn more about the API route component for Ionic Apps.'
---
import Tabs from '@theme/Tabs';
@@ -14,10 +15,6 @@ import Slots from '@ionic-internal/component-api/v9/route/slots.mdx';
ion-route: API Route Component for Ionic Framework Apps
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/router-link.mdx b/docs/api/router-link.mdx
index e4e62963bbb..0a39d0f741e 100644
--- a/docs/api/router-link.mdx
+++ b/docs/api/router-link.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-router-link'
+description: 'Use the ion-router-link component to navigate to a specified link. The router link can accept an href for location and a direction for the transition animation.'
---
import Props from '@ionic-internal/component-api/v9/router-link/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/router-link/slots.mdx';
ion-router-link: Navigate To a Specified Link
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/router-outlet.mdx b/docs/api/router-outlet.mdx
index 3933330f583..a5dc461173e 100644
--- a/docs/api/router-outlet.mdx
+++ b/docs/api/router-outlet.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-router-outlet'
+description: 'ion-router-outlet works like the Angular router outlet and Vue router view, adding stacked navigation and animated page transitions.'
---
import Props from '@ionic-internal/component-api/v9/router-outlet/props.mdx';
diff --git a/docs/api/router.mdx b/docs/api/router.mdx
index 4b16efceb6f..90f030e519d 100644
--- a/docs/api/router.mdx
+++ b/docs/api/router.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-router'
+description: 'ion-router is a URL coordinator for navigation outlets of ionic: ion-tabs and ion-router-outlet. Router components handle routing inside vanilla and Stencil JavaScript.'
---
import Props from '@ionic-internal/component-api/v9/router/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/router/slots.mdx';
ion-router: Router Component to Coordinate URL Navigation
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/row.mdx b/docs/api/row.mdx
index d7d269c84c5..ea3124c4c84 100644
--- a/docs/api/row.mdx
+++ b/docs/api/row.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-row'
+description: 'Rows are horizontal components of the grid system and contain varying numbers of columns. Read our ion-row API Docs for more information on alignment and usage.'
---
import Props from '@ionic-internal/component-api/v9/row/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/row/slots.mdx';
ion-row: Horizontal Row Components of the Grid System
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/searchbar.mdx b/docs/api/searchbar.mdx
index f23cf2ab819..67dbe650495 100644
--- a/docs/api/searchbar.mdx
+++ b/docs/api/searchbar.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-searchbar'
+description: 'Search bars represent a text field that can be used to search through a collection. Learn to input Ion-Search Bar as an icon on Android & iOS keyboard displays.'
---
import Props from '@ionic-internal/component-api/v9/searchbar/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/searchbar/slots.mdx';
ion-searchbar: Search Bar for Searching a Collection
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/segment-button.mdx b/docs/api/segment-button.mdx
index 179d12ba791..fd47c5dff50 100644
--- a/docs/api/segment-button.mdx
+++ b/docs/api/segment-button.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-segment-button'
+description: 'ion-segment-buttons are groups of related buttons inside of a Segment. Learn to use segment button icons and check their values on Ionic Framework Apps.'
---
import Props from '@ionic-internal/component-api/v9/segment-button/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/segment-button/slots.mdx';
ion-segment-button | Segment Button Icon and Segment Value
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/segment-content.mdx b/docs/api/segment-content.mdx
index f4206a09a34..2eb78253f09 100644
--- a/docs/api/segment-content.mdx
+++ b/docs/api/segment-content.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-segment-content'
+description: 'ion-segment-contents are wrapper elements used to control the display of child elements when using swipeable segments.'
---
import Props from '@ionic-internal/component-api/v9/segment-content/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/segment-content/slots.mdx';
ion-segment-content: Display control element for swipeable segments
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/segment-view.mdx b/docs/api/segment-view.mdx
index c62150c46c7..006b44d5d7e 100644
--- a/docs/api/segment-view.mdx
+++ b/docs/api/segment-view.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-segment-view'
+description: 'ion-segment-views are wrapper elements that link a group of segment contents to a segment'
---
import Props from '@ionic-internal/component-api/v9/segment-view/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/segment-view/slots.mdx';
ion-segment-view: Controller element for swipeable segments
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/segment.mdx b/docs/api/segment.mdx
index 54f7baef582..6cc2bf2b209 100644
--- a/docs/api/segment.mdx
+++ b/docs/api/segment.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-segment'
+description: 'ion-segments display a group of related buttons—sometimes known as segmented controls. View our Segment API Documentation to learn more about usage.'
---
import Props from '@ionic-internal/component-api/v9/segment/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/segment/slots.mdx';
ion-segment: API Documentation for Segmented Controls
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/select-option.mdx b/docs/api/select-option.mdx
index efe3c4907e6..9528a8f5943 100644
--- a/docs/api/select-option.mdx
+++ b/docs/api/select-option.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-select-option'
+description: 'What is an option select? Select Options are child element components of a Select—each option defined is passed and displayed in the Select dialog.'
---
import Props from '@ionic-internal/component-api/v9/select-option/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/select-option/slots.mdx';
ion-select-option: Option For a Select Dialog
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/select.mdx b/docs/api/select.mdx
index 4b402274841..943a0f25f66 100644
--- a/docs/api/select.mdx
+++ b/docs/api/select.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-select'
+description: 'ion-select is represented by selected value(s), or a placeholder, and dropdown icon. When you tap select, a dialog box appears with an easy to select list.'
---
import Props from '@ionic-internal/component-api/v9/select/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/select/slots.mdx';
ion-select: Select One or Multiple Value Boxes or Placeholders
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/skeleton-text.mdx b/docs/api/skeleton-text.mdx
index 79c86947a24..08c9249d932 100644
--- a/docs/api/skeleton-text.mdx
+++ b/docs/api/skeleton-text.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-skeleton-text'
+description: 'ion-skeleton-text is a component for rendering placeholder content. The element will render a gray block at the specified width as a loading text framework.'
---
import Props from '@ionic-internal/component-api/v9/skeleton-text/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/skeleton-text/slots.mdx';
ion-skeleton-text: Skeleton Loading Placeholder for Text
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/spinner.mdx b/docs/api/spinner.mdx
index 74c699a3ddf..4cd2fb1d0f2 100644
--- a/docs/api/spinner.mdx
+++ b/docs/api/spinner.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-spinner'
+description: 'The ion-spinner component provides a variety of animated SVG spinners. These icons indicate that the app is loading or performing another process to wait on.'
---
import Props from '@ionic-internal/component-api/v9/spinner/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/spinner/slots.mdx';
ion-spinner: Animated Spinner Icon Components and Properties
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/split-pane.mdx b/docs/api/split-pane.mdx
index 811d63d46c8..6258e3fe2a5 100644
--- a/docs/api/split-pane.mdx
+++ b/docs/api/split-pane.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-split-pane'
+description: 'ion-split-pane is useful when creating multi-view app layouts. It allows UI elements, like menus, to be displayed as the viewport width increases.'
---
import Props from '@ionic-internal/component-api/v9/split-pane/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/split-pane/slots.mdx';
ion-split-pane: Split Plane for Menus and Multi-View Layouts
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/tab-bar.mdx b/docs/api/tab-bar.mdx
index e4ab404af2d..59bc9969a39 100644
--- a/docs/api/tab-bar.mdx
+++ b/docs/api/tab-bar.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-tab-bar'
+description: 'The tab bar component contains a set of tab buttons and a tab bar must be provided inside of tabs to communicate. Read more about use and CSS custom properties.'
---
import Tabs from '@theme/Tabs';
@@ -14,10 +15,6 @@ import Slots from '@ionic-internal/component-api/v9/tab-bar/slots.mdx';
ion-tab-bar: Tab Bar Component with CSS Custom Properties
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/tab-button.mdx b/docs/api/tab-button.mdx
index cb6019bbbe6..44205a470db 100644
--- a/docs/api/tab-button.mdx
+++ b/docs/api/tab-button.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-tab-button'
+description: 'ion-tab-button is placed inside of an ion-tab-bar. It sets the layout of its icon and label, and connects to an ion-tab.'
---
import Tabs from '@theme/Tabs';
diff --git a/docs/api/tab.mdx b/docs/api/tab.mdx
index f206d1b6c2a..cc17c991e8a 100644
--- a/docs/api/tab.mdx
+++ b/docs/api/tab.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-tab'
+description: 'ion-tab is a child component of tabs. Each ion-tab can contain a top level navigation stack for an application or a single view. Read to learn more.'
---
import Props from '@ionic-internal/component-api/v9/tab/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/tab/slots.mdx';
ion-tab: Ionic Framework Application Component
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/tabs.mdx b/docs/api/tabs.mdx
index 00f311dcf8b..b56acdb806d 100644
--- a/docs/api/tabs.mdx
+++ b/docs/api/tabs.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-tabs'
+description: 'Tabs are top-level components to implement tab-based navigation. Ion-tabs have no styling & work as router outlets for navigation that behaves like native apps.'
---
import Props from '@ionic-internal/component-api/v9/tabs/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/tabs/slots.mdx';
ion-tabs: Tab-Based Component for App Top-Level Navigation
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/text.mdx b/docs/api/text.mdx
index 8199fc0abcd..30d2c5e7139 100644
--- a/docs/api/text.mdx
+++ b/docs/api/text.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-text'
+description: 'ion-text is a simple app component that can be used to style the text color of any element. Learn how ion-text wraps elements in order to change the text color.'
---
import Props from '@ionic-internal/component-api/v9/text/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/text/slots.mdx';
ion-text: Ionic App Component to Style or Change Text Color
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/textarea.mdx b/docs/api/textarea.mdx
index 380b0d357bd..1bdf193aa7f 100644
--- a/docs/api/textarea.mdx
+++ b/docs/api/textarea.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-textarea'
+description: 'Textarea is for multi-line input. The component accepts native textarea attributes in addition to Ionic properties. Read to learn about use and CSS elements.'
---
import Props from '@ionic-internal/component-api/v9/textarea/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/textarea/slots.mdx';
Ionic Textarea Component and CSS Properties for Multi-Line Input
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/thumbnail.mdx b/docs/api/thumbnail.mdx
index b702dfaf7c1..1538eaddd01 100644
--- a/docs/api/thumbnail.mdx
+++ b/docs/api/thumbnail.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-thumbnail'
+description: 'What is a thumbnail image? Thumbnail app components wrap an image or icon and can be used to display a layout of images or for previews of full-size images.'
---
import Props from '@ionic-internal/component-api/v9/thumbnail/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/thumbnail/slots.mdx';
ion-thumbnail: Thumbnail App Component for Images or Icons
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/title.mdx b/docs/api/title.mdx
index 151cccb9ad1..4c316b83204 100644
--- a/docs/api/title.mdx
+++ b/docs/api/title.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-title'
+description: 'ion-title is a component that sets the title of the toolbar. Read to learn more about title and collapsible title components and usage for Ionic Framework Apps.'
---
import Props from '@ionic-internal/component-api/v9/title/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/title/slots.mdx';
ion-title: Ionic Framework App Title Component for Toolbars
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/toast.mdx b/docs/api/toast.mdx
index 83ccd44c5bd..f8bb76dec48 100644
--- a/docs/api/toast.mdx
+++ b/docs/api/toast.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-toast'
+description: 'ion-toast component is an app notification displaying system messages or feedback. Toast alerts appear above content and are dismissed to resume interaction.'
---
import Tabs from '@theme/Tabs';
@@ -14,10 +15,6 @@ import Slots from '@ionic-internal/component-api/v9/toast/slots.mdx';
ion-toast: A Dismissible App Notification Alert Component
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/toggle.mdx b/docs/api/toggle.mdx
index 2baa66446ee..d6a3346cb12 100644
--- a/docs/api/toggle.mdx
+++ b/docs/api/toggle.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-toggle'
+description: 'Toggle changes the state of a single option. Use ion-toggle to create customizable toggle buttons that can be switched on or off for your applications.'
---
import Props from '@ionic-internal/component-api/v9/toggle/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/toggle/slots.mdx';
ion-toggle: Custom Toggle Button for Ionic Applications
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/api/toolbar.mdx b/docs/api/toolbar.mdx
index 39933babfb6..263c36301c8 100644
--- a/docs/api/toolbar.mdx
+++ b/docs/api/toolbar.mdx
@@ -1,5 +1,6 @@
---
title: 'ion-toolbar'
+description: 'Ion-toolbar component lets you customize toolbar buttons on your app menu. Add fixed toolbars above or below content or use full screen to scroll with content.'
---
import Props from '@ionic-internal/component-api/v9/toolbar/props.mdx';
@@ -11,10 +12,6 @@ import Slots from '@ionic-internal/component-api/v9/toolbar/slots.mdx';
ion-toolbar: Customize App Menu Toolbar Buttons and Icons
-
import EncapsulationPill from '@components/page/api/EncapsulationPill';
diff --git a/docs/cli.mdx b/docs/cli.mdx
index 9d16276a4fd..482d04b189f 100644
--- a/docs/cli.mdx
+++ b/docs/cli.mdx
@@ -1,14 +1,11 @@
---
title: Ionic CLI
+description: 'The Ionic command-line interface (CLI) is the go-to tool for developing Ionic apps. Install our framework globally with npm.'
sidebar_label: Overview
---
Ionic CLI Framework: Command-Line Interface to Develop Apps
-
The Ionic command-line interface ([CLI](./reference/glossary.mdx#cli)) is the go-to tool for developing Ionic apps.
diff --git a/docs/cli/configuration.mdx b/docs/cli/configuration.mdx
index eb3d7615f45..bb7ac86281d 100644
--- a/docs/cli/configuration.mdx
+++ b/docs/cli/configuration.mdx
@@ -1,13 +1,10 @@
---
title: Configuration
+description: 'Set and print configuration values from project config files and the global CLI config file with Ionic CLI. Read to learn more about Capacitor configuration.'
---
Capacitor Configuration | Maintain a Global Configuration File
-
## Files {/* #files */}
diff --git a/docs/cli/livereload.mdx b/docs/cli/livereload.mdx
index aa12e4e7dcd..1384b18b5bf 100644
--- a/docs/cli/livereload.mdx
+++ b/docs/cli/livereload.mdx
@@ -1,3 +1,7 @@
+---
+description: "Use Live Reload with the Ionic CLI to reload the browser or Web View when your app's code changes, including on hardware devices."
+---
+
# Live Reload
Using the Live Reload option will reload the browser or [Web View](../core-concepts/webview.mdx) when you change your app's code in your development environment. This is particularly useful for developing using hardware devices.
diff --git a/docs/cli/using-a-proxy.mdx b/docs/cli/using-a-proxy.mdx
index 18ade785721..02793a93f09 100644
--- a/docs/cli/using-a-proxy.mdx
+++ b/docs/cli/using-a-proxy.mdx
@@ -1,3 +1,7 @@
+---
+description: 'Configure the Ionic CLI to work behind a proxy, using the CLI config file or an environment variable.'
+---
+
# Using a Proxy
Proxy support is built-in to the Ionic CLI. Proxy settings can be configured via the config file or an environment variable.
diff --git a/docs/components.mdx b/docs/components.mdx
index 5700d2be7e0..582b990d452 100644
--- a/docs/components.mdx
+++ b/docs/components.mdx
@@ -1,5 +1,6 @@
---
title: UI Components
+description: "Ionic Framework comes stock with a number of high-level UI components, including cards, lists, and tabs to quickly and easily build your app's user interface."
hide_table_of_contents: true
---
@@ -8,10 +9,6 @@ import DocsCards from '@components/global/DocsCards';
UI Components | User Interface Application Building Components
-