Stats: drop date segments from Emails summary CSV filename

The Emails summary export returns the latest 30 emails with no date scoping, so a period date range in the filename was misleading. Add an includeDates option to getStatsCsvFileName and turn it off for the Emails summary download.

Author: Nikschavan

client/my-sites/stats/stats-download-csv/get-stats-csv-filename.js

@@ -5,15 +5,20 @@ import moment from 'moment';
  *
  * When a custom date range query is present (`start_date` + `date`), those dates
  * and the query period are used. Otherwise the legacy period object bounds are used.
- *
  * @param {Object} options
  * @param {string} options.siteSlug Site slug used as the filename prefix.
  * @param {string} options.path Stats module path segment (e.g. "posts").
  * @param {Object} options.period Period object with `period`, `startOf`, and `endOf`.
  * @param {Object} [options.query] Stats query; custom ranges include `start_date` and `date`.
+ * @param {boolean} [options.includeDates] Pass false for exports that are not date-scoped
+ * (e.g. the all-time Emails summary) to omit the period and date segments.
  * @returns {string} Filename ending in `.csv`.
  */
-export function getStatsCsvFileName( { siteSlug, path, period, query } ) {
+export function getStatsCsvFileName( { siteSlug, path, period, query, includeDates = true } ) {
+	if ( ! includeDates ) {
+		return [ siteSlug, path ].join( '-' ) + '.csv';
+	}
+
 	const hasCustomDateRange = Boolean( query?.start_date && query?.date );
 	const periodLabel = hasCustomDateRange && query.period ? query.period : period.period;
 

client/my-sites/stats/stats-download-csv/index.jsx

@@ -33,6 +33,7 @@ class StatsDownloadCsv extends Component {
 		hideIfNoData: PropTypes.bool,
 		headers: PropTypes.array,
 		rowModifierFn: PropTypes.func,
+		includeDates: PropTypes.bool,
 	};
 
 	processExportData = ( data ) => {
@@ -54,9 +55,9 @@ class StatsDownloadCsv extends Component {
 
 	downloadCsv = ( event ) => {
 		event.preventDefault();
-		const { siteSlug, path, period, query, data, headers } = this.props;
+		const { siteSlug, path, period, query, data, headers, includeDates } = this.props;
 
-		const fileName = getStatsCsvFileName( { siteSlug, path, period, query } );
+		const fileName = getStatsCsvFileName( { siteSlug, path, period, query, includeDates } );
 
 		this.props.recordGoogleEvent( 'Stats', 'CSV Download ' + titlecase( path ) );
 

client/my-sites/stats/stats-download-csv/test/get-stats-csv-filename.js

@@ -65,6 +65,19 @@ describe( 'getStatsCsvFileName', () => {
 		);
 	} );
 
+	it( 'omits the period and date segments when includeDates is false', () => {
+		const period = {
+			period: 'day',
+			startOf: moment( '2026-08-06' ),
+			endOf: moment( '2026-08-06' ),
+		};
+		const query = { quantity: 30 };
+
+		expect(
+			getStatsCsvFileName( { siteSlug, path: 'emails', period, query, includeDates: false } )
+		).toBe( 'mercantile.wordpress.org-emails.csv' );
+	} );
+
 	it( 'falls back to period bounds when query is omitted', () => {
 		const period = {
 			period: 'week',

client/my-sites/stats/stats-email-summary/index.jsx

@@ -79,6 +79,7 @@ const StatsEmailSummaryInner = ( { period, query, context, breadcrumbTrail } ) =
 			path="emails"
 			query={ query }
 			period={ period }
+			includeDates={ false }
 			headers={ [ 'title', 'opens_rate', 'unique_clicks', 'link' ] }
 			rowModifierFn={ ( row, data ) => {
 				if ( ! Array.isArray( row ) || row.length === 0 ) {