Skip to content
  • There are no suggestions because the search field is empty.

I've Done Everything Right & My Template Still Doesn't Work

 “It is possible to commit no mistakes and still lose. That is not a weakness; that is templating.” 

Sometimes a template can look like everything has been set up perfectly, but one or two objects still don't work like they're supposed to. This often shows up as:

  • Visuals not inheriting colour
  • Text not rendering at all
  • Text not obeying alignment commands
  • Repeats whose alignment spacing doesn't work only when certain objects are being aligned from/to

Behind the Scenes

These issues can be the result of an Illustrator behaviour that is difficult to notice. Instead of exporting an object as one thing, it will be placed in a group when converted to an SVG. The problem, is that this will not be indicated in Illustrator's UI which makes it difficult to identify. There are two possible causes and solutions. 

1. An "Appearance" Attribute or Transparency Effect is Active

  1. What it is: If the path has an effect (like a warp, stroke tweak, or drop shadow), an opacity shift, or a specific blend mode (like Multiply or Screen) applied to this object Illustrator creates a structural styling wrapper. This wrapper will generate a group when converted to an SVG: breaking the naming convention SignAgent relies on.
  2. The Fix: Select the object which will either be a layer within the visual or the example text within a text field layer. Open the top menu: Object > Expand Appearance. If this option is clickable, click it. It will flatten the procedural wrapper and leave you with a direct, single path that will export cleanly without the group wrapper.

2. It is a "Compound Shape" (Not a Compound Path)

  1. What it is: If you used the Pathfinder panel to unite or intercept shapes, Illustrator often creates a live, non-destructive Compound Shape. Because it is a live system, the standard "Ungroup" tool is greyed out. This shape will generate a group when converted to an SVG: breaking the naming convention SignAgent relies on.
  2. The Fix: Select the object and open the Window > Pathfinder Panel. If the Expand button on the right side of the panel is active, click it. This bakes the live effect down into a standard, raw vector path.