Skip to content
BFCM Planning

How to Test Shopify Product Embeds Before BFCM: A Step-by-Step QA Workflow

Anika Anamta Mehnaz17 min read
shopify bfcm qa checklist
On this page

Black Friday traffic can expose problems you never noticed during everyday selling. A product embed that worked last month might now display the wrong variant, send customers to checkout with an incorrect quantity, or stop working after a website update.

These problems become harder to manage when you sell Shopify products through multiple websites. Your BFCM campaign might include product placements on WordPress blogs, landing pages, affiliate articles, and partner websites. Checking every page manually without a proper testing process can lead to missed errors, repeated work, and last-minute confusion.

That's where Shopify product embed testing becomes important. Instead of simply checking whether a product appears on a page, you need a repeatable process to confirm that the complete buying experience works as expected.

This guide walks you through a practical BFCM quality assurance (QA) workflow. You'll learn how to organize your placements, create test cases, document problems, verify fixes, and decide when your Shopify product embeds are ready for campaign traffic.

Quick Answer: How Do You Test Shopify Product Embeds Before BFCM?

To test Shopify product embeds before BFCM, list every external page containing your products, prioritize important campaign placements, and create a QA test matrix. Run each test on the published page, compare the actual result with the expected outcome, and record any failures. After fixing issues, retest the affected features and complete a final launch review.


TL;DR

  • List your placements: Record every blog, landing page, or partner website where Shopify products appear.

  • Create test cases: Define what you will test, the steps to follow, and the expected result.

  • Test the buying journey: Check product selection, quantities, cart behavior, checkout, mobile usability, and tracking.

  • Record and fix issues: Use a consistent bug-reporting format and prioritize problems that prevent purchases.

  • Approve the campaign: Retest fixes, check affected pages again, and launch only when critical problems are resolved.


Prepare Your Shopify Product Embed Testing Environment

Before opening pages and clicking buttons, prepare a testing setup. This keeps your results consistent and makes it easier to identify whether a problem comes from Shopify, your external website, or the embedded component.

Identify where your products are embedded

Suppose you run a Shopify store selling kitchen accessories. For BFCM, you promote your products through a WordPress recipe blog, a holiday gift guide, a campaign landing page, and two affiliate websites.

You have five placements to manage, even if several display the same product.

Create a simple inventory:

Placement

Product

Website

Priority

BFCM landing page

Kitchen Gift Set

Campaign site

High

Recipe article

Mixing Bowl

WordPress

Medium

Holiday gift guide

Kitchen Gift Set

WordPress

High

Affiliate review

Nonstick Pan

Partner site A

High

Affiliate comparison

Nonstick Pan

Partner site B

Medium

Add the exact page URLs, component identifiers, and campaign owners to your working spreadsheet.

This becomes your testing inventory. Whenever a product, promotion, or embed changes, you know which pages might need another check.

Prepare browsers and devices

You don't need an expensive testing platform to begin. Start with devices and browsers your customers commonly use.

For example:

  • Desktop: Chrome and Safari, where available.

  • Mobile: A real Android phone and iPhone.

  • Browser sessions: Normal and private browsing.

  • Testing tools: A spreadsheet, screenshots, and browser developer tools if needed.

Test your most important pages on real phones rather than relying entirely on a desktop browser resized to a mobile width.

Prepare a safe checkout testing method

You should also decide how to test the purchase process without accidentally creating real customer orders.

Shopify supports test orders through its Test payment gateway and Shopify Payments test mode, where eligible. However, Shopify warns that payment test mode affects live purchasing, so it should not be enabled casually on an active production store.

Use a suitable development or controlled testing environment when possible. If you must test against a live store, follow Shopify's supported testing guidance and coordinate any payment changes before testing.

For the broader pre-launch requirements, you can also use this BFCM checklist for external product placements to confirm that your product, promotional, and inventory preparations are complete.

Create a Shopify Product Embed QA Test Matrix

A QA test matrix is a spreadsheet that records what you are testing and whether each test passed.

Without one, you might check a product's price on Monday, test its cart button on Tuesday, and forget whether anyone verified the mobile experience.

A test matrix keeps everything together.

What should your test matrix contain?

Use these columns:

Column

Purpose

Test ID

Unique number for each test

Page URL

Exact page being tested

Test scenario

What you want to verify

Steps

Actions the tester performs

Expected result

What should happen

Actual result

What actually happened

Status

Pass, Fail, Blocked, or Not Tested

Owner

Person responsible

Last tested

Most recent test date

For example, imagine a product embed with three size options.

Test ID

Test scenario

Expected result

Status

EMB-01

Select size Large

Large is selected

Pass

EMB-02

Add 2 units

Cart contains 2 units

Pass

EMB-03

Change size to Medium

Cart uses Medium

Fail

EMB-04

Continue to checkout

Correct products appear

Blocked

EMB-05

Open embed on mobile

All controls are usable

Pass

In this example, the checkout test is marked Blocked because the incorrect variant prevents a reliable purchase-flow test.

That distinction matters. A blocked test isn't necessarily a confirmed checkout bug. It means another problem must be resolved before testing can continue.

Use consistent testing statuses

Keep the statuses simple and use the same definitions throughout the campaign.

  • Pass: The actual result matches the expected result.

  • Fail: The result differs from what was expected.

  • Blocked: Another issue prevents the test from being completed.

  • Not Tested: Nobody has run the test yet.

Avoid using vague statuses such as "Looks fine" or "Probably works." They make the final launch decision harder.

3. Run a Step-by-Step Shopify Product Embed QA Test

Now that your test matrix is ready, you can begin Shopify product embed testing.

The important difference between a general readiness checklist and QA testing is that every scenario must have a specific action and a measurable expected result.

Let's use an example.

Your BFCM landing page contains an embedded product called Holiday Coffee Gift Box. Customers can choose between Standard and Premium versions before buying.

Test Case 1: Confirm the product loads on the published page

Objective: Verify that the embed works on the external website.

Steps:

  1. Open the published BFCM landing page.

  2. Scroll to the embedded product.

  3. Refresh the page.

  4. Repeat in a private browser window.

  5. Compare the live page with the intended component configuration.

Expected result: The product component loads without a blank section, script error visible to the customer, or missing purchase controls.

If the component fails to load, record the page URL, browser, device, time, and any visible error.

An embed may work in an app preview but fail on a published website because of the website's script restrictions, caching, or page configuration.

For instance, Shopify's official Buy Button documentation confirms that embedded code must be added through the relevant website's HTML publishing workflow.

Test Case 2: Verify variant and quantity selection

Objective: Confirm that the intended product options enter the buying process correctly.

Steps:

  1. Select the Premium version.

  2. Set the quantity to three.

  3. Click Add to Cart, or use the configured purchase action.

  4. Review the selected product in the cart or checkout.

  5. Repeat the test with the Standard version.

Expected result: The selected variant and quantity remain correct throughout the purchase flow.

Example:

test case example

If the cart contains one Standard box instead, record a failure even though the Add to Cart button technically worked.

Test Case 3: Verify promotional pricing at checkout

Objective: Confirm that the price charged matches the intended BFCM offer.

Suppose your Premium Gift Box normally costs $60 and your campaign promises 20% off, bringing the product price to $48.

Steps:

  1. Open the external product placement.

  2. Select Premium.

  3. Add one unit or proceed directly to checkout.

  4. Apply the campaign discount code if your promotion requires one.

  5. Check the relevant discount, product subtotal, and order total.

Expected result: The intended 20% product discount is applied correctly. For this example, the discounted product amount should be $48 before applicable shipping and taxes.

Do not mark a test as failed simply because a checkout-level discount wasn't shown on the original embedded product card. Shopify product pricing and checkout discounts can behave differently.

Your test should follow the actual promotional configuration and verify the promised offer at the appropriate stage.

Test Case 4: Verify mobile purchasing

Objective: Check whether customers can complete the same actions comfortably on a mobile device.

Steps:

  1. Open the external page on a real phone.

  2. Scroll to the product.

  3. Select a variant.

  4. Change the quantity.

  5. Click the purchase button.

  6. Continue toward Shopify checkout.

Expected result: The product remains readable, the controls respond properly, and no page elements cover the buying interface.

Pay particular attention to sticky website headers, cookie notices, overlapping text, and buttons hidden outside the visible screen.

Test Case 5: Verify campaign tracking

Objective: Confirm that an interaction can be attributed to the correct placement.

For example, you have an affiliate partner named Alex who promotes the Holiday Coffee Gift Box.

Steps:

  1. Open Alex's published promotional page.

  2. Use the intended campaign link or embedded component.

  3. Interact with the product.

  4. Follow your approved test-purchase process if order attribution needs verification.

  5. Review the relevant analytics and affiliate records.

Expected result: The supported activity is attributed to Alex's placement rather than another partner's campaign.

Be careful with the distinction between tracking a click, tracking an order, and assigning affiliate commission. These are different checks, and a successful click record does not automatically prove that order attribution is correct.

Document Bugs and Prioritize Fixes

When a test fails, the next step is to explain the problem clearly enough that someone else can reproduce it.

Suppose the Premium Gift Box is selected, but the cart receives the Standard version. Writing "Cart isn't working" doesn't tell your developer what went wrong.

A useful bug report should include:

Field

Example

Bug ID

BUG-014

Issue

Wrong variant added to cart

Page

BFCM landing page

Device

Android, Chrome

Steps

Select Premium β†’ Qty 2 β†’ Add to Cart

Expected

Premium Γ— 2

Actual

Standard Γ— 2

Severity

Critical

Evidence

Screenshot or screen recording

Status

Open

Include a link to the affected page and the corresponding test ID. This lets your developer locate the problem without asking you to repeat the entire test.

How to prioritize BFCM embed issues

Not every problem requires the same urgency. A checkout failure should receive more attention than a slightly misaligned product image.

Use a severity system:

Severity

Example

Recommended action

Critical

Checkout fails or wrong item is ordered

Block launch of affected placement

Major

Promotional price is incorrect or mobile purchase button is unusable

Fix before sending campaign traffic

Minor

Text spacing is inconsistent

Fix when practical

Cosmetic

Slight icon misalignment

Can be scheduled after higher-priority fixes

Severity should reflect customer impact, not simply how difficult the issue is to repair.

A typo in a button label might be cosmetic. A typo that changes "30% off" to "50% off" is a major promotional accuracy issue.

Who should own each issue?

Assign each problem to a specific person or team.

For example, an incorrect Shopify product price might need attention from the merchant managing discounts. A product component failing to render could require help from the embed app provider or website developer. A partner page displaying outdated BFCM copy may need the partner's content manager.

One person should still be responsible for verifying that the fix works after it's delivered.

Run Regression Tests After Making Changes

Fixing one issue doesn't always mean the entire buying experience is working again.

Imagine your website developer adjusts the mobile layout because the quantity selector overlaps the purchase button. The selector is now visible, but the updated layout accidentally hides the cart confirmation message.

The original problem is fixed. A different one has appeared.

This is why regression testing matters.

Regression testing means checking whether previously working features still work after a change.

How to perform a regression test

Follow this process:

  1. Identify the change that was made.

  2. Run the original failed test again.

  3. Check other features that might be affected.

  4. Repeat the relevant tests on important devices.

  5. Update the QA matrix with the new results.

For example:

Change made

Additional tests to run

Updated product variant

Variant selection, cart, checkout

Changed discount

Product price, discount application, checkout

Updated mobile design

Variant selector, quantity, buttons, cart

Replaced embed code

Loading, product actions, checkout, tracking

Changed partner assignment

Affiliate tracking and attribution

The scope of regression testing should reflect the change. Replacing an embed script could require a broad set of tests, while correcting unrelated paragraph text probably won't.

When should you test again?

Don't reserve all your testing for the night before Black Friday.

A workable process is to test when important changes occur, such as:

  • A product or promoted variant changes.

  • BFCM pricing or discount settings are updated.

  • A website theme, page builder, or embedded component is changed.

  • A partner publishes or updates a placement.

  • A failed test is fixed.

Before campaign launch, run the essential purchase-flow tests once more on your highest-priority pages.

This helps catch errors introduced between the original QA pass and the final campaign release.

Test Third-Party and Affiliate Placements Separately

You might have full access to your WordPress site but limited control over a partner's website.

That difference matters during BFCM.

For example, you send the correct product embed code to a technology blogger. The component looks right in your configuration panel, but the blogger's website blocks the script. The article is published, yet visitors see an empty section where the product should appear.

Your store-level tests wouldn't catch that.

How to test a partner placement

Ask your partner for the published page URL and open it as an ordinary visitor.

Run the relevant tests directly on their website. Confirm that the embedded component loads, that product interactions work, and that the purchase process reaches the intended Shopify checkout.

Also verify the campaign tracking setup.

When using EmbedUp, affiliate components can be assigned to specific affiliates, with tracking information configured at the component level. Its affiliate documentation recommends distinct components for different partners to keep attribution separate.

For example, if you work with two creators:

Partner

Component

Attribution test

Alex

Coffee Box – Alex

Test interaction attributed to Alex

Jamie

Coffee Box – Jamie

Test interaction attributed to Jamie

A successful test on Alex's page doesn't confirm Jamie's placement works. Each published partner page must be verified individually.

What if the partner cannot make changes immediately?

Record the issue and decide whether the placement can safely receive BFCM traffic.

If the buying experience is broken, avoid directing paid campaign traffic to that page until the issue is resolved. You may need to send customers to a verified alternative destination while the partner fixes the problem.

Don't consider the issue complete until the partner's actual published page passes the relevant tests.

Decide Whether Your Shopify Product Embeds Are Ready to Launch

Once your testing and retesting are complete, you need a clear launch decision.

This is often called a go/no-go decision.

Go means the placement meets your requirements and can receive campaign traffic. No-go means important problems remain unresolved.

You don't need a complicated approval system. A simple spreadsheet can provide enough information.

Example BFCM launch approval report

Example BFCM launch approval report

This example does not mean every campaign must achieve a particular numeric pass rate. A campaign with 95% of tests passed can still be unready if the remaining failures prevent checkout.

Final BFCM launch checklist

Use this checklist during your final approval meeting.

  • All high-priority external placement URLs are recorded.

  • Essential product, variant, cart, and checkout tests pass.

  • Critical and major purchasing issues are resolved.

  • Mobile purchase flows have been tested.

  • Required campaign and affiliate tracking checks pass.

  • Previously failed tests have been rerun.

  • Checkout testing settings have been safely restored.

  • A responsible person has approved each priority placement.

Completing the checklist is a review aid, not proof that every issue has been resolved. The final decision should be based on actual test evidence and the severity of any outstanding problems.

What happens if one placement fails?

You don't necessarily have to cancel your entire BFCM campaign because a single low-priority placement has an issue.

Instead, assess whether the affected page can be excluded from the campaign while other placements operate normally.

For example, if your primary landing page passes every required test but one partner article has a broken component, you may be able to launch the verified landing page while keeping the partner placement out of your promotions.

The important rule is to avoid sending customers into a buying flow you already know is broken.

Common Shopify Product Embed Testing Mistakes

Even with a QA process, merchants can overlook a few things that make their results less reliable.

Testing only the component preview

An embed might function correctly in the app dashboard but behave differently on a published WordPress or partner website. Always test the actual page customers will visit.

Testing only successful purchases

A product may work with its default variant and quantity but fail when customers choose another option. Include realistic scenarios such as changing variants, increasing quantities, and handling unavailable items.

Closing bugs without retesting

A developer marking an issue as fixed doesn't prove the customer experience is correct. Run the original test again and update its result.

Using the same test result for every partner

Different publishing platforms and website configurations can affect how an embed behaves. Verify each important partner placement separately.

Forgetting to restore payment settings

Shopify warns that enabling payment test mode can interfere with real customer purchases. Make restoring the correct payment configuration part of your testing completion process.

These mistakes are easier to avoid when your test matrix includes clear expected results, assigned owners, and a record of the most recent test.

How EmbedUp Fits Into Shopify Product Embed Testing

If you're using EmbedUp to sell Shopify products on external websites, you can use its component configuration and analytics alongside your QA spreadsheet.

EmbedUp supports embeddable Shopify product experiences on compatible external websites that allow the required custom HTML or scripts. Its documented capabilities include product and variant synchronization, configurable purchase actions, and component-level tracking.

For example, a merchant running a BFCM gift campaign can use EmbedUp to configure the product component, choose its purchase behavior, and place it within a WordPress gift guide or partner article.

During testing, the merchant can compare the saved component settings against the experience on the published page. Where the relevant analytics capabilities are available, they can also review recorded interactions and attribution.

For partner campaigns, EmbedUp's affiliate workflow supports assigning affiliates to components and reviewing attributed performance. However, commission payouts are managed outside the app.

EmbedUp helps with embedding and selling Shopify products, but the QA process should still include the surrounding website content, browser behavior, checkout configuration, and promotional messaging.

If you're preparing a new placement rather than testing an existing one, the broader external product placement readiness checklist covers the preparation work that comes before this QA workflow.

Frequently Asked Questions

What is Shopify product embed testing?
Shopify product embed testing is the process of checking whether Shopify products displayed on external websites work as expected. It involves running defined tests for product interactions, purchase behavior, mobile usability, and relevant tracking, then comparing actual results with expected outcomes.
How do I test an embedded Shopify product before BFCM?
Start by opening the published external page. Run specific tests for product selection, quantities, purchase actions, and checkout. Record each result in a QA matrix, fix any failures, and retest the affected functions before approving the placement.
Start by opening the published external page. Run specific tests for product selection, quantities, purchase actions, and checkout. Record each result in a QA matrix, fix any failures, and retest the affected functions before approving the placement.
Yes. Shopify supports simulated transactions through its Test payment gateway and eligible payment test modes. However, test mode can prevent normal live purchases, so it should be used only in an appropriate, controlled testing setup.
How many Shopify product embed test cases should I create?
There is no fixed number. Create enough test cases to cover the important functions of each placement. A simple single-product embed may need fewer scenarios than a multi-product component with multiple variants, quantities, and affiliate tracking.
Should I test every external website separately?
Yes, at least for your important campaign placements. Even when websites display the same Shopify product, their publishing systems, scripts, layouts, and configurations may differ. Use risk-based priorities to determine how thoroughly each page needs to be tested.
When should I stop testing Shopify product embeds?
You can approve a placement when its required tests pass, critical issues are resolved, and the responsible person accepts any remaining low-risk problems. Repeat relevant tests when important changes occur, especially before directing significant BFCM traffic to a page.

Final Thoughts: Test the Buying Experience, Not Just the Embed

Your BFCM product placements are only useful when customers can interact with them and complete their purchases correctly.

A structured Shopify product embed testing workflow helps you catch errors before they affect customers. Start by recording your external placements, build a test matrix, verify the buying journey, and document every issue that needs attention.

You don't need an elaborate testing system to do this well. A shared spreadsheet, clear test scenarios, and consistent retesting can give your team a practical way to manage multiple websites and partners.

Before launching your BFCM promotions, make sure every important placement has been tested on its published page and that any purchase-blocking issues are resolved. That preparation helps you send campaign traffic to buying experiences you have actually verified.

  • shopify embed bfcm
  • shopify bfcm
  • Shopify product embed testing
  • Shopify embed QA checklist

Related articles

  • How to Make a Shoppable Holiday Gift Guide Readers Can Buy From
    Embed Shopify Products

    How to Make a Shoppable Holiday Gift Guide Readers Can Buy From

    Last checked: 2 November 2026, against the EmbedUp App Store listing, embedup.com, ShipStation's 2026 holiday shipping deadlines, and the NRF 2026 holiday forecast. Who this is for: Shopify merchants, bloggers, and content teams who publish a holiday gift guide on a blog or website. Reading time: about 16 minutes.

    17 min read

  • What to Do With External Product Placements After BFCM
    BFCM Planning

    What to Do With External Product Placements After BFCM

    Your BFCM campaign may be over, but the product placements across blogs, affiliates, and partner websites are still live. Learn how to decide which placements to keep, update, or remove, including those on websites you don't control.

    15 min read

  • Shopify product embeds during BFCM - Feature image
    Embed Shopify Products

    How to Handle Sold-Out Shopify Products Across External Websites During BFCM

    When popular Shopify products sell out during BFCM, merchants need to respond across every external website promoting them. This guide explains how to handle unavailable variants, update embedded product placements, choose suitable alternatives, use collection embeds, and keep external campaigns useful as product availability changes.

    18 min read