Dynamic fields

Dynamic fields are the parts of a template that change from one render to the next. A single template with dynamic fields for name, title, and avatar produces a personalized image for every person in a list, without touching the design again.

How they workHow they work

When you mark a component as dynamic, it gets a field name (like title or photo). Everything else in the template stays locked. At render time you supply values for those fields, and Imejis draws them into the design in the exact position and style you set.

• Text fields replace the copy in a text component.
• Image fields swap the source of an image component (a logo, a product shot, an avatar).
• Color and style fields can vary the look per render when you need it.

Where the values come fromWhere the values come from

The same fields can be filled in three ways:

• By hand, through a public link form.
• In bulk, from a spreadsheet or database.
• Programmatically, through the API, where each field is a parameter in your request.

TipsTips

• Keep field names short and descriptive (headline, not text_1).
• Only mark what actually changes. Fewer fields mean a simpler form and a simpler API call.
• Design for the longest realistic value so nothing overflows when the text is long.

Frequently asked questionsFrequently asked questions

What can be a dynamic fieldWhat can be a dynamic field?

Text, image sources, and colors. A text field swaps the copy, an image field swaps a logo or photo, and a color field varies the look per render.

How many dynamic fields can a template haveHow many dynamic fields can a template have?

As many as you need. Keep it to what actually changes, though, so the form and the API call stay simple.

Do i have to fill in every field on every renderDo I have to fill in every field on every render?

No. Any field you don't set keeps its designed default, so you only pass the values that change.