Skip to content

Free shipping#1101

Open
MaciekVoucherify wants to merge 2 commits into
masterfrom
MK-free-shipping
Open

Free shipping#1101
MaciekVoucherify wants to merge 2 commits into
masterfrom
MK-free-shipping

Conversation

@MaciekVoucherify

Copy link
Copy Markdown
Collaborator

No description provided.

@MaciekVoucherify MaciekVoucherify self-assigned this Feb 10, 2026
@MaciekVoucherify MaciekVoucherify added Documentation Improvements or additions to the documentation DO NOT MERGE Documentation-team Managed by the Documentation team Articles Changes to articles or new article labels Feb 10, 2026

@p-woznikowski p-woznikowski left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Generally fine, but the structure could be improved to make it simpler.

Comment thread documentation/build/free-shipping.mdx Outdated
Comment on lines +12 to +18
## Prerequisites

Before you start, make sure that:

- You have access to a Voucherify account.
- Your store sends products and shipping as separate cart items to Voucherify.
- Voucherify can recognize your products, either from the Products catalog or from product IDs sent in the API request.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Change to an <Info> callout.

Comment thread documentation/build/free-shipping.mdx Outdated

Before you start, make sure that:

- You have access to a Voucherify account.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Duh? Delete this 😅

Comment thread documentation/build/free-shipping.mdx Outdated

## Prepare your items

Before creating the campaign, make sure Voucherify can recognize both products and shipping.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Minor: Repetition.

Comment thread documentation/build/free-shipping.mdx Outdated
Comment on lines +20 to +40
## Prepare your items

Before creating the campaign, make sure Voucherify can recognize both products and shipping.

<Steps>
<Step title="Open the products tab">
Go to the **Products** tab in Voucherify.
</Step>

<Step title="Make sure shipping is a separate line item">
Make sure shipping is sent as a separate cart item that Voucherify can recognize (for example, an item named *Shipping* or a dedicated shipping item ID).
</Step>

<Step title="Assign products to a collection">
Make sure your products belong to a product collection so they can be discounted (for example, **All Products**).
</Step>

<Step title="Exclude shipping from discounted collections">
Make sure the shipping item is **not included** in the discounted product collection.
</Step>
</Steps>

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This can be shortened; it doesn't have to be a procedure. Shorten it, link to other new resources, and add it all to the Prerequisites callout.

Comment thread documentation/build/free-shipping.mdx Outdated
</Step>
</Steps>

You do not need to import your full product catalog. You can also pass product IDs as metadata in API calls.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This also to the prerequisites.

Comment thread documentation/build/free-shipping.mdx Outdated

You do not need to import your full product catalog. You can also pass product IDs as metadata in API calls.

## Launch the campaign

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please redo these procedures here and in ## Configure free shipping and item discount.

This can be simpler, because we have other articles to fall back to.

First step points to what you have in ## Launch the campaign. Roll all the three steps into one. Briefly describe what you can do there and direct people who need more info to the proper builder articles.

Remember that this whole case needs to cover also cart promos, so it has to be kinda agnostic in this regard. Adjust accordingly other sections above and below.

Remember that people who read this tutorial most likely know a thing or two about configuring campaigns, they just want to know how to configure this particular scenario, so we don't have to tell them in great details how to configure code or time frame.

Comment thread documentation/build/free-shipping.mdx Outdated
Comment on lines +130 to +140
## Alternatives

This setup can also be used in other campaign types:

- **Cart promotion**
The discount is applied automatically when conditions are met. No codes are generated.

- **Unique codes campaign**
Codes are generated in bulk and assigned to customers using the Distribution or Publish API.

Both options support dynamic discounts and similar price rules. No newline at end of file

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just mention it above in the intro. No need for another section.

When customers apply the coupon at checkout, they will receive **free shipping** and a **5% item discount** at the same time.
</Step>
</Steps>

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

As the last section, add ## Related features. Mention especially validation rules. Think of other features that can be combined here or ask the Agent to suggest something.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Articles Changes to articles or new article DO NOT MERGE Documentation Improvements or additions to the documentation Documentation-team Managed by the Documentation team

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants