.default})
-### Example
+**Example**
Ignoring a "Last updated" timestamp in a dashboard that changes with each page load.
@@ -134,11 +134,11 @@ Ignoring a "Last updated" timestamp in a dashboard that changes with each page l
.default})
+
+### Selection states
+
+| State | Description | Screenshot |
+| --- | --- | --- |
+| None selected | Bulk action buttons stay disabled until at least one screenshot is selected. | .default})
|
+| Single selection | Shows contextual details (name, viewport, status). Bulk buttons activate. | .default})
|
+| Multi selection | Displays count (e.g., “3 selected”) and unlocks all bulk actions. | .default})
|
+
+Use the checkbox beside each screenshot card or the **Select All** checkbox in the toolbar to toggle selections quickly.
+
+---
+
+## Bulk actions
+
+### Approve screenshots
+
+Ideal when only a subset of diffs are valid.
+
+1. Filter to **Failed** or **Pending** tab.
+2. Select the screenshots that represent expected UI updates.
+3. Click **Approve**.
+
+.default})
+
+SmartUI will:
+- Mark each screenshot as **Approved**.
+- Move them to the **Approved** tab for auditing.
+- Preserve audit logs with the approver name and timestamp.
+
+### Reject screenshots
+
+Use this when a diff is unexpected, unstable, or blocked by other issues.
+
+1. Select the screenshots within **Failed**/**Pending**.
+2. Click **Reject**.
+
+.default})
+
+Rejected screenshots move to the **Rejected** tab and remain available for future comparison runs.
+
+### Move approved screenshots to Baseline
+
+Once approved diffs represent the new expected UI, promote them to Baseline:
+
+1. Go to the **Approved** tab.
+2. Select individual screenshots, curated subsets, or **Select All**.
+3. Click **Move to Baseline**.
+
+.default})
+
+> Baseline moves update the reference snapshot for the next comparison. Ensure you only promote validated UI changes to keep noise low in future runs.
+
+---
+
+## Multiselect workflow example
+
+-
+
- Apply filters (approver, status, tab) before using Select All. +
- Confirm the selected count matches expectations to avoid cross-build approvals. +
-
+
- Bulk actions are powerful—always double-check each screenshot thumbnail. +
- Use single selection for high-risk diffs (checkout, payments, authentication). +
-
+
- After approving or rejecting, verify the activity log for transparency. +
- If anything was mis-clicked, undo by moving screenshots back via their tab. +
-
+
- Promote to baseline only after QA sign-off. +
- Keep a release branch baseline separate using Smart Git. +
Symptoms: Checkboxes or bulk buttons stay disabled.
+Fixes:
+-
+
- Confirm you are in the Builds view, not inside an individual screenshot diff. +
- Refresh the page or clear cache if the toolbar fails to render. +
- Ensure your role has approval permissions on the project. +
Symptoms: Toast error when approving/rejecting.
+Fixes:
+-
+
- Retry after verifying network connectivity. +
- Confirm the build is still active (not archived). +
- Check SmartUI Troubleshooting Guide for API rate limits or backend incidents. +
Symptoms: Move to Baseline button disabled or no visible changes after promotion.
+Fixes:
+-
+
- Only Approved screenshots can be promoted; re-approve if needed. +
- Baseline updates can take a minute to propagate—refresh or reopen the build. +
- Ensure the associated branch/build is not locked by automated workflows. +
.default})
@@ -142,13 +142,13 @@ Altering Approvers will impact email notifications, which will be sent to the la
.default})
Comparison settings allow you to fine-tune how SmartUI compares screenshots, balancing between highlighting important changes and ignoring noise.
-### Pixel Threshold
+**Pixel Threshold**
Strike a balance between highlighting important changes and ignoring noise. The pixel threshold determines the sensitivity of the comparison algorithm.
@@ -165,7 +165,7 @@ Strike a balance between highlighting important changes and ignoring noise. The
Adjusting the Pixel Threshold in Comparison Settings will only affect new builds/screenshots captured after the update.
:::
-### Error Highlight Color
+**Error Highlight Color**
Set the color to show/highlight the changes in the pixel differences on your test output.
@@ -180,7 +180,7 @@ Set the color to show/highlight the changes in the pixel differences on your tes
**Use Case**: Choose a color that provides good contrast against your page background for easier visual identification of differences.
-### Custom Mismatch Acceptance
+**Custom Mismatch Acceptance**
Configure pixel-to-pixel acceptance percentage for auto-approval.
@@ -194,7 +194,7 @@ Configure pixel-to-pixel acceptance percentage for auto-approval.
**Use Case**: Automatically approve screenshots with differences below the acceptance threshold, reducing manual review time.
-### Smart Ignore
+**Smart Ignore**
Highlight content changes while smartly ignoring layout shifts and displacement differences.
@@ -207,7 +207,7 @@ Highlight content changes while smartly ignoring layout shifts and displacement
For detailed information, refer to [Smart Ignore Documentation](/support/docs/smartui-smartignore).
-### Bounding Boxes
+**Bounding Boxes**
Configure your areas to which needs to be ignored or select a specific area for comparison.
@@ -216,11 +216,11 @@ Configure your areas to which needs to be ignored or select a specific area for
- Focus comparison on specific areas (main content, critical UI)
- Define regions of interest for comparison
-### Advanced Comparison Settings
+**Advanced Comparison Settings**
Manage your Pixel to Pixel false positives and comparison view types.
-#### Ignore Pixel Scaling Options
+**Ignore Pixel Scaling Options**
Choose options to remove the Pixel to Pixel false-positive rate in identifying the screenshot.
@@ -233,7 +233,7 @@ Choose options to remove the Pixel to Pixel false-positive rate in identifying t
**Use Case**: Reduce false positives from rendering differences, browser-specific rendering, or minor pixel variations.
-#### Error Type Identifier
+**Error Type Identifier**
Show the differences in the output screen by identifying the pixel changes type and capture the intended view.
@@ -246,7 +246,7 @@ Show the differences in the output screen by identifying the pixel changes type
**Use Case**: Choose the view that best helps you identify and understand the differences in your screenshots.
-#### Transparency
+**Transparency**
Strike a balance between highlighting differences and maintaining visibility of the underlying content.
@@ -256,7 +256,7 @@ Strike a balance between highlighting differences and maintaining visibility of
**Use Case**: Adjust transparency to see both the differences and the original content for better context.
-#### Resize Image
+**Resize Image**
Ability to scale the test screenshot according to baseline.
@@ -270,16 +270,16 @@ Ability to scale the test screenshot according to baseline.
Changes to Project Settings will impact builds/comparisons executed after the changes and the previous builds/comparisons remain unaffected.
:::
-#### Additional Information:
+**Additional Information:**
For detailed information on these options, refer to our [Comparison Settings Documentation](https://www.lambdatest.com/support/docs/test-settings-options/).
.default})
@@ -299,14 +299,14 @@ When **`Smart Baseline`** is turned on, the system automatically updates the bas
Please note that this feature is not supported for projects integrated with `Git` as `Git`-based projects follow a [Git branching strategy](https://www.lambdatest.com/support/docs/smartui-github-app-integration/).
:::
-### Git Settings
+**Git Settings**
Configure Git-related settings for your project, including the baseline branch name, auto-approval branches, GitHub repository linkage, and run status checks.
-#### Additional Information:
+**Additional Information:**
For detailed information on these options, refer to our [Git Baseline Branching Documentation](https://www.lambdatest.com/support/docs/smartui-github-app-integration/).
-### Overwrite Screenshot
+**Overwrite Screenshot**
.default})
@@ -318,13 +318,13 @@ For detailed information on these options, refer to our [Git Baseline Branching
.default})
Configure how you receive alerts and updates about your SmartUI project.
-### Email Notifications
+**Email Notifications**
Receive email notifications whenever there are changes found in your build or the project baseline changes.
@@ -335,7 +335,7 @@ Receive email notifications whenever there are changes found in your build or th
**Use Case**: Stay informed about visual changes without constantly checking the dashboard.
-### Slack Alerts
+**Slack Alerts**
Receive Slack alerts whenever there are changes found in your build.
@@ -354,7 +354,7 @@ We are continually adding more notification channels for SmartUI.
.default})
diff --git a/docs/smartui-puppeteer-sdk.md b/docs/smartui-puppeteer-sdk.md
index c243c650..c564d5b9 100644
--- a/docs/smartui-puppeteer-sdk.md
+++ b/docs/smartui-puppeteer-sdk.md
@@ -469,7 +469,7 @@ const { smartuiSnapshot } = require('@lambdatest/puppeteer-driver');