Text Step

Text steps are used in workflows to add text to a user’s design. You can have as many text steps as you like in a workflow, these steps are very configurable. Text steps allow the customer to be able to type, choose a font, choose a color, and more.

Here is an example of how a text step appears in our Beeline Theme.

Screen Shot 2022 11 17 at 2.45.16 pm


When setting up text steps there is a range of configurations you can set, such as:

  • Size
  • Color selection
  • Set max width
  • Set max/min characters
  • Set case
  • Default text
  • Replaceable text
  • Vertical text
  • Font library
  • Alignment
  • Justification
  • Delete default on focus
Screen Shot 2022 11 17 at 2.46.29 pm

Setting up a Text Step

As with all steps, you must be logged into the SpiffHub and be in a workflow to get started on setting your step up. You can find Workflows underneath the Content tab.

Screen Shot 2022 11 17 at 2.43.39 pm

Note: You can also log straight into a workflow through the product if it is already linked. To do this, go to the edit product page, and in the first cards (Workflows) click on the three dots to the right of the workflow name in the list displayed.

Screen Shot 2022 11 17 at 2.48.29 pm

In the Workflow

  • Once you are in a Workflow, to add a new text step you click the ‘Add Step’ button at the bottom of a scene and then select the ‘Text Step”
Screen Shot 2022 11 17 at 2.58.58 pm
  • Fill out all relevant configurations in the Config tab
Screen Shot 2022 11 17 at 2.46.29 pm 1
  • Now you have set all your configurations it’s time to add your fonts. Navigate to the Options tab, it is the one under the Config tab you are currently on. Here you can manually add fonts from your Assets or choose from existing shared Option.

How it looks when adding new Assets. You can name your Varients and set a price. When you have multiple Varients you can also reorder them and set a default.

Screen Shot 2022 11 17 at 3.37.18 pm

How it looks adding an existing Option. These are set up in Options under the Content tab.

Screen Shot 2022 11 17 at 3.37.34 pm 1
  • Lastly, you need to set your Regions before the text step will work.
Screen Shot 2022 11 17 at 3.53.42 pm

Once you’ve done this, save your Workflow and check it out!

Screen Shot 2022 11 17 at 3.55.52 pm

Config in Detail

Default Text

The default text feature allows you to set the text that will appear when your customer first opens the workflow experience. This feature is commonly used to either guide the customer through recommended messages such as: “Happy Birthday”, or as a placeholder so that the model does not look blank when it is first viewed by the customer.

Screen Shot 2022 11 17 at 4.32.56 pm

Replaceable Text

The replaceable text can be used so that customers can only edit a component of the default text. For example, as the merchant we can set the default text to say “From the Spiff Family” but the only text that we want the customer to edit is the “Spiff” component so that the customer can write in their own family name without changing the surrounding text.

To do this, set the default text to the changeable element, which in this case is “Spiff”. Within the replaceable text field write “From the {{}} Family”.

Screen Shot 2022 11 17 at 4.34.41 pm

Edit All

You can allow further configuration of the replaceable text step by ticking the ‘edit all’ box. This means that customers can edit all the replaceable text if they want to change more than just the text within the ‘{{}}’ field. When customers select the ‘edit all’ box they will then be able to change the whole text.

The ‘edit all’ feature is best used in conjunction with replaceable text in a situation where you want to guide the customer through your customization experience promptly by allowing them to change a few words within a broader sentence. However, by selecting the ‘edit all’ feature, they can still have ultimate control of the text if they wish.

Screen Shot 2022 11 17 at 4.40.58 pm

Max Length

The max length configuration allows you to set the maximum number of characters that customers can type within the text step. The character limit includes special characters and spaces. Customers will see a certain number of characters remaining underneath the text field.

The below image shows what the client sees when they type in their message.

Screen Shot 2022 11 17 at 4.42.07 pm

Variable Font Size

Within the text step configuration, as the merchant, you have the option to control if the font resizes automatically depending on the number of characters the customer inputs or whether the font size stays the same regardless.

The font size is set in points, like any design program such as Adobe Illustrator and Photoshop.

Screen Shot 2022 11 18 at 10.06.29 am

When variable font size is toggled you will be presented with maximum and minimum limits. The maximum means the customer has only inputted one letter, and this is the largest font size will be. The minimum limit, conversely, is the smallest the font size will go. When the variable font size is not toggled you can set a font size, in points, that the text will remain as regardless of the number of characters that the customer has inputted.

Screen Shot 2022 11 18 at 10.07.26 am

It is important to ensure that the region height and width size can accommodate the font sizes set in the workflow back-end. For example, if you have set the font size to remain 12 points, the region height needs to be at least 13 to account for padding within the font file. If the region height or width is not respected, the customer will receive a warning message saying: “Text does not fit in one or more textboxes.” and will not be able to type any further characters.

Default Color

The default color feature allows you to set the color that the text step loads in. To set a default color, you need to add an Option. You can either choose from an existing Option. Or create a new one.

Screen Shot 2022 11 18 at 10.11.42 am

If you have chosen to add a new Option, you then add varients. You can name your varients, reorder, set defaults and most importantly choose your color.

Screen Shot 2022 11 18 at 10.12.52 am

Color Picker

If you want to give customers the choice of changing the color of their text, you can tick the ‘enable color picker’ box. This will allow any colors you have set in your Option to display in the workflow. You can add any colors you want.

Screen Shot 2022 11 18 at 10.18.45 am

Delete Default on Focus

The delete default on focus feature will remove the default text when a customer clicks on the text step. When this feature is turned off, the customer will be required to manually delete the default text to write their own text.

Screen Shot 2022 11 18 at 10.20.34 am

Allow New Lines

The allow newlines feature enables customers to type across multiple lines of text by pressing enter on their workflow.

Screen Shot 2022 11 18 at 10.23.47 am

Enforce Uppercase

Enforcing uppercase means that text will always be typed in caps lock no matter what font is used.

Screen Shot 2022 11 18 at 10.36.21 am

Vertical Text

The vertical text configuration makes the customer’s text written vertically as opposed to the default horizontal.

Screen Shot 2022 11 18 at 10.37.58 am

Text Justification

You are able to justify your text in three ways. Left, center, or right. This means that the text will start typing from the justification you choose.

Screen Shot 2022 11 18 at 10.39.31 am

Vertical Alignment

You are able to align your text vertically in three ways. Top, middle, and bottom. This will decide where the text is placed in your Region.

Screen Shot 2022 11 18 at 10.41.51 am

Multi Languages

The Spiff3D platform supports all languages and characters.

If you are receiving the following message: “This character is not compatible with the current font” this is due to the current font not supporting the character or accent. To ensure this does not happen to your customers, you must upload into the Spiff3D platform any TTF or OTF which supports those characters and use those in the workflow builder.

Curved or Rounded Text

Curved and round text is supported in the Spiff platform but is currently a feature only available in the Spiff backend.

To create a curved text option for your products please reach out to support@spiff.com.au

Screen Shot 2022 11 18 at 10.46.31 am

Home » Documents » Content » Workflows » Step Types » Text Step