Help

Help and knowledge base for Spotless

Browse guides and playbooks for audits, duplicates, workflows, settings, and troubleshooting.

Includes
  • - First-run analysis and audit snapshot guides
  • - Duplicate Radar and workflow merge playbooks
  • - Workflow audit, changes, and AI insight guidance
  • - Settings, team access, notifications, and troubleshooting

Some article links open app pages and may require sign-in.

Search knowledge base

Find articles by keyword, monitor name, workflow, or outcome.

29 articles

Getting started

Set up your workspace and get to your first trusted result quickly.

Connect HubSpot and choose your workspace

Connect the right portal, confirm permissions, and make sure data can be read for scans.

4 minOutcome: Your workspace is connected and ready to run scans.
Read article

Before you start

  • - Confirm you are in the correct workspace and HubSpot portal.
  • - Use an admin account so permissions and settings can be updated.

Step-by-step

  1. 1. Go to Settings and connect HubSpot.
  2. 2. Confirm the portal selected is the one you want to monitor.
  3. 3. Approve the permissions prompt and verify connection status.

Verify success

  • - Your workspace is connected and ready to run scans.
  • - The destination page/action opens without errors.
  • - You can repeat this workflow with the same result.

If something looks wrong

  • - If connection fails, reconnect HubSpot in Settings and approve all required scopes.
  • - If pages look empty, refresh the workspace selector and confirm the active workspace.

Run your first health check

Launch an on-demand scan, wait for completion, and understand where to start fixing issues.

5 minOutcome: You have your first set of findings and a clear action order.
Read article

Before you start

  • - Confirm you are in the correct workspace and HubSpot portal.
  • - Use an admin account so permissions and settings can be updated.

Step-by-step

  1. 1. Open Dashboard and run a health check.
  2. 2. Wait for scan completion and review top risk areas.
  3. 3. Move into Issues and start with highest impact categories.

Verify success

  • - You have your first set of findings and a clear action order.
  • - The destination page/action opens without errors.
  • - You can repeat this workflow with the same result.

If something looks wrong

  • - If connection fails, reconnect HubSpot in Settings and approve all required scopes.
  • - If pages look empty, refresh the workspace selector and confirm the active workspace.

Understand the first-run analysis screen

Use the guided analysis flow to monitor first-run progress before landing in your initial audit snapshot.

3 minOutcome: You can tell whether first-run setup is still processing or ready for review.
Read article

Before you start

  • - Confirm you are in the correct workspace and HubSpot portal.
  • - Use an admin account so permissions and settings can be updated.

Step-by-step

  1. 1. Start your first analysis and keep the tab open while checks run.
  2. 2. Watch progress through automation, data architecture, process, and governance steps.
  3. 3. Open the audit snapshot once the flow completes and begin triage.

Verify success

  • - You can tell whether first-run setup is still processing or ready for review.
  • - The destination page/action opens without errors.
  • - You can repeat this workflow with the same result.

If something looks wrong

  • - If connection fails, reconnect HubSpot in Settings and approve all required scopes.
  • - If pages look empty, refresh the workspace selector and confirm the active workspace.

Understand usage and limits

See what each usage metric means and how limits affect governance runs, duplicates, and exports.

3 minOutcome: You know what is included in your current plan and when to upgrade.
Read article

Before you start

  • - Confirm you are in the correct workspace and HubSpot portal.
  • - Use an admin account so permissions and settings can be updated.

Step-by-step

  1. 1. Check plan and usage status from Settings.
  2. 2. Treat Property Audit refresh as included with audit and health check runs.
  3. 3. Use Scale when you need higher governance throughput, 500 AI insights/month, and near-unlimited duplicate refresh capacity.
  4. 4. Review which quotas are scan-based versus record-based.
  5. 5. Decide whether to adjust usage or upgrade when limits are hit.

Verify success

  • - You know what is included in your current plan and when to upgrade.
  • - The destination page/action opens without errors.
  • - You can repeat this workflow with the same result.

If something looks wrong

  • - If connection fails, reconnect HubSpot in Settings and approve all required scopes.
  • - If pages look empty, refresh the workspace selector and confirm the active workspace.

Health checks and monitors

Learn what each monitor catches and how to tune checks for your process.

Monitor categories and what they detect

Breakdown of monitor categories and common HubSpot risks each one flags.

6 minOutcome: You can enable the right checks for your current data priorities.
Read article

Before you start

  • - Define which teams own contact, company, and deal data quality.
  • - Align required fields and stage definitions with your current process.

Step-by-step

  1. 1. Open Monitors and review each category.
  2. 2. Enable recommended checks first.
  3. 3. Disable low-value checks and tune thresholds for your team.

Verify success

  • - You can enable the right checks for your current data priorities.
  • - The destination page/action opens without errors.
  • - You can repeat this workflow with the same result.

If something looks wrong

  • - If a monitor is unavailable, verify HubSpot connection and required permissions.
  • - If findings feel noisy, reduce scope and tune thresholds before rerunning.

Required fields by lifecycle stage

Define required contact/company fields by lifecycle stage to keep handoffs clean.

5 minOutcome: Records cannot progress without the critical fields your team needs.
Read article

Before you start

  • - Define which teams own contact, company, and deal data quality.
  • - Align required fields and stage definitions with your current process.

Step-by-step

  1. 1. Map lifecycle stages to must-have fields.
  2. 2. Add stage-specific required field rules.
  3. 3. Re-run checks to verify missing-field findings reduce.

Verify success

  • - Records cannot progress without the critical fields your team needs.
  • - The destination page/action opens without errors.
  • - You can repeat this workflow with the same result.

If something looks wrong

  • - If a monitor is unavailable, verify HubSpot connection and required permissions.
  • - If findings feel noisy, reduce scope and tune thresholds before rerunning.

Required fields by deal stage

Set required properties per pipeline stage to improve forecast quality and rep discipline.

5 minOutcome: Deal progression enforces the key information needed at each stage.
Read article

Before you start

  • - Define which teams own contact, company, and deal data quality.
  • - Align required fields and stage definitions with your current process.

Step-by-step

  1. 1. Review your pipeline stages and criteria.
  2. 2. Set stage-level required properties.
  3. 3. Validate by running a health check and reviewing deal issues.

Verify success

  • - Deal progression enforces the key information needed at each stage.
  • - The destination page/action opens without errors.
  • - You can repeat this workflow with the same result.

If something looks wrong

  • - If a monitor is unavailable, verify HubSpot connection and required permissions.
  • - If findings feel noisy, reduce scope and tune thresholds before rerunning.

Schedule recurring checks and alerts

Set daily/weekly cadence so issues are found early and shared automatically.

4 minOutcome: Checks run automatically and the right people are notified.
Read article

Before you start

  • - Define which teams own contact, company, and deal data quality.
  • - Align required fields and stage definitions with your current process.

Step-by-step

  1. 1. Open Settings and define check schedule.
  2. 2. Configure notification channels and recipients.
  3. 3. Review next run timing and status in Runs.

Verify success

  • - Checks run automatically and the right people are notified.
  • - The destination page/action opens without errors.
  • - You can repeat this workflow with the same result.

If something looks wrong

  • - If a monitor is unavailable, verify HubSpot connection and required permissions.
  • - If findings feel noisy, reduce scope and tune thresholds before rerunning.

Pause, resume, and re-run failed checks

Control in-flight or completed runs when you need to pause workload or retry only failed monitors.

4 minOutcome: You can recover scans faster without restarting full checks every time.
Read article

Before you start

  • - Define which teams own contact, company, and deal data quality.
  • - Align required fields and stage definitions with your current process.

Step-by-step

  1. 1. Open a run from Health Checks history.
  2. 2. Use Pause checks during long runs, then Resume checks when ready.
  3. 3. After completion, use Re-run failed checks to retry only failed monitors.

Verify success

  • - You can recover scans faster without restarting full checks every time.
  • - The destination page/action opens without errors.
  • - You can repeat this workflow with the same result.

If something looks wrong

  • - If a monitor is unavailable, verify HubSpot connection and required permissions.
  • - If findings feel noisy, reduce scope and tune thresholds before rerunning.

Issues and fix workflows

Turn findings into clear, prioritized action with less noise.

Work from issue categories first

Use category-level view to prioritize high-impact issues before diving into record detail.

4 minOutcome: You focus on the biggest risks and avoid list fatigue.
Read article

Before you start

  • - Agree a weekly cadence for issue triage and remediation.
  • - Decide who owns each issue category before bulk changes.

Step-by-step

  1. 1. Start in the overview counters.
  2. 2. Select one category at a time to narrow scope.
  3. 3. Move through records in that category before switching.

Verify success

  • - You focus on the biggest risks and avoid list fatigue.
  • - The destination page/action opens without errors.
  • - You can repeat this workflow with the same result.

If something looks wrong

  • - If issue counts jump unexpectedly, compare the latest run with the prior run.
  • - If duplicates dominate, run Duplicate Radar first, then rerun checks.

Use the Fix Plan to sequence remediation

Follow the platform’s recommended order so your team resolves issues efficiently.

4 minOutcome: Your team has a practical, low-friction order of operations.
Read article

Before you start

  • - Agree a weekly cadence for issue triage and remediation.
  • - Decide who owns each issue category before bulk changes.

Step-by-step

  1. 1. Review top recommendations in the Fix Plan.
  2. 2. Assign ownership by category.
  3. 3. Track issue counts down over each run.

Verify success

  • - Your team has a practical, low-friction order of operations.
  • - The destination page/action opens without errors.
  • - You can repeat this workflow with the same result.

If something looks wrong

  • - If issue counts jump unexpectedly, compare the latest run with the prior run.
  • - If duplicates dominate, run Duplicate Radar first, then rerun checks.

Use Fix Mode vs Explore Mode

Switch between focused execution and full reporting views to match the stage of your cleanup cycle.

3 minOutcome: Your team stays focused during remediation while preserving access to deeper reporting when needed.
Read article

Before you start

  • - Agree a weekly cadence for issue triage and remediation.
  • - Decide who owns each issue category before bulk changes.

Step-by-step

  1. 1. Use Fix Mode when actively resolving high-impact issues.
  2. 2. Switch to Explore Mode for trend analysis, history, and broader reporting.
  3. 3. Return to Fix Mode after review to keep execution focused.

Verify success

  • - Your team stays focused during remediation while preserving access to deeper reporting when needed.
  • - The destination page/action opens without errors.
  • - You can repeat this workflow with the same result.

If something looks wrong

  • - If issue counts jump unexpectedly, compare the latest run with the prior run.
  • - If duplicates dominate, run Duplicate Radar first, then rerun checks.

Bulk update issue lifecycle status

Apply OPEN, IN_PROGRESS, FIXED, or IGNORED status to many records at once with optional owner and due date.

4 minOutcome: Issue queues stay current with ownership and due dates without one-by-one edits.
Read article

Before you start

  • - Agree a weekly cadence for issue triage and remediation.
  • - Decide who owns each issue category before bulk changes.

Step-by-step

  1. 1. Switch Issues to All records view.
  2. 2. Select visible records and choose status, assignee, due date, and note.
  3. 3. Apply changes and refresh to confirm updated lifecycle state.

Verify success

  • - Issue queues stay current with ownership and due dates without one-by-one edits.
  • - The destination page/action opens without errors.
  • - You can repeat this workflow with the same result.

If something looks wrong

  • - If issue counts jump unexpectedly, compare the latest run with the prior run.
  • - If duplicates dominate, run Duplicate Radar first, then rerun checks.

Create HubSpot static lists from issues

Build one or more HubSpot static lists directly from selected issue records to drive owner follow-up.

4 minOutcome: Selected issue records are turned into actionable HubSpot lists for downstream cleanup.
Read article

Before you start

  • - Agree a weekly cadence for issue triage and remediation.
  • - Decide who owns each issue category before bulk changes.

Step-by-step

  1. 1. Filter to the issue scope you want to action and switch to All records view.
  2. 2. Select records and set a list name in the HubSpot static list panel.
  3. 3. Create list and review created/skipped/unsupported totals.

Verify success

  • - Selected issue records are turned into actionable HubSpot lists for downstream cleanup.
  • - The destination page/action opens without errors.
  • - You can repeat this workflow with the same result.

If something looks wrong

  • - If issue counts jump unexpectedly, compare the latest run with the prior run.
  • - If duplicates dominate, run Duplicate Radar first, then rerun checks.

Export findings for ops and leadership

Generate exports for stakeholders who need detail, summary, or point-in-time evidence.

3 minOutcome: You can share actionable findings and progress externally.
Read article

Before you start

  • - Agree a weekly cadence for issue triage and remediation.
  • - Decide who owns each issue category before bulk changes.

Step-by-step

  1. 1. Apply filters to focus the dataset.
  2. 2. Export in the required format.
  3. 3. Share with owners and set due dates.

Verify success

  • - You can share actionable findings and progress externally.
  • - The destination page/action opens without errors.
  • - You can repeat this workflow with the same result.

If something looks wrong

  • - If issue counts jump unexpectedly, compare the latest run with the prior run.
  • - If duplicates dominate, run Duplicate Radar first, then rerun checks.

Audit and reporting

Use audits for governance snapshots, trend tracking, and stakeholder updates.

Read audit scorecards confidently

Understand score meaning, severity signals, and what to fix first for maximum impact.

5 minOutcome: You can explain current portal health and remediation priorities clearly.
Read article

Before you start

  • - Run a fresh audit before sharing any score externally.
  • - Use the same workspace/portal each time for consistent trend tracking.

Step-by-step

  1. 1. Open audit and review status by section.
  2. 2. Focus on critical/warn items first.
  3. 3. Use linked findings to move from score to action.

Verify success

  • - You can explain current portal health and remediation priorities clearly.
  • - The destination page/action opens without errors.
  • - You can repeat this workflow with the same result.

If something looks wrong

  • - If scores look stale, run a fresh scan and reload the audit page.
  • - If export fails, retry after scan completion and check browser popup settings.

Use the guide and export PDF summary

Walk through audit sections with context and export a shareable summary report.

3 minOutcome: You can produce a clean audit report for internal or client review.
Read article

Before you start

  • - Run a fresh audit before sharing any score externally.
  • - Use the same workspace/portal each time for consistent trend tracking.

Step-by-step

  1. 1. Run a fresh audit for current data.
  2. 2. Open the page guide for section context.
  3. 3. Export the summary PDF and share.

Verify success

  • - You can produce a clean audit report for internal or client review.
  • - The destination page/action opens without errors.
  • - You can repeat this workflow with the same result.

If something looks wrong

  • - If scores look stale, run a fresh scan and reload the audit page.
  • - If export fails, retry after scan completion and check browser popup settings.

Run Property Audit and apply decisions

Refresh property signals, classify risky properties, and sync review/deprecate decisions into HubSpot groups.

6 minOutcome: You have an auditable decision trail for property cleanup with clearer next actions.
Read article

Before you start

  • - Run a fresh audit before sharing any score externally.
  • - Use the same workspace/portal each time for consistent trend tracking.

Step-by-step

  1. 1. Open Property Audit and run Refresh to pull the latest metadata and usage signals.
  2. 2. Filter by object, recommendation, decision, and search to isolate a cleanup batch.
  3. 3. Apply row-level or bulk decisions and confirm Review/Deprecate sync feedback.
  4. 4. Export CSV when you need external review or handoff.

Verify success

  • - You have an auditable decision trail for property cleanup with clearer next actions.
  • - The destination page/action opens without errors.
  • - You can repeat this workflow with the same result.

If something looks wrong

  • - If scores look stale, run a fresh scan and reload the audit page.
  • - If export fails, retry after scan completion and check browser popup settings.

Duplicate Radar and HubSpot merge

Review and prioritize duplicates in Spotless, then execute merges in the HubSpot card or workflow tools.

Confidence tiers and review guardrails

Learn how confidence levels are assigned and when cleanup should stay in review mode.

5 minOutcome: You can decide quickly when to hand off to HubSpot execution versus keep reviewing.
Read article

Before you start

  • - Confirm duplicate rules are reviewed before enabling team-wide merge workflows.
  • - Ensure key users understand primary-vs-merge direction before actioning records.

Step-by-step

  1. 1. Review the confidence tier on each candidate in the app queue.
  2. 2. Check guardrail messages before handing off the record.
  3. 3. Use the HubSpot card or workflow action only when confidence and context align.

Verify success

  • - You can decide quickly when to hand off to HubSpot execution versus keep reviewing.
  • - The destination page/action opens without errors.
  • - You can repeat this workflow with the same result.

If something looks wrong

  • - If merge is blocked, read guardrail reason and resolve activity/conflict first.
  • - If card data is missing, reload record and verify portal connection status.

Use the HubSpot sidebar card to execute merges

Work duplicate candidates directly inside contact/company/deal records with focused actions.

4 minOutcome: Teams can review and action duplicates without leaving HubSpot.
Read article

Before you start

  • - Confirm duplicate rules are reviewed before enabling team-wide merge workflows.
  • - Ensure key users understand primary-vs-merge direction before actioning records.

Step-by-step

  1. 1. Open a record and load the Spotless Duplicate Radar card.
  2. 2. Review the suggested primary and candidate records in the card.
  3. 3. Use the merge and cleanup actions in HubSpot after the app review queue has narrowed the work.

Verify success

  • - Teams can review and action duplicates without leaving HubSpot.
  • - The destination page/action opens without errors.
  • - You can repeat this workflow with the same result.

If something looks wrong

  • - If merge is blocked, read guardrail reason and resolve activity/conflict first.
  • - If card data is missing, reload record and verify portal connection status.

Merge records safely into primary in HubSpot

Use the HubSpot merge preview and confirmation flow to avoid accidental data loss.

4 minOutcome: Merges happen in HubSpot with clearer intent and lower risk.
Read article

Before you start

  • - Confirm duplicate rules are reviewed before enabling team-wide merge workflows.
  • - Ensure key users understand primary-vs-merge direction before actioning records.

Step-by-step

  1. 1. Open the Spotless card or workflow action for a candidate.
  2. 2. Confirm the primary/merge direction and review warnings.
  3. 3. Run the merge and verify the success message in HubSpot.

Verify success

  • - Merges happen in HubSpot with clearer intent and lower risk.
  • - The destination page/action opens without errors.
  • - You can repeat this workflow with the same result.

If something looks wrong

  • - If merge is blocked, read guardrail reason and resolve activity/conflict first.
  • - If card data is missing, reload record and verify portal connection status.

Duplicate property and smart lists

Use `spotless_duplicate` to segment duplicate contacts/companies and power downstream workflows.

5 minOutcome: Duplicates become visible in HubSpot lists and automations.
Read article

Before you start

  • - Confirm duplicate rules are reviewed before enabling team-wide merge workflows.
  • - Ensure key users understand primary-vs-merge direction before actioning records.

Step-by-step

  1. 1. Run duplicate refresh to identify records.
  2. 2. Sync duplicate property flags into HubSpot.
  3. 3. Use the generated lists to prioritize cleanup.

Verify success

  • - Duplicates become visible in HubSpot lists and automations.
  • - The destination page/action opens without errors.
  • - You can repeat this workflow with the same result.

If something looks wrong

  • - If merge is blocked, read guardrail reason and resolve activity/conflict first.
  • - If card data is missing, reload record and verify portal connection status.

Workflow action: Spotless merge into primary

Automate merges in HubSpot workflows using the Spotless custom action safely.

5 minOutcome: You can automate duplicate cleanup for flagged records at scale.
Read article

Before you start

  • - Confirm duplicate rules are reviewed before enabling team-wide merge workflows.
  • - Ensure key users understand primary-vs-merge direction before actioning records.

Step-by-step

  1. 1. Add Spotless merge action to a workflow.
  2. 2. Gate entry on duplicate flag and object type.
  3. 3. Review output fields for status and merged count.

Verify success

  • - You can automate duplicate cleanup for flagged records at scale.
  • - The destination page/action opens without errors.
  • - You can repeat this workflow with the same result.

If something looks wrong

  • - If merge is blocked, read guardrail reason and resolve activity/conflict first.
  • - If card data is missing, reload record and verify portal connection status.

Workflows and workspace settings

Manage automation hygiene, team setup, and operational controls.

Run workflow audits and compare changes

Audit workflow setup, monitor drift, and compare snapshots over time.

4 minOutcome: You can spot risky workflow changes before they impact pipeline.
Read article

Before you start

  • - Confirm role ownership for automation changes and app settings.
  • - Document current workflow state before applying major changes.

Step-by-step

  1. 1. Run a workflow refresh.
  2. 2. Inspect status and drift insights.
  3. 3. Export change sets for documentation.

Verify success

  • - You can spot risky workflow changes before they impact pipeline.
  • - The destination page/action opens without errors.
  • - You can repeat this workflow with the same result.

If something looks wrong

  • - If workflow actions do not appear, recheck app deployment and installed scopes.
  • - If member access looks wrong, review role assignments in workspace settings.

Use AI workflow change insights

Generate AI summaries on the Changes tab to understand what shifted and where to focus first.

4 minOutcome: You get a faster narrative of workflow drift and a clearer remediation focus.
Read article

Before you start

  • - Confirm role ownership for automation changes and app settings.
  • - Document current workflow state before applying major changes.

Step-by-step

  1. 1. Open Workflows and switch to the Changes tab.
  2. 2. Review added/removed/changed workflows and risk changes.
  3. 3. Use the AI insight panel to identify key changes and recommended focus.

Verify success

  • - You get a faster narrative of workflow drift and a clearer remediation focus.
  • - The destination page/action opens without errors.
  • - You can repeat this workflow with the same result.

If something looks wrong

  • - If workflow actions do not appear, recheck app deployment and installed scopes.
  • - If member access looks wrong, review role assignments in workspace settings.

Configure notification digests (email and Slack)

Set delivery channels for completed health-check digests and keep recipients aligned across teams.

3 minOutcome: The right stakeholders receive digest updates automatically after completed scans.
Read article

Before you start

  • - Confirm role ownership for automation changes and app settings.
  • - Document current workflow state before applying major changes.

Step-by-step

  1. 1. Open Notifications and enable email and/or Slack delivery.
  2. 2. Set recipient emails and webhook details, then save.
  3. 3. Confirm status badges and review the digest preview panel.

Verify success

  • - The right stakeholders receive digest updates automatically after completed scans.
  • - The destination page/action opens without errors.
  • - You can repeat this workflow with the same result.

If something looks wrong

  • - If workflow actions do not appear, recheck app deployment and installed scopes.
  • - If member access looks wrong, review role assignments in workspace settings.

Review scope health and export security summary

Validate required HubSpot scopes and download a workspace security summary for internal review.

4 minOutcome: You can confirm permissions health and share compliance context with security stakeholders.
Read article

Before you start

  • - Confirm role ownership for automation changes and app settings.
  • - Document current workflow state before applying major changes.

Step-by-step

  1. 1. Open Workspace settings and review HubSpot scope health status.
  2. 2. Inspect missing scopes and feature impacts if action is required.
  3. 3. Download the security summary for audit/compliance documentation.

Verify success

  • - You can confirm permissions health and share compliance context with security stakeholders.
  • - The destination page/action opens without errors.
  • - You can repeat this workflow with the same result.

If something looks wrong

  • - If workflow actions do not appear, recheck app deployment and installed scopes.
  • - If member access looks wrong, review role assignments in workspace settings.

Manage workspace members and roles

Invite teammates, assign access levels, and keep ownership clear.

3 minOutcome: Your workspace is secure, collaborative, and properly scoped.
Read article

Before you start

  • - Confirm role ownership for automation changes and app settings.
  • - Document current workflow state before applying major changes.

Step-by-step

  1. 1. Open member settings and invite users.
  2. 2. Set role access and responsibilities.
  3. 3. Review account ownership and admin coverage.

Verify success

  • - Your workspace is secure, collaborative, and properly scoped.
  • - The destination page/action opens without errors.
  • - You can repeat this workflow with the same result.

If something looks wrong

  • - If workflow actions do not appear, recheck app deployment and installed scopes.
  • - If member access looks wrong, review role assignments in workspace settings.

HubSpot connection troubleshooting

Fix common OAuth issues, scope mismatches, and reconnect blockers.

5 minOutcome: You can restore connection quickly without breaking app setup.
Read article

Before you start

  • - Confirm role ownership for automation changes and app settings.
  • - Document current workflow state before applying major changes.

Step-by-step

  1. 1. Confirm callback URL and required scopes.
  2. 2. Reconnect HubSpot from workspace settings.
  3. 3. Reinstall app in portal if distribution/scope changed.

Verify success

  • - You can restore connection quickly without breaking app setup.
  • - The destination page/action opens without errors.
  • - You can repeat this workflow with the same result.

If something looks wrong

  • - If workflow actions do not appear, recheck app deployment and installed scopes.
  • - If member access looks wrong, review role assignments in workspace settings.

Contact support

Use the same support form as the app if you need help with setup, troubleshooting, or a specific workflow.

Create an account

Having trouble? Include your workspace name and a short description.

No card required on Scan. Read-only by default.