sales-skills/sales-contentstack

Contentstack Platform Help

Step 1 — Gather context

If references/learnings.md exists, read it first for accumulated platform knowledge.

Ask the user:

1. What area of Contentstack do you need help with?

   • A) Content Management — content types, entries, assets, publishing
   • B) Content Delivery — CDA, GraphQL, caching, frontend integration
   • C) Launch — hosting, deployments, environments
   • D) Automate — workflow automations, triggers, connectors
   • E) Personalize — audiences, experiences, A/B tests, edge SDK
   • F) Brand Kit & AI — GenAI API, Knowledge Vault, voice profiles
   • G) API & SDKs — CMA/CDA endpoints, SDK setup, authentication
   • H) Marketplace — apps, extensions, custom fields
   • I) Migration — moving from another CMS to Contentstack
   • J) Admin — teams, roles, branches, environments, billing
   • K) Something else — describe it

2. What's your role?

   • A) Developer / engineer
   • B) Content editor / author
   • C) DevOps / platform admin
   • D) Marketing / digital team
   • E) Architect / tech lead
   • F) Other

3. What are you trying to accomplish? (describe your specific goal or question)

Skip-ahead rule: If the user's prompt already provides enough context, skip to Step 2.

Step 2 — Route or answer directly

If the request maps to a specialized skill, route:

• Tool integration / webhook setup → /sales-integration {your question}
• CRM data quality / enrichment → /sales-data-hygiene {your question}

Otherwise, answer directly using the platform reference.

Step 3 — Contentstack platform reference

Read references/platform-guide.md for the full platform reference — modules, pricing, integrations, data model, workflows.

Read references/contentstack-api-reference.md for API endpoints, authentication, rate limits, and SDK details.

Answer the user's question using only the relevant section. Don't dump the full reference.

Step 4 — Actionable guidance

You no longer need the full platform guide — focus on the user's specific situation.

1. Step-by-step instructions — numbered steps to accomplish their goal
2. Configuration recommendations — specific settings with navigation paths
3. Common pitfalls — what can go wrong and how to avoid it
4. For API questions — always point to references/contentstack-api-reference.md

If you discover a gotcha, workaround, or tip not covered in references/learnings.md, append it there.

Gotchas

Best-effort from research — review these, especially items about plan-gated features and integration gotchas that may be outdated.

• Preview takes ~15 minutes to reflect edits. Visual Builder and previews are configurable but don't update instantly. Publish and check the live site for accurate rendering. Content editors used to WYSIWYG get frustrated here.
• Localization is hidden under a dropdown. Managing localized content requires selecting locale from a dropdown per entry — there's no side-by-side comparison view. Workflows for localized content can be unintuitive.
• Rate limits are per-organization, not per-stack. CMA write: 10 req/s, CDA origin: 100 req/s. If multiple stacks share an org, they compete for the same rate limit pool.
• Management tokens max at 10 per stack. Authtokens max at 20 per user. Plan token allocation carefully for CI/CD pipelines and multi-service architectures.
• CDN-cached CDA responses are not rate-limited but origin requests (cache misses) are. Use sync tokens and webhooks for real-time updates instead of polling.
• Pricing is contract-based and opaque. No self-serve plans. Annual contracts $30K–$200K+ depending on entries, API calls, and environments. Always confirm plan limits before architecting.
• Limited built-in DAM. Asset management is basic. For advanced DAM (tagging, AI metadata, rights management), integrate a dedicated DAM via Marketplace.

Related skills

• /sales-integration — Connect Contentstack to CRM, marketing tools, or other systems via webhooks and API
• /sales-do — Not sure which skill to use? The router matches any sales objective to the right skill. Install: npx skills add sales-skills/sales --skill sales-do

Examples

Example 1: Content type design

User says: "How should I structure content types for a multi-brand website?" Skill does:

1. Reads platform guide for content type modeling patterns
2. Recommends using global fields for shared components, taxonomies for brand categorization
3. Explains branch strategy for multi-brand content isolation
4. Advises on reference fields vs embedded JSON for cross-brand content sharing Result: User has a content architecture plan with specific Contentstack patterns

Example 2: API integration

User says: "I need to fetch entries from Contentstack and display them in a Next.js app" Skill does:

1. Points to API reference for CDA endpoints and JavaScript Delivery SDK
2. Explains environment + delivery token auth pattern
3. Shows the sync endpoint for incremental updates vs polling
4. Recommends DataSync SDK for server-side rendering with local cache Result: User knows which SDK to use, how to authenticate, and how to keep content fresh

Example 3: Migration from WordPress

User says: "We're migrating 10,000 pages from WordPress to Contentstack" Skill does:

1. Reads platform guide's migration section
2. Recommends content modeling first — map WP post types to Contentstack content types
3. Explains CMA bulk import via API (entries endpoint + asset upload)
4. Warns about rate limits (10 write req/s) and suggests batching with backoff
5. Recommends branch strategy for staging migration before going live Result: User has a migration plan with API approach, rate limit strategy, and staging workflow

Troubleshooting

Entries not appearing on frontend

Symptom: Content published in CMS but not showing on the website Cause: CDA is CDN-cached; also check environment, locale, and publish status Solution: Verify the entry is published to the correct environment. Check the CDA response directly (GET /v3/content_types/{uid}/entries). If using CDN, wait for cache TTL or use the sync API. Confirm the delivery token matches the target environment.

Localization workflow confusion

Symptom: Edits to localized entries overwrite the master locale or don't appear Cause: Contentstack's locale fallback behavior — unlocalized fields fall back to the master locale Solution: Explicitly localize each field you want to differ by locale. Use include_fallback=true on CDA queries to see which fields are localized vs inherited. Set up per-locale publishing workflows to prevent accidental overwrites.

API authentication errors (412/401)

Symptom: API calls return 412 "Invalid API key" or 401 "Access Denied" Cause: Wrong API key type for the endpoint, expired token, or region mismatch Solution: CMA uses stack API key + authtoken/management token. CDA uses stack API key + delivery token. Verify your base URL matches your stack's region (AWS NA, EU, AU, Azure, GCP). Check token expiry — authtokens expire when the 20-token-per-user limit is hit (oldest evicted).