--- title: "IGDB" description: "Match your game products to IGDB and fill in their details, artwork and ratings from it." url: "https://docs.poltura.com/en/apps/igdb/" lang: en alternates: en: "https://docs.poltura.com/en/apps/igdb/" hu: "https://docs.poltura.com/hu/apps/igdb/" --- # IGDB Match your game products to IGDB and fill in their details, artwork and ratings from it. - Where: Apps → IGDB IGDB is a public database of video games. The IGDB app finds your game products in it, physical and digital alike. Then it fills in game details, artwork, ratings and popularity. It is for stores that sell games. The app only adds to your catalog and plays no part at checkout. ![The IGDB page with the Connected badge, the Connection and Refresh policy cards, and the Status and Matching review panels on the right](https://docs.poltura.com/screenshots/en/apps/igdb.webp) _Once the Twitch credentials are saved, the page shows Connected._ ## Before you start - IGDB signs in through Twitch. Create an application in the Twitch developer console (`https://dev.twitch.tv/console/apps`) and copy its Client ID and Client Secret. - Optional: a SteamGridDB API key for covers and screenshots, and a RAWG API key for Metacritic scores. ## Set up IGDB 1. Open **App Store** in the sidebar and choose **IGDB**. 2. Select **Install**. See [App Store](https://docs.poltura.com/en/apps/#install). 3. Under **Settings**, fill in **Twitch client ID** and **Twitch client secret**, then select **Save**. 4. Select **Check the credentials**. **The credentials work.** confirms them. 5. Select **Turn on**. 6. Open **IGDB** in the **Apps** group of the sidebar. The page title shows **Connected**. Saving the credentials does not change any product. IGDB is only asked when a product is matched. ## Settings The fields are in the app's **Settings** in the App Store. The first four can also be edited on the **IGDB** page, under **Connection** and **Refresh policy**. - **Twitch client ID**: the Client ID of your Twitch application. Stored encrypted and never shown again after saving. Change it with **Replace client ID**. - **Twitch client secret**: the Client Secret that belongs to it. Stored encrypted and never shown again. Change it with **Replace client secret**. - **Protect merchant-edited fields**: on to begin with. Fields you have edited or protected stay as they are when IGDB data is refreshed, until you unlock them. - **Auto-confirm unique exact title matches** (on the page: **Auto-confirm unique exact titles**): on to begin with. A match is confirmed on its own only when exactly one game has exactly the same title. The first search result is never accepted just because it is first. - **SteamGridDB API key**: optional. Used for cover and screenshot artwork of imported games. Stored encrypted. - **RAWG API key**: optional. Used for Metacritic scores of imported games. Stored encrypted. On the IGDB page, **Validate credentials** tests the Twitch credentials and **Save settings** stores your changes. ## Match a product to a game Every product page has an **IGDB** panel. 1. Open the product from **Products**. 2. In the **IGDB** panel, check **Title to match**. Shorten it to the plain game title if the product name carries extras such as the platform or edition. 3. Select **Search IGDB**. The panel lists the games found under **Candidates**, each with a confidence value. 4. Choose the right game in **Candidates** and select **Confirm this game**. The panel now shows the **IGDB game ID** and the **Matched title**. 5. If the match is wrong, select **Reject match** and search again with a different title. ## Keep your own text when data is refreshed After a match, the panel shows a button for each field that IGDB can fill. - **Protect field** keeps your own value in that field: a refresh from IGDB leaves it alone. - **Unlock field** lets IGDB data overwrite the field again. With **Protect merchant-edited fields** switched on, fields you edited by hand are treated the same way without pressing anything. ## Review matches that are waiting Under **Matching review**, the **IGDB** page lists the products whose match could not be confirmed on its own. Each row shows the **Product**, the **Searched title** and the **Candidate**. Open the product and confirm or reject the match in its **IGDB** panel. When nothing is waiting, the list says so. ## Good to know - The app works for physical and digital game products. - Popularity from IGDB is refreshed regularly in the background. - While the app is turned on, the product page shows the game's PEGI age mark and Metacritic score next to the title. The PEGI mark comes from the product's **PEGI** attribute; turn the app off and both disappear. - Importing games for digital products is described under [Digital products](https://docs.poltura.com/en/products/digital-products/#game-import). ## If something goes wrong - **The panel says "IGDB is not connected."** The Twitch credentials are missing. Add them on the **IGDB** page or in the app's settings. - **"Validation failed".** The Client ID and Client Secret do not belong together, or the secret was regenerated in the Twitch developer console. Copy both again. - **No candidates are found.** Search with the plain game title, without platform, edition or region. - **A refresh overwrote your description.** Switch **Protect merchant-edited fields** to **Yes**, or select **Protect field** for that field on the product. - **Covers or Metacritic scores are missing.** Add the **SteamGridDB API key** or the **RAWG API key** in the app's settings. ## Related - [App Store](https://docs.poltura.com/en/apps/) - [Digital products](https://docs.poltura.com/en/products/digital-products/) - [Edit a product](https://docs.poltura.com/en/products/edit-a-product/) - [Attributes](https://docs.poltura.com/en/products/attributes/) - [CodesWholesale](https://docs.poltura.com/en/apps/codeswholesale/)