> For the complete documentation index, see [llms.txt](https://help.pixfizz.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.pixfizz.com/personalization/custom-design-tools/business-card-tool-setup-and-activation.md).

# Business Card tool: setup and activation

How to put the Business Card tool live in your store. Everything arrives in one template import — you create nothing. What is left is deciding what you sell and what it costs.

***

### What the tool does

The Business Card tool replaces the ordinary file upload on a business card product with a full artwork workflow:

* The customer uploads a PDF, PNG or JPG for each side.
* The tool checks size, bleed, resolution and page count as soon as the file lands.
* It draws a proof showing exactly where the card will be cut and which areas are trimmed off.
* The customer can drag and resize their artwork on the proof.
* On submit, the tool builds the production PDF at the template's page size and attaches it to the order.

***

### Step 1 — Import the template

Download it here:

[export-template-business-cards.tar.gz](https://1409369501-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDLSaKAH9aauCVHoiuVBl%2Fuploads%2F8VX84XH3w6NGiIlweIxp%2Fexport-template-business-cards.tar.gz?alt=media\&token=d33079cf-1e4c-4f18-b2c0-4558daa138ad)

Import it as-is at **Admin > Products > Templates > Import**. Do not unpack it. That is the whole installation.

The import brings the template, the page size, the product, the design, all seven template options and the tool's own settings. **You do not create anything, upload anything, or paste anything.** Everything the tool needs is already in the file.

It gives you two products, a single-sided and a double-sided card, both 3.5 x 2 in.

**Once a template is live, never delete and re-import it to change something.** Edit the fields on the product instead. A re-import is only for a major structural change, and it is not how you adjust a price, a paper or a size.

***

### Step 2 — Set your prices

Open the **Product Attribute** for each card and look at the **Price** field. It holds a per-unit price ladder:

```ruby
{1..99=>0.20, 100..249=>0.18, 250..499=>0.14, 500..999=>0.10, 1000..10000=>0.08}.find { |range, unit_price| range.include?(quantity) }.last
```

Read it as: 1 to 99 cards cost 0.20 **each**, 100 to 249 cost 0.18 each, and so on. Replace the numbers with yours and leave the structure alone.

Three rules, and breaking any of them is worse than a wrong price:

* **The figure is per unit, not the total.** The platform multiplies by the quantity itself. Enter a total and the order is billed the quantity twice over.
* **The ranges must cover every quantity you sell, with no gaps.** They must start at or below your minimum and the last one must reach your maximum. If a customer picks a quantity no range contains, the price is not wrong — **the product page breaks**.
* **Keep it simple.** This style of ladder is reliable. Clever Ruby in a price field is not.

{% hint style="warning" %}
The commonest mistake is a top range that stops one short of the maximum — ranges ending at `9999` while **Quantity** allows `10000`. Nothing warns you, and the fault only appears when a customer picks that exact quantity.
{% endhint %}

***

### Step 3 — Set the quantity ladder

Still on the **Product Attribute**, three fields decide every quantity a customer can pick:

| Field                    | What it does                           | Example |
| ------------------------ | -------------------------------------- | ------- |
| **Quantity**, first box  | The smallest order you accept          | `100`   |
| **Quantity**, second box | The largest                            | `2000`  |
| **Quantity Intervals**   | The step from one quantity to the next | `250`   |

Those three produce the quantity dropdown on the product page, and **the tool mirrors that dropdown exactly** — the quantity chips inside the tool are the same list. It invents nothing and it cannot offer a quantity the product does not sell.

**Keep the list short.** This is the setting most often left too fine, and it is the one that most affects how the tool feels:

* `100` to `2000` in steps of `250` gives **eight** quantities. Clean, scannable, one tap.
* `50` to `10000` in steps of `50` gives **two hundred**. The tool has to draw two hundred chips and price every one of them, and the customer has to find theirs in the list.

Match the intervals to your **price** ladder. If your price only changes at 100, 250, 500 and 1000, offering a choice every 50 presents dozens of options that make no difference to what anyone pays.

***

### Step 4 — Set your papers, shapes and corners

Each card carries four variants. These are the shopper's choices, not tool settings, and they stay on the product because they carry price.

| Variant      | What it offers                     | Typically priced         |
| ------------ | ---------------------------------- | ------------------------ |
| `bc_stock`   | Your paper stocks                  | Yes, one price per paper |
| `bc_shape`   | Rectangle, Leaf                    | Leaf costs more          |
| `bc_corners` | Square, Rounded 1/8", Rounded 1/4" | Rounded costs more       |
| `bc_sides`   | `1`, `2`                           | Usually                  |

**Paper stock.** The import ships example papers. Replace them with the ones you actually sell: edit the values on the `bc_stock` variant, and put each paper's surcharge on that **value's** price field, not on the variant and not on the product.

Name each paper the way a customer would read it, and **keep the weight in the name** — `Linen 110#`, `Silk 120#`. The tool reads the weight out of the label to thicken the card in the 3D preview, so a paper with no weight in its name previews at the default thickness.

**Turning a die cut off.** Remove the value from the variant. The tool hides a row entirely when only one value is left:

* Delete `Leaf` from `bc_shape` and the shape row disappears. Every card is rectangular.
* Leave only `Square` on `bc_corners` and the corners row disappears.
* Leave two or more values and the row appears, with the price difference shown against each.

There is no on/off switch. **The values you offer are the setting.** A variant with one value would render as a single choice that cannot be changed, which reads as a broken control, so the tool removes it instead.

Changing paper inside the tool moves the price on the page, and changing it on the page updates the tool. One ladder, one owner.

***

### Step 5 — Change a setting, if you need to

The tool's settings arrive filled in on the template, and a standard 3.5 x 2 in card needs none of them touched.

You only open them to change something — a different card size, a metric store, turning the 3D preview off. They live in one place: the **custom\_script** field on the `bc_artwork_front` template option, as a list of arguments.

```liquid
{% snippet 'product/business-card',
	bc_sides: '1',
	bc_trim_w: '3.5in',
	bc_trim_h: '2in',
	bc_bleed: '0.125in' %}
```

Every setting, its accepted values and its default are in [Business Card tool: configuration reference](https://help.pixfizz.com/personalization/custom-design-tools/business-card-tool-setup-and-activation/business-card-tool-configuration-reference.md).

**Always write the unit on a size.** `'3.5in'`, not `3.5`. A bare number is read in the store's display unit, so on a millimetre store a bare `3.5` makes the card three and a half millimetres wide.

***

### Step 6 — Ask us to switch on production delivery

The tool builds the print file and attaches it to the order, but **your production destination needs one setting from us before that file is delivered.** It is a one-off, it is the same on every store, and it is not something you can do from admin.

Tell your Pixfizz contact you have installed the Business Card tool and we will set it up. Until then the order is complete and correct in admin, but production receives nothing.

***

### How to check it worked

Run through the tool once on the live product page:

1. Upload a PDF. The proof draws and the artwork check appears.
2. Upload a wrong-size photo. It should fill the card with no white edges.
3. Check the quantity chips match the dropdown on the page, and that the price moves when you change quantity or paper.
4. Tick the acknowledgement, then **Review & Continue**, then **Add to Cart**. It must go to the cart.
5. Check the cart line shows a preview thumbnail.
6. Place one real order and confirm production receives the PDF. Nothing short of a real order proves step 6 above.

***

### If something is wrong

**Add to Cart says "Design Now" and opens the editor.** A template import can write a design's boolean fields as the text `false` rather than a real boolean, and in Liquid the text `false` reads as true. The checkbox looks unticked either way. Fix it on the **design**: tick `only_design_now`, save, untick, save. That rewrites it properly. Do the same for `disable_required_form`.

**The product page errors when a particular quantity is picked.** Your price ladder has a gap at that quantity. See step 2.

**A paper, shape or corner row is missing from the tool.** That variant has fewer than two values. See step 4.

**A setting you changed had no effect.** Load the product page and inspect `<div id="bc-root">`. Every setting is echoed there as a `data-` attribute with a matching `-source` attribute saying where it came from: `mount_arg` means your mount passed it, `default` means it did not. Anything the mount missed is listed in `data-config-missing`.

`data-product-seen` and `data-design-seen` both read **false**. That is expected and correct. Do not chase it.

***

### Related

* [Business Card tool: configuration reference](https://help.pixfizz.com/personalization/custom-design-tools/business-card-tool-setup-and-activation/business-card-tool-configuration-reference.md)
