Settings

Use the Settings API to configure global settings for your project.

Page length

This defines the number of results per page when paginating results (max: 100).

Name	Type	Default	Max
page_length	integer	25	100

For more information on pagination including a list of which resources support pagination, see Pagination.

List child products

note

This information is for our Legacy Catalog and does not apply to EP PXM Catalog, Products nor Hierarchies.

This defines whether you want to display child products in product listings.

Name	Type	Default
list_child_products	boolean	true

Additional languages

note

Additional languages apply only to the legacy catalog and does not apply to EP PXM products, hierarchies, and catalogs. For more information on locale settings for the EP PXM services, see the EP PXM Products and EP PXM Hierarchies sections.

You can define additional language codes that are enabled for a project (max: 5).

Name	Type	Default	Max
additional_languages	array	[]	5

Calculation method

This option defines the method used to calculate cart and order totals. Currenlty there are two methods: {simple} and {line}.

The {simple} method is our previous method for calculating cart and order totals which focuses on the total value of the cart. This should only be used in the case where Commerce Cloud is not used for tax calculations. The {line} method treats each line item individually resulting in more accurate figures after taxes and promotions are applied.

Name	Type	Value
calculation_method	string	line
calculation_method	string	simple

important

For stores created since February 2020, {line} is the default calculation method. Stores created before February 2020 use {simple} as their calculation method.

note

Line-item discount promotions, such as item_percent_discount and item_fixed_discount, are only supported by the line calculation method. For more information, see Promotions.

Address Mandatory Fields

You can create an address to associate with an account in your storefront. This defines the address fields that you can use when creating an address in Commerce Manager. For more information, see Addresses.

Address fields can be required or optional. You can choose which optional address fields to use in your address, depending on your requirements. To change which fields are mandatory for creating an address, see Update Settings. Changing the mandatory fields will not impact addresses of customer made before the change

The following table describes the address fields, their type and whether they are required by default.

Name	Type	Required
type	string	Default
first_name	string	Default
last_name	string	Default
name	string	Optional
phone_number	string	Optional
instructions	string	Optional
company_name	string	Optional
line_1	string	Default
line_2	string	Optional
city	string	Optional
county	string	Default
region	string	Optional
postcode	string	Default
country	string	Default

For more information, see Addresses.

Readonly settings

For internal store configurations, read-only settings are used and updating these settings fails without returning any error. To change any predefined configuration, contact Elastic Path support team.

Name	Type	Default
currency_limit	integer	10
field_limit	integer	100
integration_limit	integer	100
event_limit	integer	5
filter_limit	integer	10
tax_item_limit	integer	5
promotions_limit	integer	1000
promotion_codes_limit	integer	1000
page_offset_limit	integer	10000