Overview

Images are fundamental visual elements in Marq that enable rich, professional content creation across templates and projects. They serve as the building blocks for compelling marketing materials, brand communications, and personalized documents. Understanding how images work in Marq is essential for template creators, brand administrators, and end users who need to create visually engaging content.

Unlike text-based smart fields that can be easily modified through APIs, images in Marq operate through a sophisticated asset management system that prioritizes brand consistency, user experience, and creative flexibility.

Understanding Images in Marq

What Are Images in Marq?

Images in Marq are visual assets that can be:

  • Static elements embedded directly in templates
  • Dynamic placeholders that users can replace with their own content
  • Brand-controlled assets managed centrally by administrators
  • Data-driven elements populated automatically from external sources

Key Image Types

Template Images

  • Background graphics and decorative elements
  • Placeholder images that guide users on content expectations
  • Brand-compliant imagery pre-approved for use

User Uploaded Images

  • Photos uploaded by end users for personalization
  • Custom graphics created outside of Marq
  • Dynamic content that changes per project

Data-Connected Images

  • Property photos from MLS feeds
  • Product images from e-commerce systems
  • Headshots and profile images from CRM databases

Image Architecture in Marq

Image Smart Fields

Images can be configured as smart fields in templates, allowing for dynamic replacement:

{{property_image}}
{{agent_headshot}}
{{company_logo}}
{{background_hero}}

When creating projects from templates, these smart fields can be populated through:

  • Manual upload by end users
  • Data automation from connected systems
  • URL-based injection through template links
  • API integration from Project API payloads

Image Sources and Management

Upload Sources

  • Direct file upload from devices
  • URL-based image insertion
  • Cloud storage integration
  • Data automation feeds

Supported Formats

  • JPEG/JPG for photographs
  • PNG for graphics with transparency
  • SVG for scalable vector graphics
  • WebP for optimized web imagery

Integration Patterns

With Data Automation

Images can be seamlessly integrated with Marq's data automation features:

Property Listings Integration

{
  "dataSmartFields": [
    {
      "dataSetName": "Properties",
      "columns": [
        {
          "column": "mlsNumber",
          "value": "123456"
        }
      ]
    }
  ]
}

When this data is applied, associated property images are automatically populated into designated image smart fields.

With Template Links

Images can be dynamically set through URL parameters:

https://app.marq.com/documents/editNew/template-id?custom_document_smart_field_hero_image=https://example.com/image.jpg

This enables dynamic image injection for campaigns and personalized communications.


Related Documentation

Additional Resources