Advanced Customer Reports

How can we help?

Search the documentation or ask the AI agent anything about the plugin.

Filter reference

Updated September 15, 2026

The plugin exposes a number of filters for tuning how reports are built and how much data they cover. All of them are prefixed acreports_ and can be added from a theme’s functions.php or a small plugin.

Report size and performance

  • acreports_max_report_orders – the maximum number of orders one report or export will read. Default 10000. Set to 0 to remove the cap.
  • acreports_report_batch_size – how many orders are loaded per batch when reading orders directly. Default 100. Larger batches mean fewer queries but more memory.
  • acreports_report_id_chunk_size – how many order IDs are bound into one lookup query. Default 2000.
  • acreports_report_max_unsynced_orders – how many orders missing from the Analytics tables will be read individually before the report abandons the lookup tables entirely. Default 500.

Report content limits

  • acreports_attribution_row_limit – rows shown in the origin and campaign breakdowns. Default 25.
  • acreports_product_affinity_limit – rows shown in the product affinity table. Default 20.

Store benchmarks

  • acreports_store_benchmarks_cache_ttl – how long whole-store aggregates are cached, in seconds. Default HOUR_IN_SECONDS. Set to 0 to disable caching.
  • acreports_benchmark_rank_cache_size – how many spend rankings are held in one cache entry. Default 200.

Customers and carts

  • acreports_merge_guest_orders – whether guest orders are matched to registered customers by email. Receives the value of the Merge Guest Orders setting.
  • acreports_max_cart_session_rows – the size the WooCommerce sessions table can reach before guest cart lookups are skipped. Default 50000.
  • acreports_cart_idle_hours – hours before a cart is considered idle rather than active. Default 1.
  • acreports_cart_abandoned_hours – hours before a cart is considered abandoned. Default 24.

Examples

Raise the report cap and widen the attribution tables:

add_filter( 'acreports_max_report_orders', function() {
    return 50000;
} );

add_filter( 'acreports_attribution_row_limit', function() {
    return 100;
} );

Treat a cart as abandoned after four hours rather than 24:

add_filter( 'acreports_cart_abandoned_hours', function() {
    return 4;
} );

Disable guest order merging in code, overriding the setting:

add_filter( 'acreports_merge_guest_orders', '__return_false' );

Related

Was this article helpful?