diff --git a/src/content/docs/en/guides/deploy/vercel.mdx b/src/content/docs/en/guides/deploy/vercel.mdx
index 98b9ed8d8fde2..9bc3f82b38b6a 100644
--- a/src/content/docs/en/guides/deploy/vercel.mdx
+++ b/src/content/docs/en/guides/deploy/vercel.mdx
@@ -4,7 +4,8 @@ description: How to deploy your Astro site to the web on Vercel.
type: deploy
i18nReady: true
---
-import ReadMore from '~/components/ReadMore.astro'
+import ReadMore from '~/components/ReadMore.astro';
+import { Steps } from '@astrojs/starlight/components';
You can use [Vercel](http://vercel.com/) to deploy an Astro site to their global edge network with zero configuration.
@@ -30,6 +31,7 @@ npx astro add vercel
If you prefer to install the adapter manually instead, complete the following two steps:
+
1. Install [the `@astrojs/vercel` adapter](/en/guides/integrations-guide/vercel/) to your project’s dependencies using your preferred package manager. If you’re using npm or aren’t sure, run this in the terminal:
```bash
@@ -47,6 +49,7 @@ If you prefer to install the adapter manually instead, complete the following tw
adapter: vercel(),
});
```
+
## How to deploy
@@ -54,18 +57,23 @@ You can deploy to Vercel through the website UI or using Vercel’s CLI (command
### Website UI Deployment
+
1. Push your code to your online Git repository (GitHub, GitLab, BitBucket).
+
2. [Import your project](https://vercel.com/new) into Vercel.
+
3. Vercel will automatically detect Astro and configure the right settings.
+
4. Your application is deployed! (e.g. [astro.vercel.app](https://astro.vercel.app/))
+
After your project has been imported and deployed, all subsequent pushes to branches will generate [Preview Deployments](https://vercel.com/docs/concepts/deployments/preview-deployments), and all changes made to the Production Branch (commonly “main”) will result in a [Production Deployment](https://vercel.com/docs/concepts/deployments/environments#production).
Learn more about Vercel’s [Git Integration](https://vercel.com/docs/concepts/git).
-
### CLI Deployment
+
1. Install the [Vercel CLI](https://vercel.com/cli) and run `vercel` to deploy.
```bash
@@ -74,9 +82,11 @@ After your project has been imported and deployed, all subsequent pushes to bran
```
2. Vercel will automatically detect Astro and configure the right settings.
+
3. When asked `Want to override the settings? [y/N]`, choose `N`.
-4. Your application is deployed! (e.g. [astro.vercel.app](https://astro.vercel.app/))
+4. Your application is deployed! (e.g. [astro.vercel.app](https://astro.vercel.app/))
+
### Project config with vercel.json