---
title: "Copyfitting"
canonical: https://customerscanvas.com/docs/cc6/copyfitting.htm
archived: true
applies_to:
  - product: "Customer's Canvas On-Premises"
  - product: "Design Editor"
    versions: ["6.15.0", "6.x (may differ)"]
---

**You’re viewing outdated documentation.** [View the latest Customer’s Canvas On-Premises documentation](https://customerscanvas.com/docs/on-premises/).

# Copyfitting

**Applies to:** Customer's Canvas On-Premises; Design Editor 6.15.0, 6.x (may differ) · **Archived documentation**
 
When creating a template, you have to keep in mind that users may enter text of different lengths while personalizing it. If text will overflow the specified text area, the original design may be ruined. In this case, your users should either change the size of the text area or decrease the font size themselves. Also, you can [limit the character number](https://customerscanvas.com/docs/cc6/text-elements-in-cc.htm.md) allowed for typing in this text element. In some cases, you can use [text on a curve](https://customerscanvas.com/docs/cc6/curved-text.htm.md) to autofit the font size.
 
Alternatively, Customer's Canvas provides copyfitting to keep the size of the original text area unchanged, regardless of user input.
 
## Configuring Copyfitting in Templates
  
To enable this feature, you can apply the [&lt;TOS&gt;](https://customerscanvas.com/docs/cc6/supported-markers.htm.md) and [&lt;TSM&gt;](https://customerscanvas.com/docs/cc6/supported-markers.htm.md) markers to paragraph text layers in Photoshop and InDesign templates. The `<TOS>` marker defines how text appears on the canvas when it goes out of its bounding rectangle. Customer's Canvas can either cut such text or fit it to its bounds. The second marker defines how to resize the overflowing text.
 
**Note** 
Both these markers work for paragraph text and do not affect point text.
 
`<TOS_fitToBox>` and `<TOS_fitToWidth>` ignore rich text formatting, despite the [&lt;RT_true&gt;](https://customerscanvas.com/docs/cc6/supported-markers.htm.md) marker.
 
### Text Overflow Strategies
 
*TOS* stands for a *text overflow strategy*. Customer's Canvas supports the following strategies:
 
- **Clip** 
    Crops text that goes out of the text region. This is the default behavior that occurs if you have not specified a **TOS** for a text element. To validate that bounded text is not cropped, you can enable corresponding warnings in the user interface through the [violationWarningsSettings.textCropViolationWarningEnabled](https://customerscanvas.com/docs/cc6/preflight-check.htm.md) property.
 
    ![The Clip mode.](https://customerscanvas.com/docs/cc6/images/CopyfittingClip.png)
- **ExpandBox** 
    Expands the bottom bound of the original text area when the text goes out of this area. After that, if you erase the text, the bounding rectangle remains expanded.
- **FitToWidth** 
    Downsizes text to fit the bounding rectangle's width. The text moves to a new line only when the user presses Enter. The following image illustrates how this option looks in the editor.
 
    ![The Fit-to-Width mode.](https://customerscanvas.com/docs/cc6/images/CopyfittingFitToWidth.png)
- **FitToBox** 
    Moves text to the next line when the end of the current line is reached, and starts to downsize the text only when the bottom of the bounding rectangle is reached.
 
    ![The Fit-to-Box mode.](https://customerscanvas.com/docs/cc6/images/CopyfittingFitToBox.png)

To enable a strategy, pass it as a marker parameter to a text layer name. In the following example, **Full Name** is the paragraph text layer, and the `<TOS_FitToWidth>` marker enables the **FitToWidth** strategy.
 
![Enabling the text autofit in a PSD template.](https://customerscanvas.com/docs/cc6/images/CopyfittingPsd.png)
 
### Shrink Modes
 
In addition to a strategy, you can specify in what way Customer's Canvas downsizes text that goes out of its bounds. There are two options:
 
- **Size** 
    Changes the font size. This is the default shrink mode.
 
    ![The Size shrink mode.](https://customerscanvas.com/docs/cc6/images/CopyfittingFitToWidth.png)
- **Scale** 
    Disproportionally shrinks text in width:
 
    ![The horizontal shrink.](https://customerscanvas.com/docs/cc6/images/CopyfittingShrinkH.png)
 
    or height:
 
    ![The vertical shrink.](https://customerscanvas.com/docs/cc6/images/CopyfittingShrinkV.png)

To specify a shrink mode, you can pass it as a parameter of the `<TSM>` marker, for example `<TSM_Scale>`.
 
**Note** 
The **Scale** mode is incompatible with the **FitToBox** strategy. In this mode, Customer's Canvas automatically uses the **FitToWidth** strategy.
 
## Configuring Autofit for New Items
  
Your users can add new text elements to the canvas as well as open pre-designed templates. To enable copyfitting for new text elements, you can specify the overflow strategy and shrink mode through the **defaultItemsConfig** object of `clientConfig.json`. Also, you need to enable the **Add bounded text** button in the **Toolbox**.
 
```
{
    "defaultItemsConfig": {
        "text": {
            "overflowStrategy": "FitToWidth",
            "textShrinkMode": "Scale"
        }
    },
    "widgets": {
        "Toolbox": {
            "buttons": [ "Text", "BoundedText", "Image" ]
        }
    }
}
```
 
For more details about default item configuration, you can refer to the [Default Parameters of Design Elements](https://customerscanvas.com/docs/cc6/default-parameters-of-design-elements.htm.md) topic.
 
## See Also
  
### Manual
 
- [Text Elements in Customer's Canvas](https://customerscanvas.com/docs/cc6/text-elements-in-cc.htm.md)
- [Supported Markers](https://customerscanvas.com/docs/cc6/supported-markers.htm.md)
- [The Preflight Check](https://customerscanvas.com/docs/cc6/preflight-check.htm.md)
- [Default Parameters of Design Elements](https://customerscanvas.com/docs/cc6/default-parameters-of-design-elements.htm.md)
- [Curved Text](https://customerscanvas.com/docs/cc6/curved-text.htm.md)

### Downloads
 
- [PSD sample](https://customerscanvas.com/docs/cc6/samples/rich-text.psd)