The Dynamic Image API has been developed so that the designer creating mockups or templates to be processed with this API can work in the usual way. Despite this, it does not support 100% of Photoshop's functionality. In this article, you can find out what features can be used for creating mockups or templates in Photoshop.
In general, Dynamic Image works with files created in any modern version of Photoshop. However, from time to time Adobe may introduce significant changes to the PSD file format, and some of the functionality may degrade.
The latest Photoshop version that we have tested Dynamic Image with is Photoshop 2021 (version 22). The oldest one is Photoshop CS6.
If you encounter any problems with PSD files created in newer versions, please contact our support team.
You can create Image Layers, Text Layers, and Shape Layers as well as combine them into Group Layers.
For text elements, you can set all properties on the Character and Paragraph tabs. Dynamic Image can replace text while keeping these settings.
For Shape Layers, you can define the fill and stroke. It supports not only solid fills but also gradients and pattern fills.
In addition to the regular layers, you can create Smart Objects. When you transform such an object using, for example, a warp, distort, or perspective tool, Dynamic Image inserts an image into the Smart Object and applies all these transformations to the new content.
Starting with Photoshop 2020, the Warp tool has been changed. By default, it now has only angular grips and lines, which are the boundaries of the object (the same as the Resize or Scale tool), and internal lines, which are separators that allow you to create a grid inside the object, and can now be added separately. At the moment, Dynamic Image does not support a customized grid, so the Warp tool can only be used with default settings (without internal lines) in the same manner as it worked before Photoshop 2020 (where they were drawn by two horizontal and two vertical lines).
Normally, when content is inserted into a Smart Object, its top left corner will be located in the top left corner of the Smart Object. However, there are some scenarios where you need to shift it within the Smart Object. For example, you may you need to display different parts of a design on a product with a complicated surface, like a canvas or a mug with a 360-degree design.
In such scenarios, you may add another Smart Object inside the placeholder and position it so that the portion of an image you want to make visible appears in the outer Smart Object.
Groups with Alternatives
As noted above, you can use grouped objects for your convenience. However, grouping provides another useful feature: Dynamic Image allows for switching a visible layer inside a Group Layer.
While designing, you may use the eye icon in Photoshop to hide or show these layers for your convenience. Once a developer sends the appropriate command to Dynamic Image, the requested layer will automatically show while the other layers will be hidden.
Such groups may contain not just regular layers but can also be nested and hold other groups and Smart Objects.
Blending Options and Effects
You can apply opacity and blending modes that can be set in the General blending section of the layer settings dialog. For example, you can apply textures or shadows to a layer using the blending mode Multiply.
Not all blending modes are supported at the moment. You can currently use the following modes:
- Color Burn
- Color Dodge
- Hard Light
- Linear Burn
- Soft Light
Only three layer effects are currently supported:
- Color Overlay
- Drop Shadow
Take note that some settings for blending modes may be ignored. For example, a shadow may look a bit different than in Photoshop although the main shadow settings are used.
No other effects are supported at this time.
In order to clip images and Smart Objects, you can use Vector masks. Layer Masks are partially supported - they cannot be applied to Smart Objects.
For example, you can insert a business card layout, which has a bleed zone. You will definitely want to cut this out in the preview. In this case, you can apply a vector mask to perform this.
At this moment, you cannot yet use Clipping masks. Use vector or layer masks instead.
What's Not Supported in Dynamic Image
Adobe has been developing Photoshop for decades, and they invest a lot of money in its functionality. Dynamic Image is not that old so all the features are unfortunately not yet supported. Below are some of the features you shouldn't count on yet.
- Layer effects other than Color Overlay, Drop Shadow, and Stroke
- Advanced blending options
- Adjustment layers
- Smart filters
- Clipping masks
Try to avoid them or, if possible, rasterize them. If any of these features are extremely important to you, please contact us at email@example.com. We will be happy to discuss your use case, and perhaps we could add support for certain features of the PSD format.
Smart Object Content
If you are creating mockups with the Warp or Distort transform, it may be important to see how it will change the image. We recommend preparing some simple technical images for this kind of Smart Objects, for example, a simple grid. It makes sense to mark bleed/trim zones with guidelines as well.
When creating layers, pay attention to their names. While it doesn't make much difference to Dynamic Image how you name your layers, it's important to have a clear and consistent naming system for your layers when developing an application. For example, when making many similar mockups, it makes sense to give the Smart Object where the designs will be inserted the same name in all PSD files.
It is recommended to avoid non-standard characters in the names. For example, a slash may cause problems because developers use the groupName/layerName syntax to refer to layers within a group or smart object.
Choose a Reasonable Size
If you are making a mockup that will be used to produce a small 800px preview, there is no point in saving the PSD in high resolution. The larger the PSD file, the slower image generation will be, so choose a proper size. We recommend sizing up to twice the target image size (for adequate display on Retina screens), and no larger. If you will display it as an 800x800 image, for example, save the PSD file as 1600x1600.
Merge static layers
By creating realistic effects such as shadows and highlights, designers tend to add a lot of items with different settings (blending mode and others). However, having to merge dozens of layers with each request can have a negative impact on performance. So whenever possible, try to merge layers, for example, all shadows into one layer and all highlights into another.
Keep source file separately
The previous tips are aimed at increasing the performance of Dynamic Image. However, we realize that a designer needs a large source file with layers divided into parts. In such a case, we recommend working with a PSD file of the original size with all layers and preparing a separate file for Dynamic Image by using Photoshop macros and scripting to get optimized PSD files.