# Resize Videos

[View original](https://ittybit.com/guides/resize-videos)

## Resize proportionally

If you only provide one of the two dimensions, the video will be resized proportionally.

For example, a [Task](/docs/tasks) with `width: 960` will resize a `1920x1080` input video to `960x540`: the 960 is set by the `width` prop, and the `height` is calculated to maintain the original aspect ratio (960 is 50% of 1920, 50% of 1080 is 540).

<Tabs groupId="language" items={["typescript", "python", "ruby", "php", "go", "fetch" ]} persist>
  <Tab value="typescript">
    ```js
    const task = await ittybit.tasks.create({
      kind: 'video',
      url: 'https://ittyb.it/sample.mp4',
      width: 960,
    });
    ```
  </Tab>

  <Tab value="python">
    ```python
    task = ittybit.tasks.create(
      kind='video',
      url='https://ittyb.it/sample.mp4',
      width=960
    )
    ```
  </Tab>

  <Tab value="ruby">
    ```ruby
    task = ittybit.tasks.create(
      kind: 'video',
      url: 'https://ittyb.it/sample.mp4',
      width: 960
    )
    ```
  </Tab>

  <Tab value="php">
    ```php
    $task = $ittybit->tasks->create([
        'kind' => 'video',
        'url' => 'https://ittyb.it/sample.mp4',
        'width' => 960,
    ]);
    ```
  </Tab>

  <Tab value="go">
    ```go
    task, err := ittybit.Tasks.Create(
        context.Background(),
        &ittybit.TaskCreateParams{
            Kind: "video",
            URL: "https://ittyb.it/sample.mp4",
            Width: 960,
        },
    )
    ```
  </Tab>

  <Tab value="fetch">
    ```js
    const task = await fetch('https://api.ittybit.com/tasks', {
      method: 'POST',
      headers: { 'Authorization': `Bearer ${ITTYBIT_API_KEY}` },
      body: JSON.stringify({ 
        kind: 'video', 
        url: 'https://ittyb.it/sample.mp4',
        width: 960,
      })
    })
    ```
  </Tab>
</Tabs>

*(See [SDKs](/sdks) for install and initialization steps.)*

***

## Resize to a specific size

If you provide both the `width` and `height` props, the video will be resized to the exact size you specify.

For example, a [Task](/docs/tasks) with `width: 960` and `height: 960` will resize a `1920x1080` input video to `960x960`: both dimensions are set explicitly by the `width` and the `height` props.

<Tabs groupId="language" items={["typescript", "python", "ruby", "php", "go", "fetch" ]} persist>
  <Tab value="typescript">
    ```js
    const task = await ittybit.tasks.create({
      kind: 'video',
      url: 'https://ittyb.it/sample.mp4',
      width: 960,
      height: 960,
    });
    ```
  </Tab>

  <Tab value="python">
    ```python
    task = ittybit.tasks.create(
      kind='video',
      url='https://ittyb.it/sample.mp4',
      width=960,
      height=960
    )
    ```
  </Tab>

  <Tab value="ruby">
    ```ruby
    task = ittybit.tasks.create(
      kind: 'video',
      url: 'https://ittyb.it/sample.mp4',
      width: 960,
      height: 960
    )
    ```
  </Tab>

  <Tab value="php">
    ```php
    $task = $ittybit->tasks->create([
        'kind' => 'video',
        'url' => 'https://ittyb.it/sample.mp4',
        'width' => 960,
        'height' => 960,
    ]);
    ```
  </Tab>

  <Tab value="go">
    ```go
    task, err := ittybit.Tasks.Create(
        context.Background(),
        &ittybit.TaskCreateParams{
            Kind: "video",
            URL: "https://ittyb.it/sample.mp4",
            Width: 960,
            Height: 960,
        },
    )
    ```
  </Tab>

  <Tab value="fetch">
    ```js
    const task = await fetch('https://api.ittybit.com/tasks', {
      method: 'POST',
      headers: { 'Authorization': `Bearer ${ITTYBIT_API_KEY}` },
      body: JSON.stringify({ 
        kind: 'video', 
        url: 'https://ittyb.it/sample.mp4',
        width: 960,
        height: 960,
      })
    })
    ```
  </Tab>
</Tabs>

***

## Control how the video is resized

In the previous examples, the video was resized to the exact size you specified, but that may distort the aspect ratio of the video. Making the output video look stretched or squashed.

The `fit` prop allows you to control how the video is resized.

***

### `fit: "cover"`

The video is resized to cover the specified dimensions, while maintaining the original aspect ratio. Any part of the video that does not fit within the specified dimensions will be cropped.

<Tabs groupId="language" items={["typescript", "python", "ruby", "php", "go", "fetch" ]} persist>
  <Tab value="typescript">
    ```js
    const task = await ittybit.tasks.create({
      kind: 'video',
      url: 'https://ittyb.it/sample.mp4',
      width: 960,
      height: 960,
      fit: 'cover',
    });
    ```
  </Tab>

  <Tab value="python">
    ```python
    task = ittybit.tasks.create(
      kind='video',
      url='https://ittyb.it/sample.mp4',
      width=960,
      height=960,
      fit='cover',
    )
    ```
  </Tab>

  <Tab value="ruby">
    ```ruby
    task = ittybit.tasks.create(
      kind: 'video',
      url: 'https://ittyb.it/sample.mp4',
      width: 960,
      height: 960,
      fit: 'cover',
    )
    ```
  </Tab>

  <Tab value="php">
    ```php
    $task = $ittybit->tasks->create([
        'kind' => 'video',
        'url' => 'https://ittyb.it/sample.mp4',
        'width' => 960,
        'height' => 960,
        'fit' => 'cover',
    ]);
    ```
  </Tab>

  <Tab value="go">
    ```go
    task, err := ittybit.Tasks.Create(
        context.Background(),
        &ittybit.TaskCreateParams{
            Kind: "video",
            URL: "https://ittyb.it/sample.mp4",
            Width: 960,
            Height: 960,
            Fit: "cover",
        },
    )
    ```
  </Tab>

  <Tab value="fetch">
    ```js
    const task = await fetch('https://api.ittybit.com/tasks', {
      method: 'POST',
      headers: { 'Authorization': `Bearer ${ITTYBIT_API_KEY}` },
      body: JSON.stringify({ 
        kind: 'video', 
        url: 'https://ittyb.it/sample.mp4',
        width: 960,
        height: 960,
        fit: 'cover',
      })
    })
    ```
  </Tab>
</Tabs>

***

### `fit: "contain"`

The video is resized to fit within the specified dimensions, while maintaining the original aspect ratio. The video may have extra padding on the top and bottom, or the left and right, depending on the aspect ratio of the input video.

<Tabs groupId="language" items={["typescript", "python", "ruby", "php", "go", "fetch" ]} persist>
  <Tab value="typescript">
    ```js
    const task = await ittybit.tasks.create({
      kind: 'video',
      url: 'https://ittyb.it/sample.mp4',
      width: 960,
      height: 960,
      fit: 'contain',
    });
    ```
  </Tab>

  <Tab value="python">
    ```python
    task = ittybit.tasks.create(
      kind='video',
      url='https://ittyb.it/sample.mp4',
      width=960,
      height=960,
      fit='contain',
    )
    ```
  </Tab>

  <Tab value="ruby">
    ```ruby
    task = ittybit.tasks.create(
      kind: 'video',
      url: 'https://ittyb.it/sample.mp4',
      width: 960,
      height: 960,
      fit: 'contain',
    )
    ```
  </Tab>

  <Tab value="php">
    ```php
    $task = $ittybit->tasks->create([
        'kind' => 'video',
        'url' => 'https://ittyb.it/sample.mp4',
        'width' => 960,
        'height' => 960,
        'fit' => 'contain',
    ]);
    ```
  </Tab>

  <Tab value="go">
    ```go
    task, err := ittybit.Tasks.Create(
        context.Background(),
        &ittybit.TaskCreateParams{
            Kind: "video",
            URL: "https://ittyb.it/sample.mp4",
            Width: 960,
            Height: 960,
            Fit: "contain",
        },
    )
    ```
  </Tab>

  <Tab value="fetch">
    ```js
    const task = await fetch('https://api.ittybit.com/tasks', {
      method: 'POST',
      headers: { 'Authorization': `Bearer ${ITTYBIT_API_KEY}` },
      body: JSON.stringify({ 
        kind: 'video', 
        url: 'https://ittyb.it/sample.mp4',
        width: 960,
        height: 960,
        fit: 'contain',
      })
    })
    ```
  </Tab>
</Tabs>

***

### `position: "<position>"`

You can use the `position` prop to control where the video is placed within the specified dimensions. For example, to always show the top of the video even when cropping, you can use `position: "top"`.

The available values are:

* `top`
* `top-right`
* `right`
* `bottom-right`
* `bottom`
* `bottom-left`
* `left`
* `top-left`

If you don't specify a position, the video will be centered within the specified dimensions.

<Tabs groupId="language" items={["typescript", "python", "ruby", "php", "go", "fetch" ]} persist>
  <Tab value="typescript">
    ```js
    const task = await ittybit.tasks.create({
      kind: 'video',
      url: 'https://ittyb.it/sample.mp4',
      width: 960,
      height: 960,
      fit: 'cover',
      position: 'top-left',
    });
    ```
  </Tab>

  <Tab value="python">
    ```python
    task = ittybit.tasks.create(
      kind='video',
      url='https://ittyb.it/sample.mp4',
      width=960,
      height=960,
      fit='cover',
      position='top-left',
    )
    ```
  </Tab>

  <Tab value="ruby">
    ```ruby
    task = ittybit.tasks.create(
      kind: 'video',
      url: 'https://ittyb.it/sample.mp4',
      width: 960,
      height: 960,
      fit: 'cover',
      position: 'top-left',
    )
    ```
  </Tab>

  <Tab value="php">
    ```php
    $task = $ittybit->tasks->create([
        'kind' => 'video',
        'url' => 'https://ittyb.it/sample.mp4',
        'width' => 960,
        'height' => 960,
        'fit' => 'cover',
        'position' => 'top-left',
    ]);
    ```
  </Tab>

  <Tab value="go">
    ```go
    task, err := ittybit.Tasks.Create(
        context.Background(),
        &ittybit.TaskCreateParams{
            Kind: "video",
            URL: "https://ittyb.it/sample.mp4",
            Width: 960,
            Height: 960,
            Fit: "cover",
            Position: "top-left",
        },
    )
    ```
  </Tab>

  <Tab value="fetch">
    ```js
    const task = await fetch('https://api.ittybit.com/tasks', {
      method: 'POST',
      headers: { 'Authorization': `Bearer ${ITTYBIT_API_KEY}` },
      body: JSON.stringify({ 
        kind: 'video', 
        url: 'https://ittyb.it/sample.mp4',
        width: 960,
        height: 960,
        fit: 'cover',
        position: 'top-left',
      })
    })
    ```
  </Tab>
</Tabs>

<Callout type="info">
  <Icon icon="info" />

  The `position` prop is also supported for the `contain` fit type. In this case the video will be placed against the specified position and extra padding will be added to the other sides.
</Callout>

***

### `background: "<color>"`

You can use the `background` prop to specify a background color for the video. The background color will be used for any extra padding added to the video when it is resized.

The background color must be a valid hex color e.g. `#000000`, `#ffffff`, or `#bada55`.

<Tabs groupId="language" items={["typescript", "python", "ruby", "php", "go", "fetch" ]} persist>
  <Tab value="typescript">
    ```js
    const task = await ittybit.tasks.create({
      kind: 'video',
      url: 'https://ittyb.it/sample.mp4',
      width: 960,
      height: 960,
      fit: 'contain',
      position: 'top-left',
      background: '#20B075',
    });
    ```
  </Tab>

  <Tab value="python">
    ```python
    task = ittybit.tasks.create(
      kind='video',
      url='https://ittyb.it/sample.mp4',
      width=960,
      height=960,
      fit='contain',
      position='top-left',
      background='#20B075',
    )
    ```
  </Tab>

  <Tab value="ruby">
    ```ruby
    task = ittybit.tasks.create(
      kind: 'video',
      url: 'https://ittyb.it/sample.mp4',
      width: 960,
      height: 960,
      fit: 'contain',
      position: 'top-left',
      background: '#20B075',
    )
    ```
  </Tab>

  <Tab value="php">
    ```php
    $task = $ittybit->tasks->create([
        'kind' => 'video',
        'url' => 'https://ittyb.it/sample.mp4',
        'width' => 960,
        'height' => 960,
        'fit' => 'contain',
        'position' => 'top-left',
        'background' => '#20B075',
    ]);
    ```
  </Tab>

  <Tab value="go">
    ```go
    task, err := ittybit.Tasks.Create(
        context.Background(),
        &ittybit.TaskCreateParams{
            Kind: "video",
            URL: "https://ittyb.it/sample.mp4",
            Width: 960,
            Height: 960,
            Fit: "contain",
            Position: "top-left",
            Background: "#20B075",
        },
    )
    ```
  </Tab>

  <Tab value="fetch">
    ```js
    const task = await fetch('https://api.ittybit.com/tasks', {
      method: 'POST',
      headers: { 'Authorization': `Bearer ${ITTYBIT_API_KEY}` },
      body: JSON.stringify({ 
        kind: 'video', 
        url: 'https://ittyb.it/sample.mp4',
        width: 960,
        height: 960,
        fit: 'contain',
        position: 'top-left',
        background: '#20B075',
      })
    })
    ```
  </Tab>
</Tabs>

<Callout type="warning">
  <Icon icon="warning" />

  Only the `contain` fit type supports the `background` prop. You can include it without raising type errors, but it will be ignored.
</Callout>