Fluent Commerce Logo
Docs

fc.graphql.compatibility.articlesByLocation.queryStrategy

Setting

Changed on:

18 Feb 2026

Setting AreaSystem
Supported context levels:ACCOUNT

Overview

This setting enables a performance enhancement for the `articlesByLocation` GraphQL query.When enabled, the system applies an optimized query strategy tailored to the most common search patterns. This improves execution efficiency and helps deliver faster response times.The feature is enabled if `fc.graphql.compatibility.articlesByLocation.queryStrategy` is missing or set to `dynamic`

Values

Data TypeValues
STRINGDefault Value:
  • `static`
Possible Values:
  • `static` - Feature disabled
  • `dynamic` - Feature enabled

Detailed technical description

Enabling this feature optimizes the `articlesByLocation` query, significantly improving performance. It enforces default and maximum time ranges on the article's `createdOn` field. The system applies two behaviors to the `articlesByLocation` GraphQL query:
  • Automatic date range resolution: If a query omits the `createdOn` `from` and/or `to` parameters, the system automatically calculates and applies them based on a configurable default period (default: 30 days).
  • Maximum range enforcement: If a query specifies a `createdOn` range that exceeds the configured maximum, the range is automatically truncated.

    For full technical details on how date ranges are calculated, see the setting documentation.
If the 30-day default doesn't suit your requirements, both the default and maximum period are configurable at the account level before you enable the feature.For more details see the individual documentation pages. 

Configuration example

1POST {{fluentApiHost}}/graphql
2
3mutation CreateSetting {
4   createSetting(input: {
5		name: "fc.graphql.compatibility.articlesByLocation.queryStrategy", 
6		valueType: "STRING", 
7		value: "dynamic", 
8		context: "ACCOUNT", 
9		contextId: 0}) {
10    id
11    name
12  }
13}

Update example

1POST {{fluentApiHost}}/graphql
2
3mutation updateSetting {
4  updateSetting(input: {
5		id: 5001464,
6		name: "fc.graphql.compatibility.articlesByLocation.queryStrategy", 
7		valueType: "STRING", 
8		value:"dynamic", 
9		context: "ACCOUNT", 
10		contextId: 0}) {
11    id
12    name
13  }
14}