Full-Site Delivery

To ensure optimum origin performance during times of increased demand or during scheduled downtime for your servers, consider the following…

Checking the cache status of an object on your website can help when troubleshooting problems. You can use the web interface or the curl…

When we store your content in cache, we calculate a Time to Live (TTL). The TTL is the maximum amount of time we will use the content to…

Application Programming Interfaces (APIs) allow you to retrieve data from a variety of web services. Fastly makes it possible for you to…

This guide explains how to implement API cache control. Once you've enabled API caching , and ensured purging works properly with your…

In certain situations you may want to conditionally apply a different caching policy based on a backend response. In this particular case…

Fastly service configurations may be vulnerable to cache poisoning if they do not take into consideration the interaction between HTTP "X…

Fastly’s Segmented Caching feature allows you to cache resources of any size. Segmented Caching works by breaking resources into smaller…

Caching can be disabled: at the individual URL level, at the browser level, and at the site level. Disabling caching at the individual URL…

Conditions are a configuration mechanism that you can add to your service to control how particular requests are processed. Like conditions…

If you are having problems using conditions, here are some common things to look for. Check the Apply if field for if statements Most…

Conditions use the Varnish Configuration Language (VCL) to define when a configuration object should be applied while processing requests…

VCL Snippets are short blocks of VCL logic that can be included directly in your service configurations. They're ideal for adding small…

Basic authentication is a simple way of protecting a website at the edge. Users enter a username and password combination to access pages…

Fastly can send custom responses for certain requests that you don't want to hit your origin servers. Creating a quick response Fastly…

Best practices in Fastly VCL have changed over time to help address expectation gaps and improve maintainability. This page covers some of the most common use cases in edge logic and demonstrates how to avoid bad code, reduce risk, improve safety, and take steps to make the codebase more maintainable for large teams.

In normal operation, a request directed to a Fastly POP will be handled by two separate cache servers acting together in a process we call clustering.

VCL services offer an efficient mechanism to manage and control traffic to your domains, powered by Fastly's variant of the Varnish Configuration Language (VCL).

If a fatal error occurs in your service while processing your VCL logic, Fastly will generate an error response with a 503 HTTP status, instead of using a response from an upstream server or cache, and unless intercepted by code running in vcl_error, this generated error may be served to the end user.

Fastly VCL is a domain specific programming language which has evolved from the Varnish proxy cache, which is part of Fastly's platform architecture.

Fastly’s Edge Cloud services use the Fastly Varnish Configuration Language (VCL), a scripting language used to configure and add logic to…

Fastly supports the ability to extract header subfield values without regular expressions in a human-readable way. Headers subfields are…

Before you begin If your origin uses special values (e.g., request headers) to select content for users or to otherwise direct requests to…

The traditional way to read response cookies in VCL is to inspect either the beresp.http.Set-Cookie or the resp.http.Set-Cookie…

Being able to track information related to your origin can be helpful in troubleshooting errors and making sure requests are processed as…

Passing with a request setting and with a cache setting triggers very different behavior in Varnish . Within VCL, passing with a…

Fastly allows you create your own Varnish Configuration Language (VCL) files with specialized configurations. By uploading custom VCL files…

Dynamic VCL Snippets are one of two types of snippets that allow you to insert small sections of VCL logic into your service configuration…

Regular VCL Snippets are one of two types of snippets that allow you to insert small sections of VCL logic into your service configuration…

Fastly VCL uses a subset of Perl Compatible Regular Expression (PCRE) syntax. This is case sensitive and forward slashes don't need to be…

Dictionaries are a type of container that allow you to store data as key-value pairs that can be used in a service without being attached…

Dictionaries are a type of container that allow you to store data as key-value pairs that can be used in a service without being attached…

This guide describes how to automatically load balance between two or more origin servers. Load balancing distributes requests across…

Connection timeouts to your origin server control how long Fastly will wait for a response from your origin server before exiting with an…

Fastly allows you to change origin servers based on the user's geographic location. This is useful when you need to serve different content…

This guide describes how to configure failover origin servers. Failover (backup) servers ensure you can maintain availability of your…

Fastly has integrated IPv6 into its technology stack. By enabling IPv6, visitors on IPv6 connections can access your websites and…

It is common to use the same origin web application to serve both HTTP and HTTPS requests and let the application determine which actions to…

Sometimes you want to set up two different origin servers, one as a primary and one as a backup in case the primary becomes unavailable. You…

To rewrite the Host header being sent to your origin regardless of the Host used in the initial request, specify an override host. Use this…

Some customers use only their second-level or apex domain (e.g., example.com rather than www.example.com ) as their canonical domain. Due…

HTTP header fields are components of the header section of request and response messages in the Hypertext Transfer Protocol (HTTP). They…

Enabling Cross-Origin Resource Sharing (CORS) allows a server to indicate that other origins can request sub-resources, like scripts and…

You can remove headers from any backend response. This may be necessary if your application automatically sets headers. For example, Drupal…

In some situations you may want to override the content type that a backend returns. To do that you will need to create a new header object…

Fastly's Image Optimizer (Fastly IO) is an image optimization service that manipulates and transforms your images in real time and caches…

When an observed metric either exceeds or falls below a threshold, the Alerts feature displays a notification in the Fastly application and…

From the Observability tab, you can access dashboards that contain collections of metrics represented as charts. Depending on the…

We think the mtr tool offers a great way to test network speed, evaluate performance, and perform connection diagnostics. The mtr tool…

Compression can help you reduce the size of your assets so traffic can flow faster. You can use Fastly to compress data automatically on our…

This guide describes how to enable HTTP/3 for your Fastly services. About HTTP/3 HTTP/3 uses a web transport protocol standard called QUIC…

If you haven't enabled Segmented Caching , you may encounter the following failure modes when working with large objects. If you created…

Fastly continuously monitors the performance and status of our global network . We constantly monitor the health of all its related…

HTTP/2 server push allows you to set up rules that enable Fastly to pre-emptively load and then send responses to an HTTP/2-compliant client…

Under normal circumstances, Fastly would consider these URLs different objects that are cached separately: http://example.com http://example…

Fastly can automatically detect and, in real time, route around transient connection problems that occur when fetching content from your…

Fastly can optionally serve stale content when there is a problem with your origin server or if new content is taking a long time to fetch…

When fetching an object from the origin, the Streaming Miss feature ensures the response is streamed back to the client immediately and is…

Fastly's URL purge feature allows you to purge individual URLs on your website. By default, authentication is not required to purge a URL…

Fastly provides several levels of cache purging. You can use the Purge URL option to purge a single URL via the web interface. Before you…

Fastly provides several levels of cache purging. You can use the Purge all option to purge all content under a service. Before you begin…

Fastly provides several levels of cache purging and choosing the right purging method is essential to keeping your website fast. While…

Fastly provides a Soft Purge feature that allows you to mark content as outdated ( stale ). Stale objects remain available to use in some…

Surrogate keys are unique identifiers that you assign to groups of content for processing. While there are many use cases for surrogate keys…

Using a restart is a good option to check multiple backends for a single request. This can be created using a cache setting rule and…

To conditionally change a URL based on the domain, include VCL that looks something like this: If you have shielding enabled, however, add…

Request settings are applied based on the Action you select in the Create a new request setting page. You can choose any one of the…

The robots.txt file tells web robots how to crawl webpages on your website. You can use Fastly's web interface to create and configure a…

The default error responses served by Fastly can be jarring for your users, especially when using Fastly for consumer applications. To…

You can use the Redirect traffic to www subdomains setting to redirect traffic for apex domains, wildcard domains, or subdomains to a www…

Fastly allows you to create custom HTTP responses that are served directly from the cache without storing the page on a server. Responses…

Fastly's On-the-Fly Packaging (OTFP) service supports any directory structure you might use to store different quality levels of a video…

Fastly allows you to collect and process On-the-Fly Packaging (OTFP) service metrics for analysis using a combination of custom VCL…

This page lists some possible error values that Fastly's On-The-Fly Packaging service (OTFP) service will send in the X-Fastly-Package…

The Fastly network can deliver live streams for any HTTP streaming technology , archived or recorded, on any public or private cloud…