Skip to main content

Creating custom templates

Content Studio uses templates as the basis for generating content. You can create your own custom templates, in addition to the predefined templates provided.

Why use custom templates?
Link copied!

Custom templates are more configurable than predefined templates when it comes to generating content, allowing you to:

  • Define your own input fields, letting you customize what information you want to pass to the Large Language Model (LLM) in each generation. This allows you to be as detailed and granular as your brand guidelines require.
  • Write your own prompts that tell the LLM how to process your data.
  • Automate content generation at scale using the Content Studio APIs and integrate with other systems.
Brand and tone of voice

In this release, custom templates do not support generating content based on brand or tone of voice.

Who can create custom templates?
Link copied!

Users with organization admin or hub admin permissions can create custom templates with Content Studio. Typically, this will be a content manager who understands prompt writing.

Creating a custom template
Link copied!

Each custom template can be used for generating content manually and programmatically. Just follow a few simple steps to create them:

1. Setup template details
Link copied!

First, help users understand the purpose of the template by giving it a name, description and image. Make it easy for users to find custom templates by placing them in relevant categories.

Set up identifying information about the custom template

2. Build
Link copied!

Consider what information you will need to generate a meaningful output. For example, if you are building a template to generate Product Descriptions, you may add a single-line field for "Product ID", another single-line field for "Product Title", and a table to capture important "Product Attributes".

Build your template by adding components

Build your template using components that give users an easy way to enter or map data from your source of truth.

Since templates can be used either manually or programmatically, you will need to provide a field "Label" and a unique "Field ID" that can be referenced by an API.

:::note

Once you set the field ID, it should not be changed, as this would cause any integrations against your template to break.

:::

3. Instruct
Link copied!

Give the LLM detailed instructions about what you want it to generate with the information you've provided. Be as detailed and prescriptive as you can, while ensuring that you only give instructions relevant to the task you want it to perform.

Consider the following aspects of a well-written prompt:

  • Role - Who is the LLM acting as? For example, ‘You are a copywriter who…

  • Task - What is the LLM tasked with creating? For example, ‘writes concise product descriptions…

  • Style - Who the output should be targeted towards? For example, 'for fashion products to be sold on high end retail websites.

  • Output - What should the output look like? For example, 'Each product description must have an introduction paragraph of between 80 and 100 words, followed by a bulleted List of Product Features.

Write the prompt that instructs the LLM

4. Test and review
Link copied!

You should test that your custom template will reliably produce your desired output with the instructions you've given, by using the "Test template" feature. We recommend testing with a minimum of 5-10 unique data sets (in this case, generating descriptions for multiple different products) and refining your template inputs or instructions as needed.

Test your custom template

The custom template then combines your instructions (set at the template level) and the data provided in your session into a single prompt that gets sent to the LLM to generate your content.

Test your custom template

Continue to refine your prompt instructions until you're satisfied with the generated outputs.

Shortcut

After testing, you can quickly return to your prompt instructions by clicking the "Edit template" button.

Using credits for testing

The number of credits used depends on the complexity of the template — both the number of inputs you set and the length of the Instructions you send. The credit count provided on generation is an estimation of how many credits each generation will cost, but actual credits used can be checked in your Credits usage report.

Limits
Link copied!

The following limits apply to custom templates:

FeaturelimitDescription
Maximum number of custom templates150The maximum number of custom templates per hub
Maximum number of text components per template10The maximum number of text components (Single-line text field, Multi-line text field and Rich text editor) per custom template
Maximum number of image components per template2The maximum number of image components per template. Each image component can contain up to 5 images.

Using templates

Generating content with the Content Studio API