> ## Documentation Index
> Fetch the complete documentation index at: https://docs.variable.global/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuration

Enable your PACT API in Variable in the "Variable Subdomain" section in [company settings](https://app.variable.global/company).

<Note>
  If you don't see the Variable Subdomain section, [email us](mailto:hello@variable.co), and we'll enable it for your account.
</Note>

### Requirements

There are two parts to setting up your PACT API:

1. Getting your PACT API URL
2. Sharing your Product Carbon Footprints (PCFs) with the API

### Your PACT API URL

Your PACT API URL is based on your Variable subdomain. For example, if your subdomain is `furniture-co`,
your PACT API URL is:

[https://furniture-co.variable.global/api/pact/2/footprints](https://furniture-co.variable.global/api/pact/2/footprints)

<img src="https://mintcdn.com/variable/gxymAZ01r1v-cJqJ/images/variable-subdomain-settings.png?fit=max&auto=format&n=gxymAZ01r1v-cJqJ&q=85&s=19556a02578d573e84dc97946219fc48" alt="Variable subdomain settings" style={{width: '600px', maxWidth: '100%', height: 'auto'}} className="shadow-lg" width="1346" height="718" data-path="images/variable-subdomain-settings.png" />

### API Users

By default, users must authenticate to access your PACT API. You can add API users in the same section in
your [company settings](https://app.variable.global/company). Be sure to give them the `pact:read` permission.

<img src="https://mintcdn.com/variable/gxymAZ01r1v-cJqJ/images/pact-read.png?fit=max&auto=format&n=gxymAZ01r1v-cJqJ&q=85&s=6f8420eb8f16966d97109fd903842034" alt="Permission: pact:read" style={{width: '200px', maxWidth: '100%', height: 'auto'}} className="shadow-lg" width="280" height="132" data-path="images/pact-read.png" />

### Visibility

You can also make your PACT API public to the internet by setting "Visibility" to "Public".

<img src="https://mintcdn.com/variable/gxymAZ01r1v-cJqJ/images/visibility-public.png?fit=max&auto=format&n=gxymAZ01r1v-cJqJ&q=85&s=b9d08c283b3fb7d662fee3ecc2aef4e9" alt="Variable subdomain settings: visibility" style={{width: '200px', maxWidth: '100%', height: 'auto'}} className="shadow-lg" width="362" height="116" data-path="images/visibility-public.png" />

### Sharing Footprints

Products that have a sharing setting of "API", and are conformant with
the [PACT standard](https://wbcsd.github.io/data-exchange-protocol/v2) are shown in the PACT API.

To change the sharing setting for a Product, go to the Product's Passport tab, click on the "Share" button, and select "API".

<img src="https://mintcdn.com/variable/gxymAZ01r1v-cJqJ/images/passport-sharing.png?fit=max&auto=format&n=gxymAZ01r1v-cJqJ&q=85&s=be3a91995cd9560c3bd2e9f7253ae27c" alt="Footprint share API" style={{width: '300px', maxWidth: '100%', height: 'auto'}} className="shadow-lg" width="826" height="654" data-path="images/passport-sharing.png" />

#### PACT requirements

Details on the PACT standard and required fields can
be found [in the PACT documentation](https://wbcsd.github.io/data-exchange-protocol/v2).