The Protaigé Academy
The Protaigé Academy
/
Protaigé Academy
/Design kits: Set up your PSDs
Design kits: Set up your PSDs
Design kits: Set up your PSDs
Design kits: Set up your PSDs

Design kits: Set up your PSDs

What you'll learn

How to prep your Photoshop files for Protaigé.

Series
3.2
Section
Brand DNA
Last Updated
Feb 4, 2026 9:08 PM
Status
Live
icon
Previous Tutorial
icon
Next Tutorial

TL;DR: Prepping PSDs is all about structure-use correct component names and number sequences to ensure your templates scale.

At Protaigé, a Design Kit isn’t just a folder of static templates—it’s a structured design system. When you prep your PSDs with smart component naming, editable zones, and layout constraints, they become scalable, brand-safe templates that power campaigns across every format.

Think of it like setting up dominoes: if each piece is in the right place, the system ensures your assets stay consistent, flexible, and pixel-perfect. Once built properly, a kit lets marketers scale campaigns effortlessly, while giving designers the creative control they need.

To make this seamless, Protaigé’s PSD importer transforms your Photoshop files into dynamic, editable templates. Label components correctly, and you unlock the full power of the platform.

Looking for a 101 on our design system? → Design kits 101Design kits 101

Looking for information on how to name each component? → Component Name IndexComponent Name Index

Prepping Your PSD in Photoshop

Before you bring your design into Protaigé, it needs to be prepped correctly. Think of it like setting up dominoes—everything has to be in the right spot for it to work perfectly.

image

Structure Your Layers Properly

Naming is everything. Protaigé reads your layer names and maps them into dynamic, editable components. The index of component names can be found at the bottom of this page.

  • Logo Layer: Name it logo
  • Headlines:
    • Main headline → h1
    • Subheadline → h2
  • Body Copy: Use shortcopy medium copy or long copy depending on text length.
  • CTA Button Text: Name them cta
  • Images: Name it simply image. If the image needs to be confined in a mask, group the image and use a shape mask (no clipping masks or flattened images).
  • Graphics & Icons:
    • Decorative graphics → graphic
    • Icons → icon
  • Backgrounds: Use bg and ensure it's a shape layer otherwise it will be imported as an image.

Numbering multiple images

When your design includes a series of similar images—such as speaker headshots, product shots, or event photos—name each image component with a sequential number.

For example: speaker1, speaker2, speaker3 etc.

This ensures Protaigé recognises them as related components.

image
image

If you have associated child assets that focus on an individual speaker (e.g. personalised banners or social posts), the system automatically pulls the right image into the correct slot—without manual relinking.

image

💡 Tip: Always use consistent numbering (speaker1, speaker2, speaker3). Don’t skip numbers or use variations like “speakerA.” Consistent component naming is what enables smooth propagation across assets.

Text Treatment

As long as your brand fonts are uploaded and set in Brand DNA → Fonts, they will render correctly in your templates. Missing fonts will fall back to defaults, which can distort alignment and styling.

image

Use bounding boxes for text

Bounding boxes let Protaigé resize copy dynamically within a preset range. This ensures your headlines, subheads, and body text adapt to different layouts without breaking.

image

Use point text when you want fixed sizes

Point text locks the font size. This is useful when you need absolute consistency—like for legal disclaimers, footnotes, or any text that must not resize dynamically.

💡 Tip: Always upload all weights and styles (regular, bold, italic, etc.) into Brand DNA so your text displays consistently across every output.

Keep It Clean

  • 🗑️ Delete hidden layers: If they’re in the PSD, they’ll get imported.
  • ✅ Use shape fills for backgrounds, image masks, and graphics. Avoid rasterised images for anything you want to edit later.

Index of Component Names

Note: These are not case-sensitive. At some point, these will all be a drop-down selector, but it’s manual for now.

Name
Description of the dynamic component
Type
H1
Your main headline. This is the big, bold line that grabs attention.
Text
H2
A sub-headline that supports the H1 and adds context.
Text
Short Copy
One or two short sentences for quick impact.
Text
Medium Copy
A paragraph or two of copy—enough to explain without overwhelming.
Text
Long Copy
Extended body text for detail-heavy layouts.
Text
CTA
The call-to-action text itself—what you want the user to do.
Text
Offer
Promotional line that highlights a discount, bonus, or incentive.
Text
Speaker
Speaker name(s) for events. Number them if there are multiple (speaker1, speaker2, etc.).
Text
Date
The event or promotional date.
Text
image
The hero image in a banner or layout.
Image
cta-btn
The visual button that holds your CTA. Can be a colour fill or image.
Image / Fill
logo
Your primary brand logo.
Image
bg
The background layer for a banner (colour fill, gradient, or image).
Image / Gradient / Fill
page
This is the default background fill
Fill
graphic
Decorative graphics in your design. If you use more than one, number them (graphic1, graphic2, etc.).
Image
icon
Iconography. Number them if multiple (icon1, icon2, etc.).
Image
photo
Supporting images or photography that aren’t hero shots. Number them if you have more than one.
Image
shape
Shapes that aren’t graphics, icons, or buttons—like colour blocks or starbursts. Number as shape1, shape2, etc.
Shape

⚡ Troubleshooting Common Issues

Problem
Quick Fix
Images Not Editable
Ensure the layer is named image and uses a shape mask.
Text Breaking the Layout
Verify that text bounding boxes are appropriately sized to accommodate varying text lengths. Adjust auto-resize settings if necessary.
Font Not Displaying Correctly
Confirm that all template fonts are uploaded to Brand DNA → Fonts. Missing fonts will default to a fallback, potentially disrupting the design.
Missing Layers After Import
Check for hidden or locked layers in the PSD before importing. Only visible and unlocked layers are processed.
Elements Shifting After Import
Ensure all elements are aligned to grids or guides in Photoshop. Misalignment can cause shifts during import.
Background Imported as Image
Replace image-based backgrounds with shape layers filled with the desired colour. This allows for easier edits and maintains design flexibility.
Image Swapping Issues
Confirm that images intended for swapping are placed within shape masks, not clipping masks or flattened layers. Test by swapping images to ensure they fit correctly within the designated area.
Low-Resolution Image Alerts
Use high-quality images to prevent low-DPI warnings. We can handle images up to 4096x4096 pixels during editing, but higher resolutions can be used during export.
Text Too Close to Edges
Adjust text boxes to ensure content doesn't sit too close to bleed or safety lines, preventing potential cropping issues during printing.
Browser Compatibility Issues
We supports modern browsers. Ensure you're using the latest version of a supported browser.
image
icon
Previous Tutorial
icon
Next Tutorial