> For the complete documentation index, see [llms.txt](https://docs.sellermagnet.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sellermagnet.com/account-and-settings/settings.md).
# General Settings
{% hint style="info" %}
**Difficulty:** 🟢 Beginner · **Reading time:** \~10 min
{% endhint %}
{% hint style="success" icon="rocket" %}
**Open this page in your dashboard:** [**Go to General Settings →**](https://dashboard.sellermagnet.com/settings)
{% endhint %}
## Accessing the Settings Panel
To open the Settings panel:
1. Click the **gear icon** (Settings) in the bottom section of the left sidebar.
2. The Settings modal opens with a sidebar navigation on the left and the content area on the right.
The Settings panel contains these sections:
| Section | Icon | Purpose |
| ------------------ | ------------ | ------------------------------------------------------------------------------------------ |
| **General** | Sliders | View current plan usage, manage currency and display preferences, record tax registrations |
| **Shipping** | Truck | Configure shipping methods and cost tiers for profit calculations |
| **Connections** | Amazon logo | Add, edit, or remove Amazon Seller Central connections |
| **Integrations** | Puzzle piece | One-click launchpad to every tool and automation linked to your account |
| **Notifications** | Bell | Configure email and in-app notification preferences |
| **Manage Payment** | Credit card | Opens Stripe billing portal for payment management |
| **My Account** | User | Change password, enable 2FA, delete account |
***
## General Settings
The General section displays your **current usage** across SellerMagnet's metered features. This gives you a clear view of how much of your plan limits you are using.
### Current Usage Dashboard
The usage dashboard shows real-time consumption for three key areas:
| Metric | What It Tracks |
| ----------------------- | ---------------------------------------------------------------------------------------- |
| **Repricer** | Number of created repricers (active/inactive) vs. your plan limit. Decreases on deletion |
| **Analytics Dashboard** | Number of tracked orders in the current billing cycle |
| **Review Requester** | Number of review requests sent vs. your monthly allowance |
Each metric displays:
* A **progress bar** showing percentage used
* The **current count** and **maximum limit** (e.g., "47 / 100")
* Color-coded indicators: blue for normal usage, amber when approaching the limit, red when at capacity
> **Pro Tip:** Monitor your usage weekly. If you consistently hit 80%+ of any limit, it may be time to upgrade your plan. You can do this directly from **Manage Plan** in the sidebar.
### Currency & Display Settings
Below the usage dashboard, you can configure:
* **Display Currency:** The currency used throughout the dashboard for all financial figures. This does not affect data collection; it only changes how values are displayed.
* **VAT Collection Method:** How VAT is handled in your profit calculations.
* **Firm VAT Rate:** If you collect VAT separately, enter your rate here.
{% hint style="warning" %}
**Changing your display currency does not retroactively convert historical data.** Exchange rates are applied at the time of the original transaction. Currency changes take effect immediately for new data displays.
{% endhint %}
### Profit & Cost Settings
These options control how general overhead, shipping, and refund costs flow into your **per-order Net Profit**. They live in **Settings > General**, below the currency and display options.
#### General costs per order (overhead allocation)
"General costs" are your account-wide overhead that is not tied to a single order - your Amazon subscription, Amazon Ads spend, software, accountant fees, and any other expenses you record in **Reports → P\&L**. This setting decides **how that monthly overhead is spread across your orders** when SellerMagnet shows per-order Net Profit. Choose one of three modes:
| Mode | What it does | Best for |
| ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| **Off** | General expenses are **excluded** from per-order profit. They still appear in **Reports → P\&L**. Per-order Net Profit shows direct margin only (revenue − Amazon fees − COGS − refunds). | Sellers who review overhead separately in Reports and want a clean direct margin per order. |
| **By revenue share** *(recommended)* | Each order absorbs a slice of the month's overhead **in proportion to its revenue** - bigger orders carry more. `allocated = monthly overhead × (order revenue ÷ total revenue that month)`. This is the default for \~95% of sellers. | Most sellers - it reflects that high-value orders consume more of your fixed costs. |
| **Flat per order (€/order)** | The **same overhead amount is deducted from every order**, regardless of its size. `allocated = monthly overhead ÷ number of orders that month`. | Fixed-cost-per-shipment overhead (e.g. a flat pick-pack or handling cost that is identical for every parcel). |
{% hint style="info" %}
The allocation is always computed against the **calendar month** the order falls in, so figures settle as the month's overhead ledger and order count fill in. Changing the mode re-spreads overhead immediately across your per-order Net Profit; it never changes the totals in **Reports → P\&L**.
{% endhint %}
#### Include shipping in sales volume
Controls only how customer-paid shipping is **displayed** in the Gross / Net / VAT sales-volume tile and chart:
* **ON:** customer-paid shipping is rolled into the Gross / Net / VAT sales-volume figure.
* **OFF:** the tile shows items-only, and shipping is listed as its own line in the breakdown.
{% hint style="warning" %}
Either way, **shipping revenue is always included in Net Profit** and in per-order row totals - this toggle only affects the sales-volume *display*, never your profit.
{% endhint %}
#### Include COGS in refund Net Impact
* **ON:** the cost of damaged / written-off returned units is subtracted from each refund's **Net Impact** on the Refunds page.
* **OFF:** Net Impact reflects only Amazon fee adjustments and shipping/label losses, and the COGS lines are hidden - useful if you track inventory cost separately.
#### Default returns sellable
Sets the default for whether **returned units are added back to sellable stock**. You can still override this per product in the Batches modal ("Add returns back").
* **Default Language:** The language used throughout the dashboard interface (also configurable here).
### Tax Registrations
At the bottom of **Settings > General** is the **Tax Registrations** card. This is where you record your per-country **VAT registration numbers** so SellerMagnet can apply the correct tax treatment to each marketplace's figures.
Click **+ Add** (top-right of the card) to register a number. Each entry is stored in a table with the following columns:
| Column | What It Holds |
| -------------- | ---------------------------------------------------- |
| **Connection** | The Amazon connection this registration attaches to |
| **Country** | The country the VAT number is registered in |
| **VAT Number** | Your VAT registration number for that country |
| **Rate Type** | The tax-rate treatment applied for that registration |
| **Status** | Whether the registration is active |
| **Primary** | Marks one registration as the **primary** one |
| **Source** | How the entry was added (manual vs. imported) |
| **Effective** | The effective date(s) the registration applies from |
| **Actions** | Edit or delete the registration |
{% hint style="warning" %}
If you sell in countries where you are VAT-registered but have **no registration recorded here**, SellerMagnet shows a reminder banner on the card. Add your numbers so VAT is handled correctly in your profit and fee calculations.
{% endhint %}
{% hint style="info" %}
Designate exactly **one** registration as **Primary**. Effective dates let SellerMagnet apply the right registration to historical orders, so figures stay correct even after your registration details change.
{% endhint %}
### Theme (Light / Dark Mode)
SellerMagnet ships with both a **light** and a **dark** theme. Light is the default; dark is opt-in.
There are **two places** to switch the theme, and they stay in sync:
| Control | Where |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Topbar toggle** | A sun/moon button in the dashboard top bar - click it to flip between light and dark instantly. The icon shows the action it performs (moon = switch to dark, sun = switch to light). |
| **Settings > General > Appearance** | A segmented **Light / Dark** control inside the Settings panel. |
How it behaves:
* **Persists per browser.** Your choice is remembered in the browser (via `localStorage`), so it sticks across page loads and sessions on that device. It is a per-browser preference, not a server-side account setting - set it again on each device/browser you use.
* **Applies everywhere.** The theme covers the whole dashboard - pages, the sidebar and top bar, modals, and charts (chart axes, gridlines, legends, and tooltips re-theme live when you toggle).
* **No flash on load.** The theme is applied before the page paints, so you won't see a flash of the wrong theme.
{% hint style="success" icon="rocket" %}
**Pro Tip:** Working late or on an OLED screen? Dark mode is easier on the eyes. Toggle it from the top bar without opening Settings.
{% endhint %}
***
## Shipping Settings
Shipping costs directly impact your profit calculations. The Shipping section lets you define routes with tiered pricing so SellerMagnet can accurately compute margins per order.
### Adding a Shipping Method
1. Click **+ New Shipping Method** in the shipping settings header.
2. Fill in the method details:
| Field | Description | Example |
| ------------------ | ------------------------------------------------- | ------------------------------------------------ |
| **Name** | A descriptive label for the shipping method | "DE GLS Standard" |
| **Country** | The marketplace/country this method applies to | Germany |
| **Cost Type** | Flat rate or tiered by quantity | Tiered |
| **Flat Cost** | If flat: fixed cost per shipment | EUR 4.99 |
| **Quantity Tiers** | If tiered: cost brackets based on number of units | 1 unit = EUR 5.00, 2-3 = EUR 7.00, 4+ = EUR 9.50 |
3. Click **Save** to create the method.
### Managing Existing Methods
All methods appear in a table with the following columns:
* **Checkbox:** Select methods for bulk actions
* **Name:** Method identifier
* **Country:** Marketplace/country covered
* **Cost Type:** Flat or tiered configuration
* **Actions:** Edit or delete the method
> **Pro Tip:** Create separate methods for each marketplace/country. This gives you more accurate per-order profit calculations, especially when shipping costs vary significantly between markets.
### Multi-Unit Rules
Set specific costs when customers order multiple units:
*Flat + extra per additional unit:*
* Base (1 unit): EUR 5.00
* Extra: +EUR 1.50 per additional unit (2 units = EUR 6.50, 3 units = EUR 8.00)
*Tiered by quantity:*
* 1 unit: EUR 5.00
* 2-3 units: EUR 7.00
* 4-5 units: EUR 9.50
* 6+ units: EUR 12.00
{% hint style="success" icon="rocket" %}
**Pro Tip:** Align tiers with your courier's weight/volume thresholds (e.g., 0-2 kg, 2-5 kg, 5-10 kg).
{% endhint %}
### How Multiple Products Combine (Calculation Strategy)
When a single order contains **several different products** that each have their own shipping method, SellerMagnet needs a rule for how to combine those costs into one shipping figure for the order. Set this once in **Settings > Shipping → Shipping cost calculation**; the chosen strategy shows as a badge (e.g. `HIGHEST`).
| Strategy | How the order's shipping cost is calculated | Best for |
| --------------------------------------- | --------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
| **Highest** | Uses only the **single most expensive** product's shipping cost for the whole order. | Sellers who ship a mixed order in one parcel - you pay one shipping cost, driven by the bulkiest item. |
| **Sum all** | **Adds up** every product's shipping cost in the order. | Sellers who genuinely ship each item separately, so every item's shipping is a real cost. |
| **Sum with cap** *(recommended)* | Adds up each product's shipping but **never charges more than a maximum cap** you set (e.g. €15.00). | Most sellers - it scales with multi-item orders but protects against unrealistic totals on large baskets. |
| **Primary + additional** *(enterprise)* | Charges the **primary item's full shipping** plus a configurable **percentage** for each additional item. | High-volume sellers modelling a "first item full price, extra items discounted" courier contract. |
{% hint style="info" %}
The **Sum with cap** strategy asks for a **maximum cap** value, and **Primary + additional** asks for the **additional-item percentage**. Both are entered right under the strategy selector. If an order has only one item, all four strategies produce the same result.
{% endhint %}
### Assigning Shipping Methods to Products
After creating routes, you can assign them to products in two ways:
1. **Per product:** Edit a product and select a shipping method from the dropdown.
2. **Bulk assignment:** Select multiple products in the Products page and assign a route via the bulk action menu.
{% hint style="warning" %}
**Products without an assigned shipping method will use zero shipping cost in profit calculations.** This will inflate your apparent margins. Always assign routes to your top-selling products first.
{% endhint %}
***
## Connection Settings (Amazon)
The Connections section manages your Amazon Seller Central integrations.
### Viewing Existing Connections
Each connection card shows:
| Field | Details |
| ----------------------- | ---------------------------------------------------------------------------- |
| **Connection Name** | The label you assigned (e.g., "EU Store") |
| **Status** | Active or Revoked |
| **Primary Marketplace** | The default marketplace for this connection |
| **Import Start Date** | When historical data import begins |
| **VAT on Amazon Fees** | Whether VAT is applied to Amazon's fee charges |
| **Last Sync** | Timestamp of the most recent data sync |
| **Historical Data** | Request historical data import for predefined time frames (quarterly ranges) |
### Adding a New Connection
1. Click **+ Add Connection** in the connections header.
2. Enter a **Connection Name**.
3. Set the **Import Start Date**.
4. Select your **Primary Marketplace**.
5. Configure **VAT on Amazon Fees** if applicable.
6. Click **Connect to Amazon**: you will be redirected to Amazon Seller Central.
7. Authorize SellerMagnet on the Amazon page.
8. You will be redirected back to SellerMagnet once authorization is complete.
{% hint style="danger" %}
**Never share your Amazon SP-API (Selling Partner API) credentials with anyone.** SellerMagnet handles the entire authorization flow securely via Amazon OAuth. If anyone asks you to paste API keys manually, it is not a legitimate SellerMagnet request.
{% endhint %}
### Editing a Connection
Click the **Edit** button on any connection card to:
* Change the connection name
* Update the import start date (this triggers a re-sync for the new date range)
* Modify VAT settings
* Change the primary marketplace
### Revoking a Connection
1. Click the **Revoke** button on the connection card.
2. Confirm the action in the confirmation dialog.
{% hint style="danger" %}
**Revoking a connection disconnects your Amazon account** including historical orders, product data, and analytics. This action cannot be undone. Export any reports you need before removing a connection.
{% endhint %}
### Requesting Historical Data
When you first connect, SellerMagnet imports data forward from your **Import Start Date**. To pull in **older** orders after the fact, request them here, one quarter at a time.
1. In the Connections table, click the **info icon** in the **Historical Data** column for that connection.
2. A list of **time frames** appears. Amazon returns history in **3-month (quarterly) blocks**, stepping backwards from today.
3. Click **Request** on a single quarter, or **Request all** to queue every available block at once.
4. Each requested block switches to **Pending** (amber) while SellerMagnet downloads and processes it in the background. A block that is already Pending or completed cannot be requested again.
{% hint style="warning" %}
**Amazon limits historical data to roughly the last 23 months.** Quarters older than that are not offered - the earliest block is automatically clipped to the cutoff - so there is no way to pull data from before that window. Set your Import Start Date with this in mind.
{% endhint %}
{% hint style="info" %}
Requests process in the background and may take from a few minutes to longer, depending on the order volume in each period. If a request cannot be queued (for example, your plan's historical-request allowance has been reached), a prompt explains why instead of starting the import. Newly imported orders appear on the **Orders** and analytics pages once processing finishes.
{% endhint %}
### Switching Between Connections
You can switch between connections at any time using the **connection selector** at the bottom of the sidebar. It has two modes:
| Mode | What You See |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **All** *(default)* | Data **aggregated across every connection** in the current project - KPIs, orders, and reports combine all stores into one view. This is the selector's default selection. |
| **\[Connection Name]** | Data scoped to that **single connection** only - everything on the dashboard re-loads filtered to that store. |
Selecting a different connection reloads the dashboard so every page reflects the new scope. You can also click **Manage Connections** in the connection selector dropdown to jump directly to Connection Settings.
{% hint style="info" %}
**All** is connection-level aggregation **within a project**. To work in a completely separate workspace (its own connections, data, and settings), switch **projects** instead - see [Multi-Project Workspaces](#multi-project-workspaces) below.
{% endhint %}
***
## Integrations
The **Integrations** tab is a one-click **launchpad** to every tool and automation linked to your account. Instead of hunting through the sidebar, you can jump straight to a feature - or its in-feature settings - from one categorized grid. Each card opens the target page (or a specific settings anchor) in the dashboard.
The cards are grouped into sections:
| Section | Example destinations |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------ |
| **Selling tools** | Repricer, Product Sourcer & Saved ASINs, Listing Optimizer, Inventory Planner, Expenses & COG Batches |
| **PPC & AI** | PPC Manager, AI Optimizer & Autopilot, Bid Rules, Brand Defense, Approval Center, **Slack & Teams Webhooks** |
| **Returns, refunds & reviews** | Lost & Found - Reimbursements, Auto Review Requests, Live Return Tracking |
| **Reporting & alerts** | Alerts Center, OTDR & Late-Shipment Alerts |
### Slack & Microsoft Teams Webhooks (PPC alerts)
The **Slack & Teams Webhooks** card under **PPC & AI** is the key third-party integration here. It deep-links to **PPC Manager > Settings > Alerts**, where you connect outgoing **incoming-webhook URLs** so SellerMagnet can push PPC notifications into your team chat.
| Channel | What you provide | What gets sent |
| ------------------- | --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| **Slack** | A Slack incoming-webhook URL (`https://hooks.slack.com/services/...`) | Autopilot apply, dayparting apply, and weekly-digest events - the same content as the ops feed |
| **Microsoft Teams** | An Office 365 / Workflow incoming-webhook URL | The same alerts, using the Teams MessageCard schema (works with classic Connectors and the newer Workflow webhooks) |
Each channel has a **Send test message** button so you can confirm the webhook is wired correctly before relying on it.
{% hint style="info" %}
Webhook channels are configured **per project** and only fire for **PPC** notifications. Leave a field blank to disable that channel. Email and in-app notifications for everything else are still managed under **Settings > Notifications**.
{% endhint %}
***
## Multi-Project Workspaces
A **project** is a fully separate workspace - its own Amazon connections, data, settings, and billing. Sellers running multiple businesses (or keeping a client's account isolated) can create several projects under one login and switch between them instantly.
### Switching Projects
Use the **project selector** in the sidebar to switch the active project. Selecting a different project reloads the dashboard into that workspace.
### Managing Projects
From the project selector, click **Manage Projects** to open the **Manage Projects** modal. It lists every project you have with its **name** and **date added**, and lets you:
* **View** all of your projects in one table.
* **Delete** a project using the trash icon on its row.
* **Create a new project** with the **+ Create New Project** button.
### Creating a Project
1. Open **Manage Projects** from the project selector.
2. Click **+ Create New Project**.
3. Enter a **Project Name** in the create-project dialog.
4. Click **Create New Project** to confirm.
The new project is added to your project selector immediately, ready to switch into and connect Amazon accounts.
{% hint style="warning" %}
**Deleting a project is permanent.** It removes that workspace's connections, data, and settings. Make sure you have selected the correct project before deleting, and export anything you need first.
{% endhint %}
***
## Notification Settings
Control what notifications you receive and how you receive them.
### Notification Categories
| Category | Examples | Default |
| ------------------------ | ---------------------------------------------------- | ------- |
| **Price Alerts** | Buy Box lost, competitor price change, price error | Enabled |
| **Inventory Alerts** | Low stock, out of stock, restock needed | Enabled |
| **Hijacker Alerts** | New seller on your listing, unauthorized seller | Enabled |
| **Review Alerts** | New review received, negative review alert | Enabled |
| **PPC Alerts** | Budget depleted, bid rule triggered, approval needed | Enabled |
| **System Notifications** | Sync completed, plan renewal, feature updates | Enabled |
### Delivery Channels
For each category, you can configure:
* **Email:** Sent to your registered email address
* **Webhook:** Send notifications to an external endpoint (for integrations)
### Late-Shipment Alerts (FBM)
The Notifications area includes a dedicated toggle for **late-shipment alerts**, aimed at FBM (Fulfilled by Merchant) sellers who need to ship on time to protect their account health.
| Setting | Behavior |
| ----------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Get notified about late FBM shipments** | When enabled, SellerMagnet emails **and** notifies you up to **twice per day** when orders are still pending shipment past the **12-hour / 24-hour** marks. |
| **Scope** | This is a **project-level** setting - it applies to the current project, not a single connection. |
| **Stays in sync** | The same toggle also appears inside the **Seller Performance** widget on the home dashboard. Flipping it in either place updates both. |
{% hint style="success" icon="rocket" %}
**Pro Tip:** If you run FBM, turn this on. Catching a pending order before the 24-hour mark protects your On-Time Delivery Rate (OTDR) and helps avoid account-health penalties.
{% endhint %}
> **Pro Tip:** At minimum, keep **Hijacker Alerts** and **Price Error Alerts** enabled via email. These are time-sensitive notifications that can prevent significant revenue loss.
***
## Manage Payment (Billing Portal)
Clicking **Manage Payment** in the settings sidebar opens the **Stripe Billing Portal** in a new tab. This is a secure, external portal managed by Stripe where you can:
* View your current subscription plan and billing cycle
* Update your payment method (credit card, debit card)
* Download past invoices and receipts
* Cancel or modify your subscription
> **The billing portal is hosted by Stripe**, SellerMagnet's payment processor. Your payment details are stored securely by Stripe and are never accessible to SellerMagnet directly.
### Understanding Your Plan
SellerMagnet offers tiered plans. To view plan details and upgrade options from inside the dashboard, navigate to **Manage Plan** in the sidebar (under the Subscription section).
| Plan Component | What Varies |
| ----------------------- | ------------------------------------------ |
| **Analytics Dashboard** | Order volume limits, data retention period |
| **Repricer** | Number of active repricing rules |
| **Review Requester** | Monthly review request allowance |
| **Listing Optimizer** | Available on all plans |
| **PPC Manager** | Requires separate PPC ads credential |
***
## FAQ
Can I change my display currency after initial setup?
Yes. Go to **Settings > General** and change the currency dropdown. The change takes effect immediately across the dashboard. Historical data will be displayed using the exchange rate at the time of each original transaction.
How many Amazon connections can I have?
There is no hard limit on the number of connections. You can connect as many Amazon Seller Central accounts as you need. Each connection counts toward your plan's order volume limits.
What happens if my Amazon connection shows an error?
Connection errors usually mean the authorization token has expired or was revoked. Go to **Settings > Connections**, click **Reconnect** on the affected connection, and re-authorize through Amazon Seller Central.
Can I set different shipping costs per marketplace?
Yes. Create separate shipping methods for each marketplace/region combination. Assign the appropriate route to products based on where they ship from and to.
How do I cancel my subscription?
Go to **Settings > Manage Payment** to open the Stripe billing portal. From there, click **Cancel Subscription**. Your access continues until the end of the current billing period.
Will I lose my data if I downgrade my plan?
No. Your historical data is preserved. However, if you exceed the limits of the lower plan (e.g., active repricer rules), you will need to deactivate rules until you are within the new limit.
Can I export my settings?
Currently, settings cannot be exported. However, shipping methods and connection configurations are preserved across plan changes. If you need to migrate settings, contact support at .
***
⚠️ Common Mistakes to Avoid
| Mistake | Impact | Solution |
| ---------------------------------------------------- | --------------------------------------------- | ---------------------------------------------------------------- |
| Not configuring shipping methods | Profit calculations show inflated margins | Set up routes for your top 5 shipping corridors on day one |
| Forgetting to set VAT on Amazon fees | Fee calculations are incorrect for EU sellers | Configure this during initial setup or in Connection Settings |
| Ignoring the usage dashboard | Hitting plan limits unexpectedly | Check usage weekly in General Settings |
| Using the same connection name for multiple accounts | Confusion when switching connections | Use descriptive names like "US Main", "EU Store", "UK FBM" |
| Leaving default notification settings | Alert fatigue or missed critical alerts | Customize notifications to match your workflow in the first week |
\## ➡️ What's Next?
{% content-ref url="/pages/RvhwSiJcBKPPVXsU7OBM" %}
[Account Settings](/account-and-settings/account-settings.md)
{% endcontent-ref %}
{% content-ref url="/pages/gEHjN0IlyP0zjQ7jBbK4" %}
[Dashboard Overview](/dashboard-and-analytics/dashboard-overview.md)
{% endcontent-ref %}