> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Add Image

> Insert images into Google Slides presentations by replacing shapes with dynamic images from your workflows.

**Add Image** replaces shapes in your Google Slides presentations with images. Perfect for adding dynamic product photos, charts, profile pictures, or any visual content that changes based on your data.

***

## Inputs

| Field                   | Type   | Required | Description                                           |
| ----------------------- | ------ | -------- | ----------------------------------------------------- |
| **Presentation URL/ID** | Text   | Yes      | Google Slides presentation link or ID                 |
| **Image Data Source**   | Select | Yes      | Single image or Structured Data (Bulk)                |
| **Search Method**       | Select | Yes      | How to find shapes: By text content or Alt text       |
| **Image URL**           | Text   | Yes      | URL of the image to insert                            |
| **Text to Find**        | Text   | Yes      | Text or alt text to identify the shape to replace     |
| **Slide Number**        | Number | No       | Specific slide to update (leave empty for all slides) |

***

## Search Methods: How to Find Shapes

### By Text Content

Finds shapes that contain specific visible text.

* **Use for:** One-time image updates, simple replacements
* **Example:** Replace a shape containing "Product Photo" with an actual product image

### By Alt Text

Uses hidden alt text labels to identify shapes.

* **Use for:** Recurring reports, reusable templates
* **Example:** Label a shape "hero\_image" and replace it with different hero images

**What is Alt Text?** A hidden label you add to shapes. Right-click on any shape → Alt text to set descriptive names like "product\_image" or "chart\_placeholder".

***

## Image Data Sources: Single vs Structured Data (Bulk)

### Single Image

Add one image to one shape.

**Best for:**

* 1 image replacement
* Simple updates
* One-off presentation changes

**Example:**
Replace a placeholder shape with your latest product photo

### Structured Data (Bulk)

Add multiple images using data from previous workflow steps.

**Best for:**

* 10+ image replacements
* Dynamic images from databases
* Automated visual reports

**Example:** Replace multiple product placeholders with images from your e-commerce catalog.

***

## Examples

### Single Image Example

**Scenario:** Update monthly report with latest campaign creative

**Setup:**

* Set alt text "revenue\_chart" on placeholder shape
* Get image URL from previous workflow step

**Configuration:**

* **Search Method:** By Alt Text
* **Text to Find:** "revenue\_chart"
* **Image URL:** Output from Generate Image or external URL

### Structured Data (Bulk) Example

**Scenario:** Product catalog presentation with multiple product images

**Workflow:**

1. **Get product data** from Shopify/database with image URLs
2. **Add Image** with Structured Data (Bulk) to replace all placeholders

**Your data table:**

| text              | image\_url                                                            | slide\_number |
| ----------------- | --------------------------------------------------------------------- | ------------- |
| product\_1\_image | "[https://example.com/product1.jpg](https://example.com/product1.jpg) | 2             |
| product\_2\_image | [https://example.com/product2.jpg](https://example.com/product2.jpg)  | 3             |
| product\_3\_image | [https://example.com/product3.jpg](https://example.com/product3.jpg)  | 4             |
| hero\_banner      | [https://example.com/banner.jpg](https://example.com/banner.jpg)      | 1             |

**Result:** All product placeholders get replaced with actual product images automatically.

***

## Structured Data Format Requirements

Your data must include these fields:

* **text**: Text or alt text to find the shape
* **image\_url**: URL of the image to insert
* **slide\_number** (optional): Target specific slide

**Example Format:**

```json theme={"dark"}
[
  {
    "text": "product_image_placeholder",
    "image_url": "https://example.com/product.jpg"
  },
  {
    "text": "chart_placeholder", 
    "image_url": "https://example.com/chart.png",
    "slide_number": 3
  }
]
```

***

## Image Requirements

### Supported Formats

* **JPG/JPEG** - Best for photos
* **PNG** - Best for logos, screenshots with transparency

### Best Practices

* **Use public URLs** or cloud storage links (Google Drive, Dropbox, etc.)
* **Optimize file size** for faster loading (under 5MB recommended)
* **Consider aspect ratio** - images will be scaled to fit the shape
* **Use high resolution** for better quality in presentations

***

## Credit Cost

1 credit per successful run.

***

## FAQ

<Accordion title="What's the difference between Text Content and Alt Text search?">
  **Text Content** finds shapes by visible text inside them. **Alt Text** uses hidden labels you add to shapes.

  Use Text Content for one-time replacements. Use Alt Text for recurring templates where you'll replace the same shapes repeatedly.
</Accordion>

<Accordion title="When should I use Single vs Structured Data (Bulk)?">
  **Single**: 1 image replacement, simple updates

  **Structured Data (Bulk)**: Multiple images, product catalogs, automated visual reports
</Accordion>

<Accordion title="How do I prepare shapes for image replacement?">
  1. **Create a shape** (rectangle, circle, etc.) in Google Slides
  2. **Add identifying text** or set alt text (right-click → Alt text)
  3. **Size the shape** to your desired image dimensions
  4. **Position it** where you want the image to appear

  The shape will be completely replaced with your image.
</Accordion>

<Accordion title="What image URLs work best?">
  **Best options:**

  * Direct image URLs (ending in .jpg, .png, etc.)
  * Google Drive public share links
  * Cloud storage URLs (Dropbox, AWS S3, etc.)
  * Output from Generate Image nodes

  **Avoid:**

  * Password-protected URLs
  * Social media image links (Instagram, Facebook)
  * URLs requiring authentication
</Accordion>

<Accordion title="Can I control image sizing and positioning?">
  The image will automatically fit the shape you're replacing. To control sizing:

  * **Resize the original shape** to your desired dimensions
  * **Position the shape** exactly where you want the image
  * Images maintain aspect ratio and are scaled to fit within the shape boundaries
</Accordion>

<Accordion title="What happens if the shape isn't found?">
  If the text or alt text isn't found, the replacement is skipped. Check:

  * Spelling matches exactly
  * Shape exists on the specified slide
  * Alt text is set correctly (right-click → Alt text)
  * Search method matches your setup (text content vs alt text)
</Accordion>