# Managing URLs — psiLynx

> The project page has two tabs: **Overview** (aggregated results after each scan) and **URLs** (your URL list, run controls, and settings).

## Overview tab

The Overview tab opens by default when you enter a project. It shows aggregated results from the latest completed scan: Health Score, per-platform averages, Core Web Vitals, AI insights, attention URLs, and a breakdown by page type.

### Health Score

A weighted composite score on a 0–100 scale:

| Category | Weight |
|---|---|
| Performance | 50% |
| SEO | 25% |
| Accessibility | 15% |
| Best Practices | 10% |

Colour coding: ● 90–100 good · ● 50–89 needs attention · ● 0–49 critical.

### Average metrics

Project-wide averages across all checked URLs — separately for **Mobile** and **Desktop**: Performance, Accessibility, Best Practices, SEO.

### Core Web Vitals

Key user experience metrics with Good / Needs Improvement / Poor thresholds:

| Metric | Description | Good threshold |
|---|---|---|
| **LCP** | Largest Contentful Paint — main content load time | < 2.5 s |
| **CLS** | Cumulative Layout Shift — layout stability | < 0.1 |
| **FCP** | First Contentful Paint — time to first visible content | < 1.8 s |
| **INP** | Interaction to Next Paint — interaction responsiveness | < 200 ms |
| **TTFB** | Time to First Byte — server response speed | < 800 ms |

### Interpretation & Recommendations

Two sections generated automatically after every completed scan.

**Detected Issues** — key performance problems, each with:
- **Title** — headline summarising the issue
- **Impact** — business consequence: effect on traffic, conversions, bounce rate, or SEO
- **Cause** — technical root cause

**Improvement Recommendations** — concrete actions, each with:
- **Title** — action headline
- **Outcome** — expected business result after implementing the fix
- **Action** — technical steps with tools and methods

### Attention URLs

URLs that need immediate attention from the latest scan:
- **Critical** — Performance Score < 50 (all shown)
- **Warning** — Performance Score 50–69 (up to 10 shown)

### By Page Type

A summary table comparing performance across your project's page types (e.g. Homepage, PDP, Blog). Rows are sorted worst-to-best by Performance score.

| Column | Description |
|---|---|
| Page Type | Name, colour label, and status dot |
| URLs | Checked / Total |
| Perf Mobile / Desktop | Performance Score — mobile and desktop averages |
| LCP Mobile / Desktop | Average LCP |
| CLS Mobile / Desktop | Average CLS |
| FCP Mobile / Desktop | Average FCP |

> Overview data always reflects the **latest completed scan**. If no scan has run yet, the tab shows an empty state.

## URLs tab

Switch to the **URLs** tab to manage your URL list, run checks, and review individual results.

### Quota indicator

A progress bar shows your weekly check usage in the format **45 / 1000 used** with the remaining count alongside your plan name. The bar turns red when less than 10% of your quota remains.

## Adding URLs

### Add a single URL

1. Click **+ Add URL** in the top-right corner.
2. Enter the **path** — the part of the URL after the domain, e.g. `/about`.
3. Optionally enter a **Label** — a human-readable name.
4. Select **platforms**: Mobile, Desktop, or both.
5. Click **Add**.

> If you paste a full URL into the path field, psiLynx automatically strips the domain and keeps only the path.

### Import multiple URLs

1. Click **Import**.
2. Choose a format:

| Format | Structure |
|---|---|
| **CSV** | Column `url` (required), `label` (optional) |
| **JSON** | Array of objects: `[{"url": "/page", "label": "Name"}]` |
| **Sitemap XML** | Standard XML sitemap file |

3. Upload your file (up to 5 MB).
4. Review the preview — valid and invalid URLs are highlighted.
5. Uncheck any URLs you want to skip.
6. Click **Import X URLs**.

> The maximum number of URLs is determined by your plan. When the limit is reached, the Add and Import buttons are disabled.

## Running a check

1. Click **Run Check** in the top-right corner.
2. psiLynx automatically checks whether all active URLs are reachable (HTTP probe, up to 5 s per URL):
   - **All URLs accessible** — the confirmation dialog opens immediately.
   - **Some URLs unreachable** — an availability modal appears first.
3. In the **availability modal** (if shown), each unreachable URL displays its status: HTTP error code, *Timeout*, or *Redirect loop*. Click **Skip unavailable and start** to proceed with accessible URLs only.
4. In the **confirmation dialog**, review: number of active URLs, number of checks (mobile + desktop), quota cost, and remaining quota after the run.
5. Click **Run Check** to start.

### Accuracy Mode

In **Settings** you can enable Accuracy Mode. Each URL is checked multiple times and the results are averaged for greater reliability — but quota usage multiplies accordingly (e.g. ×3).

### Check progress

While a scan is running, a blue banner shows:
- Current progress: **X / Y URLs**
- Elapsed time
- A **Cancel scan** button (requires confirmation)

### After completion

A result banner replaces the progress bar:
- **Green** — "All checks passed" — every URL succeeded
- **Yellow** — "Checks completed with errors" — some URLs failed

If there were errors, a **Repeat failed** button lets you re-run only the problem URLs without consuming quota for the successful ones.

## URL table

### Columns

| Column | Contents |
|---|---|
| **URL** | Page address, label, and page type |
| **Last check** | Mobile and desktop scores, date, and change vs. previous check |
| **Status** | Active / Paused |
| **Actions** | Edit, Pause/Activate, Delete |

Score colour coding: ● 90–100 Good · ● 50–89 Needs attention · ● 0–49 Critical. Arrows (↑↓) show the change vs. the previous check.

### Search and filters

- **Search** — by URL or label
- **Platform**: All / Mobile / Desktop
- **Score**: All / Good / Warning / Critical
- **Page type**: All types, or filter by specific type

## Bulk actions

Check the boxes next to the URLs you want (or use the header checkbox to select all). A bulk action bar appears:

| Action | Result |
|---|---|
| **Activate** | Set selected URLs to Active |
| **Pause** | Set selected URLs to Paused |
| **Run check** | Run a check for selected URLs only |
| **Assign type** | Assign a page type to selected URLs |
| **Delete** | Delete selected URLs (requires confirmation) |

## Editing a URL

1. Click the pencil icon in the URL row.
2. Edit the **label** or **platforms**.
3. Click **Save**.

> The URL address itself cannot be changed — only the label and platforms.

## Pausing and activating URLs

- Click the pause icon — the URL moves to **Paused** status and is excluded from future checks.
- Click the play icon — the URL becomes **Active** again.

> Checks only run against **active** URLs. Historical results are preserved for paused URLs.

## Deleting a URL

1. Click the trash icon in the URL row.
2. Confirm the deletion.

> Deletion is permanent. All check history for that URL will be lost.