> For the complete documentation index, see [llms.txt](https://developers.gamma.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.gamma.app/reference/warnings.md).

# Warnings

In some cases, you may receive file-level warnings in response to a generation request. These flag ignored or adjusted options that apply to the whole gamma — for example, sharing settings, folder assignment, or card dimensions.

For example, if you specify `1x1` dimensions for a presentation, Gamma uses a valid default instead and returns a warning explaining the change.

{% hint style="info" %}
Warnings are informational and do not prevent the generation from completing. Your Gamma will still be created, but some parameters may have been ignored or adjusted.
{% endhint %}

### Quick reference

* Warnings do not stop generation.
* A warning usually means Gamma ignored a conflicting or incompatible parameter for the whole gamma.
* Common file-level cases include ignored sharing options, folder restrictions, and invalid dimension/format combinations.
* The warning string is returned alongside `generationId` in the creation response.

### Common warning scenarios

#### Conflicting format and dimensions

If you specify card dimensions that don't match your chosen format, Gamma will use a valid default.

**Request:**

```json
{
  "format": "presentation",
  "inputText": "Best hikes in the United States",
  "cardOptions": {
    "dimensions": "1x1"
  }
}
```

**Response:**

```json
{
  "generationId": "xxxxxxxxxx",
  "warnings": "cardOptions.dimensions 1x1 is not valid for format presentation. Valid dimensions are: [ 16x9, 4x3, fluid ]. Using default: fluid."
}
```

#### Valid Dimensions by Format

| Format         | Valid Dimensions                    |
| -------------- | ----------------------------------- |
| `presentation` | `16x9`, `4x3`, `fluid`              |
| `document`     | `pageless`, `letter`, `a4`, `fluid` |
| `social`       | `1x1`, `4x5`, `9x16`                |
| `webpage`      | `fluid`                             |

#### Conflicting image source and model

If you specify an image model but the source is not `aiGenerated`, the model will be ignored.

**Request:**

```json
{
  "format": "presentation",
  "inputText": "Best hikes in the United States",
  "imageOptions": {
    "source": "pictographic",
    "model": "flux-1-pro"
  }
}
```

**Response:**

```json
{
  "generationId": "xxxxxxxxxx",
  "warnings": "imageOptions.model and imageOptions.style are ignored when imageOptions.source is not aiGenerated."
}
```

#### textMode preserve with textOptions

When using `textMode: "preserve"`, text generation options like `amount`, `tone`, and `audience` are ignored since your original text is being preserved.

**Request:**

```json
{
  "inputText": "Your detailed content here...",
  "textMode": "preserve",
  "textOptions": {
    "amount": "brief",
    "tone": "casual"
  }
}
```

**Response:**

```json
{
  "generationId": "xxxxxxxxxx",
  "warnings": "textOptions.amount and textOptions.tone are ignored when textMode is preserve."
}
```

#### Workspace-restricted sharing fields

If a workspace admin has restricted workspace sharing or disabled access links, Gamma strips the corresponding `sharingOptions` field from your request and returns a warning. The generation still completes using the admin-enforced default.

**Request:**

```json
{
  "inputText": "Q3 product strategy",
  "textMode": "generate",
  "sharingOptions": {
    "workspaceAccess": "comment",
    "externalAccess": "view"
  }
}
```

**Response (workspace sharing restricted):**

```json
{
  "generationId": "xxxxxxxxxx",
  "warnings": "sharingOptions.workspaceAccess was ignored because workspace sharing is restricted by a workspace admin."
}
```

**Response (access links disabled):**

```json
{
  "generationId": "xxxxxxxxxx",
  "warnings": "sharingOptions.externalAccess was ignored because access links are disabled by a workspace admin."
}
```

### Best practices

* Log and review warnings during development so ignored parameters are easy to spot.
* Match `format` and `cardOptions.dimensions` to avoid unexpected defaults.
* Only specify `imageOptions.model` when `imageOptions.source` is `aiGenerated`.
* Treat `textMode: "preserve"` as higher priority than text-generation settings like `amount`, `tone`, or `audience`.

### Related

* [Error codes](/reference/error-codes.md) for fatal API errors
* [Generate from text](/guides/generate-api-parameters-explained.md) for parameter interactions that commonly produce warnings
* [Generate from template](/guides/create-from-template-api-parameters-explained.md) for the template-specific workflow


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developers.gamma.app/reference/warnings.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.