Space Settings

Space settings allow you to configure default behaviors, security policies, and feature toggles that apply to all media storages within a space. Individual storages can override these defaults.

To access space settings, navigate to Settings in the left sidebar of your dashboard, then select the space you want to configure.

Default Transformation

Set a default transformation that is automatically applied to all media served from your space. This is useful for enforcing consistent output format, quality, or size across all images.

For example, you can set a default quality of 80 and format of WebP so all images are automatically optimized without needing to specify these parameters in every URL.

To configure default transformations:

1. Navigate to Space Settings in your dashboard.
2. Find the Default Transformation section.
3. Configure the desired output settings:

Setting	Description
Format	Output image format (e.g., WebP, JPEG, PNG, AVIF)
Quality	Output quality (1—100)
Strip Metadata	Remove EXIF and other metadata from output images

4. Click Save to apply your changes.

Tip

Default transformations are applied first, then any URL parameters override them. This means you can set sensible defaults while still allowing per-request customization.

Aliased Transformations

Create named presets for commonly used transformation combinations. Instead of repeating the same set of parameters in every URL, define an alias and reference it with a single ?alias=name parameter.

To create an alias:

1. Navigate to Space Settings in your dashboard.
2. Find the Aliased Transformations section.
3. Click Add alias.
4. Enter a name for the alias (1—16 characters, lowercase letters, digits, and hyphens only).
5. Configure the transformation settings you want this alias to apply (resize dimensions, format, quality, etc.).
6. Click Save.

Then use the alias in your image URLs:

?alias=thumbnail

Restrict to Known Aliases

You can toggle the Restrict to known aliases option in the Aliased Transformations section. When enabled, only pre-defined aliased transformations are accepted. Any request with custom transformation parameters (such as ?width=500) will be rejected. This is useful for:

• Preventing unexpected image sizes or formats
• Controlling bandwidth usage
• Enforcing brand-consistent image outputs

Watermarks

Manage watermark images that can be applied to your media. Watermarks are uploaded once and referenced by name in transformation URLs.

To manage watermarks:

1. Navigate to Space Settings in your dashboard.
2. Find the Watermarks section.
3. To add a watermark, click New watermark, give it a name, and upload a PNG image (PNG format is recommended for transparency support).
4. To delete a watermark, click the delete icon next to the watermark you want to remove.

Security

Configure how media access is secured in your space.

Transformation Security Level

In the Security section of your space settings, select the security level from the dropdown:

Level	Description
Token	Requires JWT token authentication for all requests
Signature	Requires URL signature with validity duration
Unsecured	No authentication required (use with caution)

API Keys

Generate scoped API keys for programmatic access to your space.

1. Navigate to Security in your space settings.
2. In the API Keys section, click Generate new key.
3. The new key is displayed once — copy and store it securely.
4. To revoke a key, click the delete icon next to it.

Each API key has a unique key ID for reference and can be revoked individually.

Signature Keys

Generate ECDSA key pairs for URL signature verification.

1. Navigate to Security in your space settings.
2. In the Signature Keys section, click Generate new key pair.
3. Copy the generated key details and store them securely.

Allowed Origins

Configure CORS allowed origins for your media.

1. Navigate to Security in your space settings.
2. In the Allowed Origins section, enter the origins you want to permit.

Supported formats:

• Exact domain matching (e.g., https://example.com)
• Wildcard subdomains (e.g., https://*.example.com)
• Custom ports (e.g., http://localhost:3000)
• Wildcard * to allow all origins
• Maximum 50 origins per space

Adaptive Media Policy

Automatically adjust image quality and dimensions based on client capabilities using Client Hints.

To configure adaptive media:

1. Navigate to Space Settings in your dashboard.
2. Find the Adaptive Media Policy section.
3. Toggle the feature on or off.
4. When enabled, configure the following settings:

Setting	Description
Max DPR	Maximum device pixel ratio to support (max: 5.0)
Allowed Resolutions	List of allowed width/height pairs
Lower quality based on network speed	Reduce quality for slow network connections

Supported Client Hints:

• Sec-CH-DPR — Device pixel ratio
• Sec-CH-Viewport-Width — Viewport width
• Sec-CH-Width — Resource width
• Sec-CH-ECT — Effective connection type
• Sec-CH-Downlink — Downlink speed

Versioning

Enable file versioning to track the history of media files. When versioning is enabled, previous versions of files are retained when they are overwritten.

To enable versioning:

1. Navigate to Space Settings in your dashboard.
2. Find the Versioning toggle.
3. Switch it on to enable, or off to disable.

Default AI Models

Configure which AI model tier is used by default for AI-powered operations.

1. Navigate to Space Settings in your dashboard.
2. Find the Default AI Models section.
3. Select the model tier for each operation from the dropdown:

Operation	Description	Models Available
Remove Background	Automatically remove image backgrounds	Basic, Quality
AI Edit	Prompt-based image editing	Basic, Quality

Note

The Quality model produces better results but costs more per operation. AI pricing is calculated based on output image dimensions (megapixels).

Max Storage Media Content Length

Set the maximum allowed file size for uploaded media. The default is 25 MB.

1. Navigate to Space Settings in your dashboard.
2. Find the Max file size setting.
3. Enter the maximum file size in bytes (e.g., 26214400 for 25 MB).
4. Click Save.

Storage-Level Overrides

Individual media storages can override space-level settings. This allows you to apply different security policies, default transformations, or watermarks to specific storages.

To configure storage-level overrides:

1. Navigate to the Storages section in your dashboard.
2. Select the storage you want to customize.
3. Open the storage’s Settings tab.
4. Override any of the following per storage:

• Default transformation
• Watermarks
• Security configuration
• Adaptive media policy
• Aliased transformations

Settings not explicitly overridden will inherit from the space defaults.