{"id":28545,"date":"2025-07-01T10:42:31","date_gmt":"2025-07-01T14:42:31","guid":{"rendered":"https:\/\/plumrocket.com\/docs\/?p=28545"},"modified":"2025-07-01T10:51:48","modified_gmt":"2025-07-01T14:51:48","slug":"how-to-create-and-configure-the-well-known-gpc-json-file-in-magento-2-cloud","status":"publish","type":"post","link":"https:\/\/plumrocket.com\/docs\/magento-2-cloud-well-known-gpc-json-file-creation-and-configuration","title":{"rendered":"How to create and configure the .well-known\/gpc.json file in Magento 2 Cloud"},"content":{"rendered":"\n

What is the .well-known\/gpc.json file, what is it used for, and how is it created?<\/h2>\n\n\n\n

The .well-known\/gpc.json<\/strong> file, located in the web root directory, informs browsers and privacy tools about your website\u2019s support for Global Privacy Control (GPC).. It contains information about the current status of GPC signal processing (enabled or disabled), version, and the date of the last update.<\/p>\n\n\n\n


The extension automatically creates the JSON file during installation. Each time the admin changes the Enabled <\/strong>switcher position in GPC configurations<\/strong> or updates the Last Update Date<\/strong> value in the \u201cGPC .well-known Settings<\/strong>\u201d, the system generates the gpc.json<\/strong> file in the .well-known directory<\/strong>, allowing third-party services to download and read it.<\/p>\n\n\n\n

Why doesn’t the file get created and updated automatically on Magento 2 Cloud?<\/h2>\n\n\n\n

The creation and updating of the .well-known\/gpc.json<\/strong> file in Magento Cloud differ from the standard automatic process.<\/p>\n\n\n\n

Magento Cloud has limitations related to file system access and editing, which can prevent the automatic creation or updating of this file. This may prevent the module from automatically creating and updating the file. As a result, the file won\u2019t be created, and won\u2019t be available from the frontend. If this occurs, you\u2019ll see corresponding messages in the Magento logs and in the \u201cGPC .well-known Settings<\/strong>\u201d configuration section.<\/p>\n\n\n\n

The .well-known\/gpc.json file configuration in Magento 2 Cloud<\/h2>\n\n\n\n

Step 1. gpc.json generation<\/h3>\n\n\n\n

Option A – via extension in the local dev<\/strong><\/p>\n\n\n\n

This is the simplest way to create the needed file. In a local development environment, it’s enough to set the target extension configurations. After saving configurations, the .well-known\/gpc.json<\/strong> file will be automatically updated accordingly.<\/p>\n\n\n\n

Option B – manually in the local dev<\/strong><\/p>\n\n\n\n

In the project root, run the command that will create the required folder in the web root and generate the file with the sample structure:
<\/p>\n\n\n\n

<\/div>
mkdir <web root>\/.well-known\ncat > <web root>\/.well-known\/gpc.json << 'EOF'\n{\n    \"gpc\": true,\n    \"version\": \"1.0\",\n    \"created\": \"2025-06-24\"\n}\nEOF<\/code><\/pre><\/div>\n\n\n\n
\n
In the file content, it is necessary to update the following values to the specific ones:<\/p>\n\n\n\n