Skip to main content

Options overview

All options live at AdminCP > Setup > Options > [MC] Search Analytics. They are grouped into the sections below.

SectionSettings
GeneralMaster switch, privacy posture, retention, excluded groups, branding.
ProcessingBuffer batching, rollup and prune chunking, clustering.
SurfacingTrending detection thresholds.
WidgetsPublic widget cache, frequency floor, and member participation policy.

General

SettingDefaultWhat it does
Enable capturingOnMaster switch. When off, no searches are captured and no rollup or pruning runs.
Capture these search typespost, threadOnly searches of the ticked types are recorded. All registered content types with a search handler appear here automatically; _global (unscoped) is always captured.
Minimum query length3Searches shorter than this are ignored.
Excluded user groups(empty)Searches by members of these groups are never captured.
Capture guest searchesOnWhen off, only logged-in members are recorded.
Attribute searches to usersOnWhen on, captured rows store the user id. Turn off for full anonymisation.
Hash guest IPsOnWhen on, guest searches store a SHA-256 IP hash. Off means no IP is stored at all.
Raw log retention30 daysHow many days of raw rows are kept before pruning.
Aggregate retention730 daysHow many days of pseudonymised aggregate rows are kept.
Remove brandingOffRemoves the "Powered by [MC] Search Analytics" footer text.

Processing

SettingDefaultWhat it does
Write buffer size50 entriesCaptured rows batched in memory before a single multi-row insert. Higher means fewer database round-trips; lower means less risk of losing buffered rows on a crash.
Write buffer max age30 secondsBuffered rows are also flushed when the oldest reaches this age.
Enable intent clusteringOnGroups near-duplicate queries during the daily rollup.
Clustering stopword languagesEnglishStopword lists applied during signature generation. Enable additional languages for multilingual boards.
Minimum cluster size2 queriesClusters with fewer distinct member queries are kept but flagged low confidence.
Rollup chunk size5000 rowsMaximum aggregate rows processed per pass of the Daily rollup cron entry.
Retention prune chunk size10000 rowsMaximum rows deleted per pass of the Retention prune cron entry.

Surfacing

SettingDefaultWhat it does
Enable trending detectionOnIdentifies queries gaining velocity by comparing each period against the average of the previous four periods.
Minimum searches for trending5 searchesQueries with fewer searches than this in the current period are excluded from trending.

Widgets

SettingDefaultWhat it does
Widget cache lifetime900 secondsHow long public widget payloads stay in the data registry before recomputation.
Widget frequency floor3 searchesQueries with fewer total searches than this are hidden from public widgets. Prevents single-user queries leaking into the public surface.
Allow members to opt out of public widgetsOnWhen on, a checkbox appears on each member's account privacy page letting them exclude their searches from public widget totals. Disable to force all member searches to contribute regardless of preference.
Members opt in by default (sub-option)OnOnly applies when the parent is on. When on, new and existing accounts contribute their searches unless the member unchecks the preference.