> ## Documentation Index
> Fetch the complete documentation index at: https://pricepirate.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Settings
> The central reference for all shop-wide settings: listing integration, price changes, synchronization, and API keys.
Settings are the central reference for all shop-wide configuration. You find the page under **Settings** in the app's sidebar. Every option is explained here in the order it appears on the page.
After any change, a save bar appears at the bottom. Your changes only take effect once you click **Save** there.
## Listing integration
### Own shop name
In the **Own shop name** field you enter the name of your shop as it appears on the marketplace. PricePirate uses this name to recognize your own offers when monitoring competitor pricing and to tell them apart from other offers.
When you change the shop name and save, PricePirate immediately re-evaluates your existing listing data so your own offer is recognized again. Competitor comparisons therefore reflect the new name right away.
### Markets
In shops with multiple markets, a **Markets** overview replaces the single "Own shop name" field. Here you manage all active markets in a table with the columns **Market**, **Own shop names**, and **Auto-connect**.
Multiple marketplaces are not included in every plan. If you only see the **Own shop name** field and no **Markets** overview, your shop runs in single-marketplace mode. Contact [support](/docs/en/guide/help/support) to enable multiple marketplaces. For an overview of the topic, see [Marketplaces](/docs/en/guide/catalog/marketplaces).
* **Own shop names**: You can store several own shop names per market. Separate them with `;;`, for example `My Shop;;My Shop DE`.
* **Auto-connect**: The per-market toggle controls whether automatic matching tries to connect products in this market.
Use **Edit** to open a dialog where you adjust own shop names and the auto-connect toggle per market, or add and remove markets.
**Add market**: In the dialog you first select the **Country** and then the **Marketplace**. Some marketplaces are only available with support-assisted setup — in that case, contact support to activate the integration.
**Market for price changes**: This selector determines which market is used for pricing strategies and pending price changes. This is the shop-wide default. Individual variants can deviate from it and pick their own market for price changes in the [Strategy settings](/docs/en/guide/pricing/settings) dialog.
A market with existing listing data cannot be removed. The current market for price changes cannot be deleted either — select a different market for price changes first.
For each configured market you then connect a separate listing — see [Connect listings](/docs/en/guide/catalog/connect-listings). Which products are monitored you manage in the [product settings](/docs/en/guide/catalog/product-settings). [Product metrics](/docs/en/guide/insights/metrics) and [reports](/docs/en/guide/reports/overview) show the figures separately per marketplace.
## Price changes
### Automatically accept pending price changes
When this toggle is enabled, the price changes generated by your [pricing strategies](/docs/en/guide/pricing/strategies) are applied to your Shopify products automatically, without you having to approve them individually.
Enabling this toggle immediately applies **all currently pending** price changes — not only future ones. Review the [list of pending price changes](/docs/en/guide/price-changes/review) first before you switch it on.
For more on applying changes automatically, see [Auto-apply](/docs/en/guide/price-changes/auto-apply).
## Dynamic discounts
In the **Dynamic discounts** section you enable, shop-wide, that price decreases run through a discount code and an offer link instead of a direct price change. Here you also set the advertised duration, an optional code prefix, and the combine and redemption options.
The toggle only unlocks the feature — it takes effect once you also enable dynamic discounts per product. For how it works and what each setting does, see [Dynamic discounts](/docs/en/guide/pricing/dynamic-discounts).
## Synchronization settings
### Daily synchronizations per listing
With **Daily synchronizations per listing** you set between 1 and 16 synchronizations per day (default: 1). This value is the default for new listings. Already-connected listings keep their existing value, because the count is fixed on the listing when it is connected — changing the default therefore has no retroactive effect.
Each daily synchronization uses 1 credit per marketplace per day while the listing is active. A listing with the value 3 therefore uses 3 daily credits. Learn more under [Credits](/docs/en/guide/concepts/credits).
### Advanced settings
The **Advanced settings** toggle reveals the following options.
**Timezone**: The timezone applies to the default and the custom daily synchronization window. The default is German time (`Europe/Berlin`). The most common timezones are available for selection. The timezone always applies shop-wide — individual listings can override their synchronization window, but not the timezone.
**Daily start time / end time**: These two fields define the window in which synchronizations are spread across the day (default: 05:00 to 23:00). A synchronization does not run at exactly the start or end time; it is scheduled evenly within the window. If the end time is before the start time, the window wraps past midnight.
**Boost range**: Enable the boost range to synchronize more densely during a specific period. Within the boost range, synchronizations are scheduled by the **boost factor** (2 to 10, default: 3) more densely, while the daily total stays the same. Start and end times are required when boost is enabled and must differ. A boost range outside the daily synchronization window has no effect.
**Example**: With 4 daily synchronizations, a window of 05:00 to 23:00, and a boost from 18:00 to 20:00 with factor 3, the two boost hours receive roughly three times the density of a normal hour. Synchronizations therefore cluster toward the evening, while still totaling 4 per day.
### Per-listing overrides
The shop settings are the default for all listings. Individual listings can deviate from them:
* You can override the number of daily synchronizations, the synchronization window, and the boost range per listing.
* A listing's own boost setting wins — even when it disables boost while the shop default has it enabled.
* The timezone is excluded from this and always applies shop-wide.
For how synchronizations run and how to override them per listing, see [Synchronization](/docs/en/guide/automation/syncs).
## API keys
API keys authenticate calls to the [Admin API](/docs/en/api/admin/overview). You find this section at the end of the settings.
**Create key**: Use **Create key** to create a new key. You can optionally assign a name; without one, "Default" is used.
The token has the format `pp_live_…` and is shown **exactly once** in the dialog. Copy it immediately and store it securely — it cannot be displayed again later. Only the prefix remains visible in the table.
The table shows the following columns per key:
| Column | Meaning |
| ------------- | ------------------------------------------ |
| **Name** | The name assigned when the key was created |
| **Value** | The visible prefix of the key |
| **Created** | When the key was created |
| **Last used** | The last use ("Never" until the first use) |
| **Status** | Active or Revoked |
**Revoke**: Use the trash icon to revoke a key after a confirmation. Revoked keys stop working immediately and can still be viewed via the history toggle.
**Usage**: Send the token as a bearer token in the `Authorization` header of your requests. Rotate keys regularly and revoke keys you no longer need.