> ## 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

> Inserts images into Google Slides presentations with positioning and sizing options

Inserts images into Google Slides presentations with positioning and sizing options. Find shapes using alt text. Need to provide image URL

|                      |                    |
| -------------------- | ------------------ |
| **App**              | Google Slides      |
| **Operation ID**     | `slides_add_image` |
| **Type**             | Action             |
| **Connection**       | `drive` (optional) |
| **Credits per run**  | 1                  |
| **Agent / MCP tool** | Yes                |

## Inputs

| Field             | Type                                          | Required | Default | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ----------------- | --------------------------------------------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `presentation`    | string                                        | Yes      | -       | Google Slides presentation URL or ID. You must ask the user for it if not provided.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `update_type`     | string or SelectableOption                    | Yes      | -       | Choose how to provide the image data. Available options: 'mapped' - Define individual image replacement manually (DEFAULT) 'all' - Use data from previous steps containing image URLs and text identifiers                                                                                                                                                                                                                                                                                                                                                                         |
| `search_method`   | string or SelectableOption                    | Yes      | -       | Method to identify shapes to replace with images: 'regular' - Find shapes containing specific text 'alt\_text' - Find shapes by their alt text property (RECOMMENDED)  **Always use and recommend alt text method for reliability.**  Tell users they need to: 1. Insert a shape in their slides 2. Right-click on shapes in their slides and select 'Alt Text'  3. Add unique identifiers (e.g., 'Product Image', 'Chart Placeholder') 4. Use these alt text values in the image operation  Alt text prevents issues when slide content changes and ensures consistent targeting. |
| `structured_data` | array (also accepts a comma-separated string) | No       | -       | Data source containing image information. REQUIRED when update\_type is 'all'. This is mainly the output from an upstream node. MUST BE NULL/EMPTY when update\_type is 'mapped' - clear this field if update\_type changes to 'mapped'. Data must contain 'image\_url' and 'text' fields for each row. Optional 'slide\_number' field can target specific slides. Examples:  '\{\{nodeId\_\_data}}' The node output should have a list of dictionaries with the format: \[\{'image\_url': '`https://example.com/image.jpg`', 'text': 'product image', 'slide\_number': 1}]        |
| `image_url`       | string                                        | No       | -       | URL of the image to insert. REQUIRED when update\_type is 'mapped'. MUST BE NULL/EMPTY when update\_type is 'all' - clear this field if update\_type changes to 'all'. Must be a valid HTTP or HTTPS URL pointing to an image file. Examples: '`https://example.com/image.jpg`', '`https://picsum.photos/300/200`'                                                                                                                                                                                                                                                                 |
| `text_to_find`    | string                                        | No       | -       | Text to find in shapes for replacement. REQUIRED when update\_type is 'mapped'. MUST BE NULL/EMPTY when update\_type is 'all' - clear this field if update\_type changes to 'all'. When using 'regular' search method: actual text content in shapes. When using 'alt\_text' search method: alt text value of the shape. Example: 'placeholder image' or 'product-photo'                                                                                                                                                                                                           |
| `slide_number`    | integer                                       | No       | -       | Optional slide number to target for image insertion (1-based indexing). Leave empty to search all slides. Only applies when update\_type is 'mapped'. Must be a positive integer if specified. Example: 1 for first slide, 2 for second slide, etc.                                                                                                                                                                                                                                                                                                                                |

### SelectableOption

| Field   | Type   | Required | Default | Description |
| ------- | ------ | -------- | ------- | ----------- |
| `value` | string | Yes      | -       |             |
| `label` | string | Yes      | -       |             |

## Output

**Type**: `str`

Returns success message with image count.