Skip to main content

getSites()

Gets an array of Remotion projects in your S3 account.

The projects are located in the sites/ subdirectory of your S3 bucket. Remember - you should only have one bucket for Remotion Lambda per region, therefore you do not need to specify the name of the bucket for this function.

Example​

Gets all sites and logs information about them.

ts
import { getSites } from "@remotion/lambda/client";
 
const { sites, buckets } = await getSites({
  region: "eu-central-1",
});
 
for (const site of sites) {
  console.log(site.id); // A unique ID for referring to that project
  console.log(site.bucketName); // In which bucket the site resides in.
  console.log(site.lastModified); // A unix timestamp, but may also be null
  console.log(site.sizeInBytes); // Size of all contents in the folder
  console.log(site.serveUrl); // URL of the deployed site that you can pass to `renderMediaOnLambda()`
}
 
for (const bucket of buckets) {
  console.log(bucket.region); // 'eu-central-1'
  console.log(bucket.name); // The name of the S3 bucket.
  console.log(bucket.creationDate); // A unix timestamp of when the site was created.
}
ts
import { getSites } from "@remotion/lambda/client";
 
const { sites, buckets } = await getSites({
  region: "eu-central-1",
});
 
for (const site of sites) {
  console.log(site.id); // A unique ID for referring to that project
  console.log(site.bucketName); // In which bucket the site resides in.
  console.log(site.lastModified); // A unix timestamp, but may also be null
  console.log(site.sizeInBytes); // Size of all contents in the folder
  console.log(site.serveUrl); // URL of the deployed site that you can pass to `renderMediaOnLambda()`
}
 
for (const bucket of buckets) {
  console.log(bucket.region); // 'eu-central-1'
  console.log(bucket.name); // The name of the S3 bucket.
  console.log(bucket.creationDate); // A unix timestamp of when the site was created.
}
note

Preferrably import this function from @remotion/lambda/client (available from v3.3.42) to avoid problems inside serverless functions.

Arguments​

An object with the following properties:

region​

The AWS region which you want to query.

forceBucketName?v3.3.102​

optional

Specify a specific bucket name to be used. This is not recommended, instead let Remotion discover the right bucket automatically.

Return value​

A promise resolving to an object with the following properties:

sites​

An array of deployed Remotion projects that you can use for rendering.

Each items contains the following properties:

id​

A unique identifier for that project.

bucketName​

The bucket in which the project resides in.

lastModified​

When the files in that project were last changed.

sizeInBytes​

The combined size of all files in that project.

serveUrl​

URL of the deployed site. You can pass it into renderMediaOnLambda() to render a video or audio.

buckets​

An array of all buckets in the selected region in your account that start with remotionlambda-.

info

You should only have 1 bucket per region for all your Remotion projects. Nonetheless buckets is an array, since we cannot prevent you from manually creating additional buckets with the remotionlambda- prefix.

Each item contains the following properties:

region​

The region the bucket resides in.

name​

The name of the bucket. S3 buckets have globally unique names.

creationDate​

A UNIX timestamp of the point when the bucket was first created.

See also​