Skip to main content

SmartBlock Agent prompt guide

Get better results from SmartBlock Agent with example prompts and tips for refining your designs.

SmartBlock Agent designs your SmartBlocks from the instructions you give it in the chat. The more specific and detailed your prompts are, the closer the first result is to what you want, and the fewer rounds of refinement you need.

Use the examples in this article as a starting point. Each one has a basic prompt, a follow-up to refine the result, and an advanced prompt that includes more detail up front. Copy them, adapt them to your brand and campaign, and keep refining through conversation until you’re happy with the design.

If you’re new to SmartBlock Agent, learn more in SmartBlock Agent overview.

To learn how to open the agent and save your SmartBlock, see Use SmartBlock Agent to create and edit SmartBlocks.


Prompt examples

Create a promotional sale banner

Build a banner for a specific offer or campaign.

  • Example

    Create a full-width homepage banner promoting a 25% off summer sale. Use bright summer colors, bold typography, and a Shop the sale CTA.

  • Refine further
    ​Make the discount more prominent and move the CTA to the right.

  • Advanced example
    ​Create a full-width homepage banner promoting 25% off our summer collection, ending Sunday. Use bright summer colors and bold typography, show the end date under the headline, and add a high-contrast Shop the sale button that stands out on mobile.

Refresh an existing SmartBlock

Update the look of an existing SmartBlock without starting again.

  • Example
    ​Modernize this banner using a cleaner layout and more whitespace while keeping the existing messaging.

  • Refine further
    ​Use a lighter background and reduce the size of the body text.

  • Advanced example
    ​Modernize this banner for our fall season. Keep the existing headline and CTA, replace the summer colors with warm fall tones, and simplify the layout so it works better on small screens.

Create a brand-led banner

Design a SmartBlock that reflects your brand's visual identity.

  • Example
    ​Design a premium banner using our brand colors, navy #1B2A4A and gold #C9A646, with subtle gradients and a luxury visual style.

  • Refine further
    ​Use a serif font for the headline and make the button more understated.

  • Advanced example
    ​Design a premium banner for our new skincare range using our brand colors, navy #1B2A4A and gold #C9A646, and a luxury visual style. Include a short headline, one line of supporting text, a placeholder product image on the right, and a Discover the range CTA.

Personalize your SmartBlock

Add personalized content using any merge codes that are available for your SmartBlock type.

  • Example
    Add the visitor's first name to the headline.

  • Refine further
    If we don't know their name, show Welcome back instead.

  • Advanced example
    Create a welcome-back banner that greets returning visitors by first name and includes a Continue shopping CTA. Use a generic greeting for visitors we don't know.

Improve your results

The quality of the SmartBlock the agent generates depends on how detailed and clear your instructions are. Treat it as a collaborative assistant: guide it clearly and refine the output through conversation.

  • Be specific

    • Provide direct, detailed instructions about what you want to achieve.

    • Instead of: Create a banner.

    • Try: Create a hero banner promoting free next-day delivery with a bold headline, product image on the right, and green CTA button.
      ​

  • Describe the visual style

    • Include details such as:

      • modern

      • minimalist

      • high contrast
        ​

  • State your objective

    • Tell the agent what the SmartBlock is for, such as increasing clicks, promoting a sale, driving product discovery, or encouraging sign-ups.
      ​

  • Describe your brand if needed

    • If the design doesn’t match your brand, include your brand colors and fonts in your prompt.
      ​

  • Treat the process as a conversation

    • The best results often come from a few rounds of refinement. Start with a general request, follow up with adjustments, and keep refining until you're happy.
      ​

  • Use your own images
    The agent can’t create images, so it might add stock images as placeholders. Upload your own images to the chat, or replace the placeholders in the SmartBlock editor before you use the SmartBlock.

  • Review generated designs carefully

    • AI-generated outputs could be inaccurate or incomplete. Preview your SmartBlock, including on mobile, before you save and use it.
      ​

  • Stay within scope

    • SmartBlock Agent is designed to help with SmartBlock design. Manage other settings, such as Slots and targeting, yourself.
      ​

  • Keep control of the final result

    • SmartBlock Agent suggests changes, but you decide what to use. You can always make changes manually in the SmartBlock editor.

Did this answer your question?