Skip to main content

Text Listing Customizer

The Text Listing Customizer (also called the Canvas) lets your customers personalize a product right on your storefront: they type their text, pick fonts and colors from the palette you define, and see a live preview. When they check out, Printago receives their exact design with the order and prints it in the colors they chose, automatically.

The customizer is an addon. Enable it from the Addons page, then open Customizer in the sidebar to get started.

How it fits together​

  1. You create a configuration: the product's shape (a background mask), the fonts customers can use, and the color palette. Colors can be imported straight from the filaments assigned to your SKU, so every color a customer picks is one you can actually print.
  2. You pair the configuration with one of your SKUs and publish it to your Shopify store (see below).
  3. A customer designs their text on your product page and adds it to the cart. Their design is saved to Printago and travels with the Shopify order.
  4. When the order syncs, Printago builds the part with the customer's design and assigns the matching filaments to the print job. Colors the customer picked map to the filaments you linked in the palette, and objects that share a color are grouped onto one filament slot.

Publishing to Shopify​

Open a configuration and find the Shopify publishing section. You need a connected Shopify store and a SKU paired with the configuration.

There are two ways to put the customizer in front of customers, and you can choose per configuration:

Embed on your product page​

Best when you already have a product listing. Printago finds your Shopify product by its SKU, links it to the customizer (nothing about your listing is changed: title, images, price, and description all stay exactly as they are), and gives you an Open theme editor button. The theme editor opens with the Printago customizer block already added to your product template; click Save and the customizer appears on the product page in place of the standard add-to-cart form.

Standalone customizer page​

Best when you want a dedicated design page. Publishing gives you a link (like https://your-store.myshopify.com/apps/printago/customizer/...) that renders the customizer as its own page inside your store's theme, with your header and footer. Link to it from your navigation, a product description, or marketing campaigns.

note

The first time you publish, Shopify may ask you to re-approve the Printago app so it can link products. If you see a message about reconnecting Shopify, open your Shopify integration settings and approve the updated permissions, then publish again.

To take a configuration down, use Unpublish. Your product listing is left untouched.

Colors and filaments​

Each color in a configuration's palette can be linked to one of your filaments. Use Import from SKU in the palette editor to pull in the colors of the filaments already assigned to the SKU's parts; that link is what lets Printago pick the right filament at print time.

If an order comes in with a color that can't be matched to a filament (for example, the palette entry was removed after the customer ordered), the print job is still created and the queue shows the color with a "no material assigned" marker so you can assign a filament by hand.

The part behind the customizer​

The printed part is an OpenSCAD (or Build123d) part like any other in Printago, with one convention: the script imports the customer's design layers by fixed file names and reads a few variables Printago provides. A ready-made example is available in the sample files as Canvas Customizer Sample.scad, and it works out of the box for flat products like plates and frames:

  • background.svg is your configuration's product mask, extruded as the base plate.
  • layer_0.svg, layer_1.svg, … are the customer's text and shapes, in paint order; outline_0.svg, … are their optional outlines.
  • num_layers, layer_color_indices, and outline_color_indices tell the script how many layers to import and which palette color each one uses.

You can start from the sample and change heights, add features, or reshape the base. The placeholder colors in the script never appear on the print; they only mark which geometry belongs to which filament slot.