---
title: 'Include Cutting Instructions'
---
To include cutting instructions with your part, use the [annotations plugin](/reference/plugins/annotations) (included by default via [core-plugins](/reference/plugins/core)) to add the `cutlist.addCut` method to your part's [`store`](/reference/api/store/extend).
:::tip
The [grainline macro](/reference/macros/grainline) and the [cutonfold
macro](/reference/macros/cutonfold) will automatically add grain and fold
information to the cutting instructions
:::
:::tip
These cutting instructions get used by the [title
macro](/reference/macros/title), so be sure to add them before adding your
part's title.
:::
:::note
<details>
<summary>addCut() Parameters</summary>
Pass an object to the `store.cutlist.addCut` method with any of the following keys; any you don't provide will be filled with the defaults:
| Key | Type | Default | Description |
| :----------- | :------------ | :------- | :--------------------------------------------------------------------------------------------------------------------------------- |
| cut | Number\|false | 2 | the number of pieces to cut from the specified material. Pass `false` to clear all cutting instructions for the material |
| material | String | 'fabric' | the translation key of the material to cut from |
| identical | Boolean | false | should even numbers of pieces be cut in the same direction? false for mirrored |
| bias | Boolean | false | should the pieces in these cutting instructions be cut on the bias? 'false' uses grainline instruction or leaves orientation as is |
| ignoreOnFold | Boolean | false | should these cutting instructions ignore any cutOnFold information set by the part |
You can use any `string` you want for your material, but here are some standard ones we have translation for
| Key | Translation |
| :---------- | :-------------------------- |
| fabric | Main Fabric |
| lining | Lining |
| canvas | Canvas |
| lmhCanavas | Light to Medium Hair Canvas |
| heavyCanvas | Heavyweight Hair Canvas |
| interfacing | Interfacing |
| plastic | Plastic |
| ribbing | Ribbing |
</details>
:::
## Basic Usage
For simple cutting instructions, you can rely on the default method parameters
```js
const part = {
name: 'example.front',
draft: ({ part, store }) => {
// add instructions to cut two mirrored from main fabric
store.cutlist.addCut()
},
}
```
## Intermediate Usage
For many designs, you'll want more than just "Cut 2 mirrored from Main Fabric"
### Specifying materials, number of pieces, orientation
You can override the default values to specify different materials, number of pieces to cut, and whether they should be mirrored or identical
```js
const part = {
name: 'example.front',
draft: ({ part, store }) => {
// add instructions to cut three identical from lining
store.cutlist.addCut({ cut: 3, material: 'lining', identical: true })
},
}
```
### Instructions for multiple materials
You can add as many sets of instructions as you need
```js
const part = {
name: 'example.front',
draft: ({ part, store }) => {
// add instructions to cut four mirrored from main fabric
store.cutlist.addCut({ cut: 4 })
// add instructions to cut three identical from lining
store.cutlist.addCut({ cut: 3, material: 'lining', identical: true })
},
}
```
## Advanced usage
### Cut some on the fold, some not
Sometimes you want some pieces cut on the fold and others cut as halves to seam together.
```js
const part = {
name: 'example.front',
draft: ({ part, points, Point, macro, store }) => {
// set the cut on fold line
points.p1 = new Point(0, 0)
points.p2 = new Point(0, 10)
// pieces should be cut on the fold
macro('cutonfold', { from: points.p1, to: points.p2 })
// cut two on the fold
store.cutlist.addCut()
// cut two, not on the fold
store.cutlist.addCut({ cut: 2, ignoreOnFold: true })
},
}
```
### Cut some on the grain, some on the bias
You set the grainline on a piece, but you also need some to be cut on the bias
```js
const part = {
name: 'example.front',
draft: ({ part, points, Point, macro, store }) => {
// set the cut on fold line
points.p1 = new Point(0, 0)
points.p2 = new Point(0, 10)
// the grain runs from p1 to p2
macro('grainline', { from: points.p1, to: points.p2 })
// cut two mirrored on the grain
store.cutlist.addCut()
// cut two mirrored on the bias
store.cutlist.addCut({ cut: 2, bias: true })
},
}
```
