Known limitations: There is no established universal priority rule when promotions overlap, automatic inclusion of products created later, a same-day date cutoff or timezone rule, or a universal recalculation time. The tasks below require readback of the current list, product scope, and advice instead of assuming those outcomes.
Task 1 — Open, filter, and inspect Promotions
Purpose
Find the correct webshop promotions, narrow the list, and open a promotion without changing its data.
Prerequisites
- Promotions must be enabled for the webshop and available to the account.
- Have Promotions View access to inspect the list; Edit access is required for create and mutation actions.
- Have Products permission if you need to use the Products tab or product actions inside a promotion.
- Confirm the selected webshop before reviewing results.
Steps
- Open Promotions from the main navigation.
- Wait for the list to finish loading.
- Search by the available promotion fields and apply filters such as Notes, whether notes exist, Promotion name, Start date, End date, Uplift type, Expected uplift, and Products count.
- Sort the result using the shared sort control where sorting is available.
- Use Column view to choose, order, show, pin, or resize visible columns.
- Change the page size or move through pagination when needed. The current table exposes page sizes from
10through200; its current initial page size is50. - Use Clear all to remove active searches and filters when it is available.
- Select a row or its promotion name to open the details view.
Fields and columns
The normal list columns are:
- Notes;
- Promotion name;
- Start date and End date;
- Uplift type and Expected uplift;
- Products or Products count.
Editable users can also see selection and Actions columns. Filters, sort, search, pagination, refresh, and column controls are visible only where the account exposes them. Products count accepts whole numbers from zero upward in the current list.
Expected result
The list shows the current result for the selected webshop and active search/filter state, or the selected promotion opens in its details view. No promotion is changed by inspection alone.
Limitations
- View-only access does not expose all mutation controls.
- An empty result does not prove that no promotion exists; active filters, search, pagination, permission, and webshop selection can affect the result.
- Notes are not sortable in the current list.
- The list's page-size values and visible columns are current interface behavior, not a promise that every account has identical controls.
Errors and recovery
- While loading, the table can temporarily show no rows. Wait for loading to finish before interpreting the result.
- If the result is empty, clear filters and search terms, refresh, and confirm the webshop.
- If a load fails, use the visible error feedback, resolve the access or connection issue, wait for the failed state to finish, and select Refresh.
- If a row cannot be opened, check Promotions and Products permission rather than retrying a mutation.
Product promotion-selection panel
Where a Product opens a promotion-selection side panel, the list initially filters to enabled promotions and sorts by Product uplift in descending order. Use its search, filters, sort and clear controls where available, then select the intended promotion to open its details. An empty filtered list is not proof that the webshop has no promotions. This panel selects a promotion; it is not a new CSV-import route or confirmation of a saved change. Use the promotion's actual editor and visible validation for field values.
Form validation
Enter a nonblank Promotion name, a Start date and an End date. For a new or duplicated promotion, choose a Start date that is not in the past. The End date must not be earlier than the Start date; equal dates pass this date-order check. Follow any other validation shown by the form before continuing.
For Relative or Absolute Expected uplift, correct a displayed zero-uplift error. Close out is a separate choice, not a zero uplift workaround. These are form-specific checks, not a guarantee that the same rules apply to imports or integrations.
After duplication, review the new promotion's dates and Products table. Confirmation wording or a disappearing copying message does not prove that every Product has finished copying.
Create a promotion
Purpose
Create a promotion with an intentional date range, uplift type, and enabled state.
Prerequisites
- Have Promotions Edit access or shop-administrator access.
- Confirm that Promotions is enabled for the selected webshop and is not locked by the account plan.
- Decide whether the promotion is relative, absolute, close-out, or no uplift.
- Prepare the products or scope that will be associated after creation.
Steps
- Select Create promotion.
- Enter a Promotion name.
- Choose the Start date and End date, ensuring the End date is not earlier than the Start date.
- Choose an Uplift type.
- Enter Expected uplift when Relative or Absolute requires an editable value. Do not use zero where the current form rejects zero.
- Review the enabled toggle; the current form can open enabled, but the value must be checked before saving.
- Continue to the product-scope step.
- Review the values and select Create promotion.
- Use the post-create choice to view details or add products.
Fields and columns
The create form contains:
- Promotion name — required in the current form.
- Start date and End date — required; the End date cannot be earlier than the Start date.
- Uplift type — Relative (%), Absolute, Close out, or No uplift.
- Expected uplift — required when the selected type uses an editable value; its validation is shown by the form.
- Enabled — the promotion state to review before creation.
There are no list columns in the create panel; product-scope choices appear in the next step.
Expected result
A promotion is created with the values you reviewed, and the workflow offers the next available product-association or details action.
Limitations
- A Relative uplift is a percentage-style demand adjustment and an Absolute uplift is a fixed-quantity adjustment; neither is a checkout price discount.
- Close out is a temporary planning choice and is not the same as permanently phasing out a Product.
- No universal uplift value, same-day cutoff, timezone interpretation, forecast result, or order quantity is established.
- Close and Back controls can be unavailable while a save is in progress.
Errors and recovery
- If Create is disabled, correct required fields, date order, uplift value, and the visible enabled-state validation.
- If creation fails, return to the list or details view and verify whether a promotion was actually created before trying again.
- If the post-create panel does not load, keep the promotion record as the source of truth and use Add products from its details view after access is restored.
Duplicate a promotion
Purpose
Use an existing promotion as the starting point for a separate promotion, then verify its details and Product associations.
Prerequisites
- Open the intended source promotion or find it in the Promotions table.
- Use an account where Duplicate promotion is available and have the required editing access.
- Review the source's Product scope, dates, uplift and enabled state before copying it.
Steps
- Choose Duplicate promotion from the source promotion's table action or editor where offered.
- Review the copied name, dates, uplift type, expected uplift and enabled state in the single-step form. Edit them for the new promotion rather than accepting the copied values blindly.
- Enter a nonblank name and both dates, with the End date no earlier than the Start date. For a new duplicate, choose a Start date that is not in the past. When the source starts in the past, select both dates again if the form clears them.
- Submit the valid form once and wait for its response. This copy workflow is separate from applying a promotion to the entire webshop or importing Products from a file.
- After confirmation, use Go to promotion page to open the new promotion.
- Review the new promotion's details and Products table. A Copying products banner is progress information, not proof that every expected Product has copied; verify the actual associations even if the banner disappears.
Fields and columns
- Promotion name, dates, uplift type, expected uplift and Enabled — copied starting values to review and edit.
- Confirmation Product count — can reflect the source's displayed count; it is not an independently verified copied-row total.
- Copying products — progress shown by the interface, not a completion deadline.
- New promotion's Products table — the place to review the associations actually present after the operation.
Expected result
The workflow returns a separate promotion that you can open and verify. Rely on its saved details and actual Product associations, not the initial confirmation count alone.
Limitations
- Duplication does not mean applying the promotion to every webshop Product.
- The duplicate form's new-date rules differ from editing an existing promotion, which can retain a past Start date.
- No two-minute copy-completion promise, guaranteed Product count, account availability or downstream advice result follows from the banner or confirmation.
Errors and recovery
- If submission is unavailable, check the trimmed name, both dates, date order, past Start date, loading and saving state.
- If confirmation or loading fails, check the Promotions list and new record before resubmitting, so that an unclear response does not create an unintended second copy.
- If copied Products are missing, refresh the new promotion's Products view after the visible operation, verify the intended source scope and use the normal support channel if the result remains incomplete. Do not treat a vanished progress banner as a complete-copy receipt.
Add Products and choose Product scope
Purpose
Associate the intended current webshop products with an existing promotion by manual selection, import, or the entire-webshop action.
Prerequisites
- Have Promotions Edit access and Products permission for product-scope actions.
- Open an existing promotion or reach the product step after creation.
- For the CSV-import workflow, prepare a CSV file containing the Product identifiers accepted by the current entry point. A spreadsheet used for preparation is not itself a promise of native Excel upload support.
- Check whether another import or conflicting job is running.
Steps
- Open Add products from the promotion's Products area or choose the product action after creation.
- Choose one available scope: Import products, Select products, or Apply promotion to all webshop products.
- For manual selection, search or filter available products, select the intended rows, and review the selection.
- For import, use the file type and identifier mapping offered by that workflow, upload the prepared file, and wait for the job result.
- For the entire-webshop option, review the confirmation carefully and confirm only when the current product scope is intended.
- Read back the promotion's Products table after the action finishes.
- Confirm that the intended products and any product-specific values are present before relying on the promotion.
Fields and columns
The product-scope workflow can expose:
- product ID or SKU used for import;
- product identity and the shared search/filter controls;
- selected-row count, with the current table selection ceiling of
200; - import job feedback;
- Products-table identity, uplift, and action columns where enabled.
Expected result
The promotion's Products view shows the current associations that were accepted by the selected workflow. Treat the request as incomplete until you review the Products table or job result.
Limitations
- A successful upload or entire-webshop request is not proof that every row was accepted or that downstream processing has finished.
- The entire-webshop operation applies to the current webshop products exposed by the action. The current workflow does not establish automatic inclusion of products created later.
- Product actions depend on Products permission and can be unavailable while another job or table operation is running.
- Do not send an import file containing unnecessary private data to Support; use an authorized support channel only when requested.
Errors and recovery
- If import is unavailable, check for a conflicting job, file type, product ID/SKU format, permission, and current promotion state.
- If the job reports partial or failed results, use the job feedback and Products table to identify what was actually accepted before retrying.
- If the entire-webshop request is asynchronous or the table is stale, wait for the visible operation to finish and refresh the Products view.
- If a product is missing, verify the selected webshop and source Product identifier instead of repeatedly adding it.
Edit promotion information, settings, and notes
Purpose
Update an existing promotion's information, enabled state, scope, or promotion note while preserving the distinction between editable fields and derived status.
Prerequisites
- Open the correct promotion and have Promotions Edit access.
- Confirm whether you are editing the information, Settings, or Notes section.
- Check the current Products scope before changing an entire-webshop setting.
- Wait for any existing save or product operation to finish.
Steps
- Open the promotion's Overview and review its current dates, uplift, enabled state, derived status, Settings, Notes, and Products scope.
- Select the section's edit control.
- Change only the intended information or enabled/scope setting.
- Use Save to persist the section or Cancel to restore its persisted values.
- For Notes, open the Notes panel, enter or change the promotion note, then Save; use Close or Cancel to leave it unchanged.
- If the entire-webshop scope is enabled, review the resulting Products list after the background operation.
- Read back the promotion details after each save.
Fields and columns
The Overview and editor can show:
- Promotion name;
- Start date and End date;
- Uplift type and Expected uplift;
- Enabled state;
- derived status such as Disabled, Planned, In progress, or Ended;
- entire-webshop scope;
- Notes and the Notes indicator in the list;
- Products information when the Products tab is available.
Expected result
The selected section saves the valid changes, or Cancel leaves its persisted values unchanged. The promotion details and list reflect the saved state after readback.
Limitations
- Status is derived from enabled state and dates; it is not a separate editable status field.
- This guide does not establish an exact start/end cutoff or timezone rule.
- Entire-webshop scope can trigger background processing, so saving the setting is not proof that every current product has been associated.
- Notes are internal promotion notes; do not place credentials or sensitive customer payloads in them.
Errors and recovery
- If Save is disabled, check required values, date order, permission, loading, and whether another edit is active.
- If a section save fails, use the persisted detail view as the source of truth and retry only after correcting the visible issue.
- If status appears unexpected, compare the saved dates and enabled state rather than manually trying to edit a derived status.
Edit Product-specific uplift
Purpose
Set or remove a product-level uplift for a product already associated with a promotion.
Prerequisites
- Open the promotion's Products tab with the Products permission and Promotions Edit access.
- Confirm the correct product and promotion before editing.
- Wait for the Products table to finish loading and ensure no other row is in edit mode.
- Decide whether the product should use the promotion default or an override.
Steps
- Search or filter the Products table to the intended product.
- Open the product row for editing.
- Choose Relative, Absolute, Close out, or No uplift.
- Enter Expected uplift when the selected type requires it.
- Review the row and select Save.
- To remove a complete product-specific override, clear the override and save; confirm that the product remains associated.
- Use the separate remove action only when the product should no longer belong to the promotion.
Fields and columns
The Products table can expose:
- product identity and searchable product columns;
- promotion-level and product-specific uplift information;
- the product-specific Uplift type;
- Expected uplift when required;
- row edit, save, cancel, remove, and other actions where permitted.
Expected result
The saved product row either uses its valid product-specific uplift or falls back to the promotion-level uplift when the complete override is cleared. Removing a product is a separate association action.
Limitations
- A product can be associated with more than one promotion. The current workflow does not establish a “latest promotion wins” or other priority rule.
- A product-specific uplift is planning input, not a checkout price change and not a guaranteed order quantity.
- Product rows can be locked while the table is loading, another edit is active, or a conflicting operation is running.
- Product Details promotion controls are Products-owned; use the central promotion editor for promotion-level scope and lifecycle changes.
Errors and recovery
- If the row cannot be edited, finish or cancel another row edit and check permission, loading, and promotion state.
- If the expected value is rejected, use the visible validation for the selected uplift type.
- If Save fails, re-open the row and verify whether the old override, promotion default, or persisted removal is shown before trying again.
- Do not remove the product to clear an override; clear the override when the association should remain.
Bulk enable, disable, or delete promotions
Purpose
Use lifecycle and data-transfer actions deliberately, with a readback check before or after any potentially destructive operation.
Prerequisites
- Have Promotions Edit access for Enable, Disable, Delete, import, and other mutation actions.
- Have Exports enabled and the required export permission for export actions.
- Review the exact rows selected and the current enabled state.
- Confirm that no unsaved edit or conflicting job is in progress.
Steps
- For one row, open its Actions menu and review the available action.
- Use Disable to stop an enabled promotion reversibly, or Enable to re-enable a disabled promotion.
- Use single-row Delete only after reading its confirmation and accepting that the action cannot be undone.
- For a bulk action, select only the intended rows and choose Enable, Disable, or Delete.
- For import or export, review the file/job or current filters, search, sort, and selected promotions before dispatching it.
- After the action, wait for feedback, confirm that selection is cleared where applicable, and reload the list or details view.
- Verify the resulting enabled state, presence/absence, Products scope, or job result before taking another destructive action.
Fields and columns
Relevant controls include:
- row Actions: Edit, Disable, Delete, Enable, or the actions available for the current state;
- selected-row count, limited to
200in the current list; - exportable visible data columns: Notes, Promotion name, dates, Uplift type, Expected uplift, and Products;
- current search, filters, sort, and optional selected promotions used by export;
- import or export progress and result feedback.
Expected result
The requested lifecycle or data-transfer action has visible feedback and its result is confirmed in the refreshed list, details view, or job result. A disabled promotion remains available for later enabling; a deleted promotion is removed from the normal list.
Limitations
- Disable is reversible; Delete is destructive and the single-row flow warns that it cannot be undone.
- The bulk Delete menu does not establish a separate confirmation step. Treat the selected rows as the confirmation and verify them before choosing Delete.
- Dispatching an import or export does not prove that every row was processed or that a file was generated successfully.
- Seeing a completed UI request does not prove downstream forecast, email, or integration processing has finished.
Errors and recovery
- If an action is unavailable, check the row state, permission, feature configuration, loading, selection count, and current job state.
- If a mutation reports failure or times out, do not repeat a destructive action immediately. Refresh or open the details view and confirm the current state first.
- If an import or export fails, use its result feedback and current filters/selection to correct the request before retrying.
- If a bulk selection is wrong, clear it and start again rather than relying on a hidden or stale selection.
Task 7 — Check promotion impact and recover from unexpected advice
Purpose
Validate that the intended promotion data is present before interpreting a forecast or purchase-advice change, without promising a fixed runtime or quantity.
Prerequisites
- Confirm the correct webshop, promotion enabled state, dates, uplift type, expected uplift, and product scope.
- Read back any product-specific overrides and import/entire-webshop job results.
- Have access to the relevant forecast, stock, and purchase-advice views.
- Keep the visible error text and affected product information available without including credentials or unnecessary personal data.
Steps
- Check whether the promotion is enabled and whether its dates place it in the intended planning period.
- Compare promotion-level and product-specific uplift values.
- Review overlapping promotions for the same Products instead of assuming precedence.
- Check current stock, incoming supply, forecast, Supplier constraints, and the applicable planning state.
- Review the purchase advice after the applicable processing has completed according to the account's visible state; no fixed schedule is implied.
- If the result is unexpected, correct the source data or promotion configuration only after identifying the difference.
- Record the promotion name, affected Product identifiers, dates, uplift choice, and visible error for an authorized support request when needed.
Fields and columns
Use these values as the troubleshooting record:
- Promotion name, Start date, End date, enabled state, and derived status;
- promotion-level Uplift type and Expected uplift;
- product association and product-specific Uplift type/Expected uplift;
- overlapping promotion names and scopes;
- import, export, or entire-webshop job result;
- current stock, incoming stock, forecast, Supplier constraints, and purchase-advice value where visible.
Expected result
The active promotion configuration and product scope are understood, and any advice difference is reviewed against the available planning inputs rather than an assumed priority or timing rule.
Limitations
- When promotion processing is enabled, eligible promotion data can affect demand normalization, forecasts, and proposed purchase quantities, but the source does not establish a universal recalculation time or resulting order quantity.
- Relative, Absolute, Close out, and No uplift have different planning meanings; the UI value alone does not promise a business outcome.
- Multiple promotions can apply to one product, and no customer-safe priority rule is established.
- This guide does not claim that a promotion changes checkout pricing, stock, or an external webshop.
Errors and recovery
- If the promotion or advice is missing, confirm webshop, permission, enabled state, dates, and Products scope first.
- If an action failed, recheck the list or details view before repeating it.
- If advice remains unexpected, compare the promotion with stock, incoming supply, forecast, Supplier eligibility, MOQ, Lot Size, Minimum order value, and current planning state.
- Escalate with only the necessary visible identifiers and error text; never include credentials, tokens, or raw private payloads.
Manage Products in a promotion
Purpose
Find, add, import, remove, or export intended Product associations for an existing promotion.
Prerequisites
- Open the correct promotion with Promotions edit access and Product permission.
- Confirm the current webshop and promotion state.
- Wait for any existing Product operation or import job to finish.
Steps
- Open the promotion's Products view.
- Search, filter, sort, or paginate to find intended associations.
- Use Add products for manual selection, the import workflow for a file, or the available remove action for selected associations.
- Use export when you need a file snapshot of current associations.
- Reload the Products view and verify accepted additions, removals, or the export source.
Fields and columns
- Product identity and association state — identify each Product included in the promotion.
- Product-specific uplift and selection count — describe available Product-level values and staged actions.
Product identity, Product-specific uplift, selection count, association actions, search, filters, sorting, pagination, and export controls can be shown. Import results are reviewed separately in job feedback.
Expected result
The promotion's Products view shows intended current associations after completed operations, or provides the requested file snapshot.
Limitations
- Adding, importing, removing, and exporting are separate operations with separate outcomes.
- A successful upload does not prove every file row was accepted.
- Product actions can be unavailable during another edit or job.
Errors and recovery
- If a Product is missing, verify webshop, identifier, filters, permission, and promotion state.
- If an import is partial or failed, use job feedback before retrying rejected rows.
- If a removal or addition result is unclear, reload and verify the association before repeating the action.