Prepare elements to be used via the API (for Developers)

In your templates, you can define dynamic, and non-dynamic elements. The content of dynamic elements can be changed via parameters attached to your image URL (if you use our URL API), or via the REST API.

Example URL: https://placid.app/u/0lzyc?img=https%3A%2F%2Fplacid.app%2Fyour-image.png&subtitle=Your+Subtitle&title=Your+Title&url=Your+URL

How to define dynamic elements in Placid

Per default, new layers are always set up to be dynamic elements. If your parameter doesn't work, please check your settings by going through these steps:

1) Open Editor

To make an element in your template accessible via the API, you have to open the template in the editor first. Log in on placid.app, and click on the Edit button of your template.

2) Edit the layer

Choose the layer of the element you want to be editable and click on the Pencil-Icon to edit the layer.

3) Set element to dynamic

By default, your element is already set to dynamic, but be sure this option is checked. If you haven't already, give your layer a name. This title is the name of the parameter you can use in your URL now. Please note that this option is only available for text and image elements!

file


Recommended settings for dynamic elements in Placid

If you use our preset designs, we already took care that dynamic elements will not break the image's layout. If you created your template from scratch or added your own elements, there are some things we recommend to do:

Text Elements

For text elements, we would recommend either the textbox settings single line or fit, so longer texts will not break your layout. You can read more about these settings in our guide on how to Add and edit text elements in your template

Also be sure to make the textbox as wide and high as you want the text to flow.

Images

We usually use the background size cover and the horizontal and vertical position center for any background images. This way, your layout will never look broken when the image you fill in has different dimensions. You can read more about these settings in our guide on how to Add and remove images in your template