Skip to content
Saleor
Esc
↑↓navigate↵open⌘Jpreview

Schema: Saleor 3.23.43Download SDLUpgrade guides

On this page

ShopSettingsInput Input Type

input ShopSettingsInput {
  name: String
  headerText: String
  description: String
  trackInventoryByDefault: Boolean
  defaultWeightUnit: WeightUnitsEnum
  fulfillmentAutoApprove: Boolean
  fulfillmentAllowUnpaid: Boolean
  defaultMailSenderName: String
  defaultMailSenderAddress: String
  customerSetPasswordUrl: String
  reserveStockDurationAnonymousUser: Int
  reserveStockDurationAuthenticatedUser: Int
  limitQuantityPerCheckout: Int
  enableAccountConfirmationByEmail: Boolean
  allowLoginWithoutConfirmation: Boolean
  allowStorefrontTraffic: Boolean
  metadata: [MetadataInput!]
  privateMetadata: [MetadataInput!]
  preserveAllAddressFields: Boolean
  passwordLoginMode: PasswordLoginModeEnum
  useLegacyShippingZoneStockAvailability: Boolean
  includeTaxesInPrices: Boolean @deprecated(reason: "Use `taxConfigurationUpdate` mutation to configure this setting per channel or country.")
  displayGrossPrices: Boolean @deprecated(reason: "Use `taxConfigurationUpdate` mutation to configure this setting per channel or country.")
  chargeTaxesOnShipping: Boolean @deprecated(reason: "To enable taxes for a shipping method, assign a tax class to the shipping method with `shippingPriceCreate` or `shippingPriceUpdate` mutations.")
  useLegacyUpdateWebhookEmission: Boolean @deprecated
  accountConfirmMergeMode: AccountConfirmModeEnum
}

Fields

name

name · String

Shop’s name.

Added in Saleor 3.23

headerText

headerText · String

Header text.

description

description · String

SEO description.

trackInventoryByDefault

trackInventoryByDefault · Boolean

This field is used as a default value for ProductVariant.trackInventory.

defaultWeightUnit

defaultWeightUnit · WeightUnitsEnum

Default weight unit.

fulfillmentAutoApprove

fulfillmentAutoApprove · Boolean

Enable automatic approval of all new fulfillments.

fulfillmentAllowUnpaid

fulfillmentAllowUnpaid · Boolean

Enable ability to approve fulfillments which are unpaid.

defaultMailSenderName

defaultMailSenderName · String

Default email sender’s name.

defaultMailSenderAddress

defaultMailSenderAddress · String

Default email sender’s address.

customerSetPasswordUrl

customerSetPasswordUrl · String

URL of a view where customers can set their password.

reserveStockDurationAnonymousUser

reserveStockDurationAnonymousUser · Int

Default number of minutes stock will be reserved for anonymous checkout. Enter 0 or null to disable.

reserveStockDurationAuthenticatedUser

reserveStockDurationAuthenticatedUser · Int

Default number of minutes stock will be reserved for authenticated checkout. Enter 0 or null to disable.

limitQuantityPerCheckout

limitQuantityPerCheckout · Int

Default number of maximum line quantity in single checkout. Minimum possible value is 1, default value is 50.

enableAccountConfirmationByEmail

enableAccountConfirmationByEmail · Boolean

Enable automatic account confirmation by email.

allowLoginWithoutConfirmation

allowLoginWithoutConfirmation · Boolean

Enable possibility to login without account confirmation.

allowStorefrontTraffic

allowStorefrontTraffic · Boolean

Determines whether the GraphQL API accepts storefront requests (anonymous requests and authenticated non-staff customers). When disabled, only apps and staff users may call the API directly; all other requests are rejected with an HTTP 401 and the STOREFRONT_TRAFFIC_NOT_ALLOWED error code.

Added in Saleor 3.23

metadata

metadata · [MetadataInput!]

Shop public metadata. Can be read by any API client authorized to read the object it’s attached to.

Warning: never store sensitive information, including financial data such as credit card details.

privateMetadata

privateMetadata · [MetadataInput!]

Shop private metadata. Requires permissions to modify and to read the metadata of the object it’s attached to.

Warning: never store sensitive information, including financial data such as credit card details.

preserveAllAddressFields

preserveAllAddressFields · Boolean

When enabled, address fields that are not valid for a given country (according to Google’s i18n address data) will be preserved instead of being removed during validation. Validation errors are still returned.

passwordLoginMode

passwordLoginMode · PasswordLoginModeEnum

Controls whether password-based authentication is allowed.

Added in Saleor 3.23

useLegacyShippingZoneStockAvailability

useLegacyShippingZoneStockAvailability · Boolean

When enabled, stock availability is filtered by shipping zones and the destination address (legacy behavior). When disabled, stock availability is determined only by the direct warehouse-channel link, ignoring shipping zones.

Added in Saleor 3.23

includeTaxesInPrices

includeTaxesInPrices · Boolean

Include taxes in prices.

displayGrossPrices

displayGrossPrices · Boolean

Display prices with tax in store.

chargeTaxesOnShipping

chargeTaxesOnShipping · Boolean

Charge taxes on shipping.

useLegacyUpdateWebhookEmission

useLegacyUpdateWebhookEmission · Boolean

Use legacy update webhook emission. When enabled, update webhooks (e.g. customerUpdated,productVariantUpdated) are sent even when only metadata changes. When disabled, update webhooks are not sent for metadata-only changes; only metadata-specific webhooks (e.g., customerMetadataUpdated, productVariantMetadataUpdated) are sent.

accountConfirmMergeMode

accountConfirmMergeMode · AccountConfirmModeEnum

Controls the method used for merging existing orders and giftcards when password-based authentication is used. Learn more at https://docs.saleor.io/upgrade-guides/core/migrate-account-merging

Used by


Schema: Saleor 3.23.43. Download SDL.

Last updated on August 10, 2026

Was this page helpful?