faststore-data-fetching

Extend the FastStore GraphQL API with typeDefs and resolvers for custom data sources.

39|9|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/vtex/ai-skills --skill faststore-data-fetching-vtex
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: faststore-data-fetching
Source: https://github.com/vtex/ai-skills/tree/main/tracks/faststore/skills/faststore-data-fetching
Command: npx skills add https://github.com/vtex/ai-skills --skill faststore-data-fetching-vtex

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

VTEX FastStore apps often need data from custom sources or external systems not exposed by the default GraphQL schema. This skill provides a structured approach to extend the GraphQL API to fetch and surface that data in a safe, server-resolved manner.

Core Features & Use Cases

  • Extend the VTEX GraphQL schema under src/graphql/vtex/ with typeDefs and resolvers to surface new data fields.
  • Support server-side data fetching through API extensions and server fragments for SSR and initial page load.
  • Integrate third-party data sources via src/graphql/thirdParty/ typeDefs and resolvers while keeping secrets server-side.

Quick Start

Configure and deploy a server-side or third-party data extension to fetch custom data via the FastStore GraphQL API.

Frequently Asked Questions about faststore-data-fetching

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fetch custom data in FastStore using GraphQL?

You fetch custom data by extending the FastStore GraphQL API with typeDefs and resolvers under src/graphql/vtex/ or src/graphql/thirdParty/ directories, ensuring safe server-resolved data retrieval.

How does server-side data fetching work for third-party APIs in FastStore?

Server-side data fetching for third-party APIs works by placing resolvers in src/graphql/thirdParty/ and keeping credentials server-side only, supporting both SSR and client rendering safely.

Can I use FastStore API extensions to support SSR and initial page load?

Yes, FastStore API extensions support Server-Side Rendering and initial page load by using server fragments and server resolvers to fetch and surface custom data during the initial render cycle.

What is the correct directory structure for extending the FastStore GraphQL schema?

The correct directory structure requires placing typeDefs and resolvers inside either src/graphql/vtex/ for VTEX data extensions or src/graphql/thirdParty/ for integrating external data sources.

Where should I store API credentials when integrating third-party data sources with FastStore?

When integrating third-party data sources with FastStore, you must store API credentials server-side only to keep secrets secure and prevent them from being exposed to the client.

Why extend the FastStore GraphQL API instead of fetching client-side?

Extending the FastStore GraphQL API enables server-side data fetching through API extensions, ensuring credentials remain secure and supporting both SSR fragments and client rendering without exposing secrets.