# System Preferences You can use **Management Dashboard** -> **Settings** -> **System Preferences** for setting up rules and configuring your tenant.

### AI

Setting	Description	Possible values	Default value
`openAiApiToken`	To start using AI when working with Emporix, you have to use an OpenAI token to establish the connection between the two systems. To configure the connection you either need an active account on OpenAI Platform, or you can use a token provided directly by Emporix. If you have your own OpenAI account, add the API token (API Key) from it as an Open AI API token. When the token is configured, you can start using AI. If you don't provide your own OpenAI token, the Emporix one is used with the following limits: 3 mln input tokens and 1 mln output tokens. If you reach the limit, you have to provide your own OpenAI token to use the feature again. Emporix uses the gpt-4o-mini model by default. If you want to use your own OpenAI account with a different AI model please contact us at support@emporix.com to negotiate the model and usage. To check the available AI models, see the OpenAI - Models documentation.

### Coupons

Setting	Description	Possible values	Default value
`maxNumberOfCouponsPerCart`	Set a rule for the number of coupons that can be used per cart. You can configure the maximum number of coupons with the value field. If the field is empty, the default value is 1 which means only 1 coupon can be added to the cart.	any number	1
`couponPermanentDelete`	Set your preferences for deleting coupons. If you don't set the property or set it to false, the delete operation only flags a coupon as deleted. You can't create or import a coupon with the same ID (code). If you want the behavior to remove a coupon permanently from the database, set the property to true. It is then possible to create or import a coupon with the same ID (code).	true/false	false
`enableCouponCodeCaseSensitivity`	Decide if your coupon codes should be saved both in lower and upper case or not. If you set the preference to `true`, the coupons can be saved in both formats. By default, the coupon code is saved in upper case only.	true/false	false

### Approvals

Setting	Description	Possible values	Default value
`approval.default_expiryDays`	Set the expiry date for an approval. If the property is empty, the default value is used.	any number	10
`signUp.enableAccountCreationEmailConfirmation`	Enable email notifications about new accounts as by default, the newly created customers do not receive any welcome emails after their accounts are created. To enable the welcome emails, set the value to true.	true/false	false
`customer.passwordreset.redirecturl`	Register the URL of the page for resetting the password of the customer.

### Cart

Setting	Description	Possible values	Default value
`cartItemValidationSkipEffectiveAmount`	With default setup, during adding an item to cart, it is mandatory to provide values to the following price fields: priceID effectiveAmount originalAmount currency You can set the effectiveAmount as optional, if you don't need it during this operation in your use case. If you set the value to true, a value of effectiveAmount property is not required to add an item to a cart. For more information about adding items to cart, see API Reference.	true/false	false
`cartItemValidationSkipOriginalAmount`	With default setup, during adding an item to cart, it is mandatory to provide values to the following price fields: priceID effectiveAmount originalAmount currency You can set the originalAmount as optional, if you don't need it during this operation in your use case. If you set the value to true, a value of originalAmount property is not required to add an item to a cart. For more information about adding items to cart, see API Reference.	true/false	false
`cartItemValidationSkipCurrency`	With default setup, during adding an item to cart, it is mandatory to provide values to the following price fields: priceID effectiveAmount originalAmount currency You can set the currency as optional, if you don't need it during this operation in your use case. If you set the value to true, a value of currency property is not required to add an item to a cart. For more information about adding items to cart, see API Reference.	true/false	false
`cartItemValidationSkipExistingItemsValidationOnAddToCart`	Enable skipping validation for items that already exist in the cart when a new item is added. This setting improves performance for carts with multiple items. For more information about adding items to cart, see API Reference.	true/false	false
`enableExternalPrices`	Enable the external sourcing of prices or products at a cart level. By setting the setting to true, you can use a dedicated application for complex price calculation or product management to communicate with the Cart Service and overwrite the pricing information for a specific cart. For more information about external pricing and products, see the External Pricing and Products documentation.	true/false	false
`populateProductDetailsOnAddToCart`	Decide if products details should be automatically populated upon adding to cart operations. When set to true, the system displays the details.	true/false	false
`enableLegalEntityAddressFallbackInCart`	Enable fallback to legal entity address in cart when no address is provided in the request.	true/false	false
`allowAnonymousCheckoutWithExistingCustomerEmail`	Allow anonymous checkout when the customer provides an email that already exists in the system. When set to true, checkout can proceed with an existing customer email without requiring the user to log in.	true/false	false

### Products

Setting	Description	Possible values	Default value
`enableProductCategoryAssignmentValidation`	Validate that a product exists before it can be assigned to a category. When enabled, the system checks product existence during category assignment.	true/false	false
`allowToSkipRelatedProductsValidation`	Allow skipping validation of related products. When set to true, related products validation can be bypassed where applicable.	true/false	false

### Index

Setting Description Possible values Default value

Setting	Description	Possible values	Default value
`indexing_siteAwareFieldsStrategy`	Choose the appropriate indexing strategy to index site-aware properties, such as price and availability. Specifically, if you have multiple sites in the system, you can choose if you want to have a single index or create individual indices separately for each site. MERGE strategy creates a single index with site-aware properties mapped as sitePrices and siteAvailabilities. The properties are maps where a key is a site code and a value is a price or availability object respectively. SPLIT strategy creates separate indices for each site. This approach provides more flexibility but also may impact performance when the number of indices is high.	MERGE/ SPLIT	MERGE

indexing_siteAwareFieldsStrategy

Choose the appropriate indexing strategy to index site-aware properties, such as price and availability.

Specifically, if you have multiple sites in the system, you can choose if you want to have a single index or create individual indices separately for each site.

MERGE strategy creates a single index with site-aware properties mapped as sitePrices and siteAvailabilities. The properties are maps where a key is a site code and a value is a price or availability object respectively.

SPLIT strategy creates separate indices for each site. This approach provides more flexibility but also may impact performance when the number of indices is high.

MERGE/

SPLIT

MERGE

### Order

Setting	Description	Possible values	Default value
`enableOrderAddressPropagation`	Decide whether the address provided by a customer upon submitting an order is automatically added and saved as the customer address.	true/false	true

### Customer

Setting Description Possible values Default value

customerOnHoldOnCreation Decide if newly created customers are by default initially set as on hold. This gives you an opportunity to first complete all the configuration and access rights for a new customer before manually activating their account. true/false false

customerActiveOnCreation Decide if newly created customers are by default already set to active. When you create a new customer, you can change the setting manually according to the current needs. true/false true

Setting	Description	Possible values	Default value
`customerOnHoldOnCreation`	Decide if newly created customers are by default initially set as on hold. This gives you an opportunity to first complete all the configuration and access rights for a new customer before manually activating their account.	true/false	false
`customerActiveOnCreation`	Decide if newly created customers are by default already set to active. When you create a new customer, you can change the setting manually according to the current needs.	true/false	true
`companyContactPropagation`	Define how company contact assignments are propagated within a company hierarchy: DOWNWARD (from parent to subsidiaries), UPWARD (from subsidiaries to parent), or DISABLED (no propagation). Propagation happens only at the moment of assignment - creating the contact in the selected company also creates corresponding contacts in related companies according to the chosen direction.	DOWNWARD UPWARD DISABLED	UPWARD

companyContactPropagation

Define how company contact assignments are propagated within a company hierarchy: DOWNWARD (from parent to subsidiaries), UPWARD (from subsidiaries to parent), or DISABLED (no propagation). Propagation happens only at the moment of assignment - creating the contact in the selected company also creates corresponding contacts in related companies according to the chosen direction.

DOWNWARD

UPWARD

DISABLED

UPWARD

### Access Permissions/Restrictions

Setting	Description	Possible values	Default value
`enableSyncBetweenRestrictionsAndSiteCodes`	Decide if the restrictions applied on entities are identical to the sites you defined in your tenant. If this setting is set to true, the restrictions list contains the same values as the available `siteCodes`.	true/false	true
`restrictions`	A list of applied restrictions/permissions on the site-aware entities in your tenant. When the `enableSyncBetweenRestrictionsAndSiteCodes` is set to true, the list is identical with the available sites. To define custom restrictions and use them later to managing access control, disable the synchronization first.	text	empty []

### SSO Token Exchange Authentication

Setting	Description	Possible values	Default value
`ssoCustomerAutoprovisioningDisabled`	Customer autoprovisioning takes care of automatic creation of a customer account during the SSO token exchange authentication - if a new customer tries to log in but their account does not currently exist in the Emporix system. You can change this setting to `true` to disable autoprovisioning, if you pre-synchronize your customer databases and expect all user data to already be in the system before a first-time login. When the autoprovisioning is turned off and an unknown customer attempts to log in, the customer account is not created and the system returns a `404` error.	true/false	false
`ssoCustomerIdentifierField`	Specify if a customer is identified by either `EMAIL` or `SUBJECT` during the token exchange. Email is the standard identifier, but for the cases when a different identifier is associated with a customer account (such as user name, ID or other), the introspection endpoint returns the `sub` parameter for identifying the `subject` field.	EMAIL/SUBJECT	EMAIL