Vercel Status Guide
Learn how to check Vercel deployment status and monitor deployment history on the GIIP platform.
📋 Overview
The Vercel Status page lets you review the Vercel configurations registered in GIIP and the latest deployment status of each one at a glance. Opening this page automatically redirects you to the Vercel management list of the currently selected project (/project/[csn]/vercel). If no project is selected, it falls back to the default project.
🔍 Key Elements
1. Vercel Config Card List
Each registered Vercel configuration is displayed as a card. A card shows the config name (vcConfigName), the linked Vercel project name (vcVercelProjectName), and a description. Inactive configs are dimmed and marked with an Inactive badge.
2. Latest Deployment Status Badge
Each card shows the state of its most recent deployment as a colored badge.
READY(green): Deployment completeBUILDING(blue): Build in progressERROR(red): Deployment failedCANCELED(yellow): Deployment canceledQUEUED(purple): Waiting in queue
If a deployment URL is present, you can click it to open the live deployed site in a new tab. The bottom of the card shows the total deployment count (deploymentCount) and the last sync date (vcLastSyncAt).
3. Card Action Buttons
Each card offers the following actions.
- View Deployments: Navigate to the deployment history detail page for that config.
- Sync: Fetch the latest deployment information from Vercel and refresh.
- Edit: Modify the configuration.
- Delete: Remove the configuration (a confirmation dialog appears first).
4. Deployment History Table
Clicking [View Deployments] on a config card shows that config's deployments in a table. Columns are URL, State, Created, Creator, and Target. At the top you can adjust the State filter (All / READY / BUILDING / ERROR / CANCELED / QUEUED) and the display count (10 / 20 / 50).
🛠️ Tips
- Add a new config: Use the [Add Config] button in the upper right to register a new Vercel configuration.
- Refresh: Deployment status is not updated live automatically. When you need the latest state, press the [Sync] button on a card or the detail page to re-fetch data from Vercel.
- Switch projects: Changing the project at the top automatically switches to that project's Vercel list.
💡 Important Notes
- This page itself is redirect-only. It briefly shows a "Redirecting to Vercel management page..." message before moving to the project Vercel list.
- If the deployment list is empty, a sync may not have run yet, or the Vercel token may be invalid.
API Reference
For detailed API specifications of this feature, refer to the dedicated guide.
Troubleshooting
| Symptom | Cause | Resolution |
|---|---|---|
| Page stays stuck on "Redirecting..." | No csn in session, or the login session expired | Log in again or select a project, then reopen the page. |
| No config cards appear | No Vercel configs are registered for the current project | Register a new Vercel config with the [Add Config] button. |
| Latest deployment status is not shown | No deployment history yet because it hasn't been synced | Press the [Sync] button on the card to fetch data from Vercel. |
Deployment status shows ERROR | The Vercel build failed | Check the build logs in the deployment URL or the Vercel dashboard. |
| Sync fails | The Vercel token is expired or invalid | Update a valid token in the config [Edit] screen, then sync again. |
Version: 1.0
Last Updated: 2026-07-22
Source: giipv3/public/help/vercel-status.en.md