Troubleshooting

Most support issues come down to baseline scans, license state, freshness, or misunderstood inventory scope. Start with the section that matches the symptom you are seeing.

No indexed rows after install #

• Run a full scan at least once.
• Check the latest scan status in the Scans tab.
• Confirm current user has admin capabilities.
• Treat the product as not ready for reporting until a completed full baseline exists.

Scan controls are read-only #

• License may be missing, invalid, or expired.
• Refresh license state from the License tab.
• Reactivate the key if needed.
• Use wp dxm-block-audit scan --dry-run if you need a read-only validation path while licensing is being resolved.

License activation errors #

• Verify the key matches the purchase record.
• Use the billing portal to confirm the subscription is active.
• Retry after a short delay if network conditions were unstable.
• Refresh license state from the License tab after activation.

Unknown pattern, template-part, or navigation rows #

• Unknown rows are follow-up signals, not automatic product errors.
• Patterns cover reusable or synced entities and their references via core/block.
• Template Parts and Navigations track direct references and can group unresolved targets as Unknown.
• Rerun a full scan if content or referenced entities changed recently, then inspect the matching sources for the unresolved row.

Export seems incomplete #

• Inventory and source exports are capped to the first 5,000 filtered rows per export action by default.
• Narrow filters and export in smaller slices on larger sites.
• If you need larger caps, that is a developer setting rather than a standard admin workflow.

Stale or failed scan data #

• Use the latest completed full scan as the authoritative baseline.
• Rerun a full scan if the baseline is stale for your reporting window.
• If the last run failed or was cancelled, treat current inventory data as potentially incomplete until a new completed baseline is available.

Advanced validation with WP-CLI #

If you need a quick CLI check, use:

• wp dxm-block-audit scan --dry-run
• wp dxm-block-audit stats --format=json
• wp dxm-block-audit doctor --format=json

Use these commands to validate scope, stats, or index integrity without turning this docs set into a full CLI reference.

Need billing updates or cancellation #

Use the billing portal for card updates, invoices, and subscription cancellation.

Still blocked? #

Contact support and include: [email protected].

• WordPress version and PHP version
• Screenshot of license status card
• Last scan status and timestamp
• Which inventory view or export action you were using