Find what you need in Gradial’s documentation — or follow a guided path if you’re just getting started.
Already using Gradial? Use the search bar above or the tabs to jump directly to what you need — Setup & Administration for integrations and access, Gradial in Action for workflows and features.
New to Gradial?
Pick the path that fits where you are right now and we’ll take you from there.
I'm evaluating Gradial
You want to understand what Gradial does, how it works, and whether it fits your team’s needs.
I'm setting up the platform
You’re an IT admin or technical lead connecting systems, provisioning access, and getting the environment production-ready.
I'm using Gradial daily
You’re a content manager, author, editor, or communications lead running tasks, updating content, and getting pages live.
I’m Evaluating Gradial
You want to understand what Gradial is, what it can do, and how it fits into your team’s existing workflows before committing to a full setup. This path gives you the full picture without requiring any credentials or configuration.
1
Understand what Gradial is and the problem it solves
Gradial is the secure enterprise marketing harness that turns a fragmented lifecycle into governed execution. This page covers the content supply chain problem, the systems-of-record vs. harness framing, what Gradial’s agents actually do, and the architectural decisions that differentiate it.What Is Gradial? →
2
Understand the enterprise marketing harness concept behind it
If “harness” is a new term, this page explains what an enterprise marketing harness is made of — tools, integrations, context, memory, workspace, and guardrails — how it differs from a point solution or a copilot, why it spans the whole marketing lifecycle rather than a single stage, and how the learning loop makes each campaign better than the last.What is an enterprise marketing harness? →
3
Learn how it works
Understand the mental model behind Gradial: how work comes in, the jobs Gradial does, how it executes across your stack, and how it builds a working understanding of your organization over time.How Gradial Works →
4
See what integrations are supported
Gradial connects to the CMS, project management, design, and marketing automation tools your team already uses. Review the full integrations list to confirm your stack is covered.Integrations Overview →
5
Understand the core workflows
Gradial organizes work into two main categories: updating existing content and creating new experiences. Read both overviews to understand the scope of what agents can handle.Content Updates → · New Page Workflow →
6
See cross-channel campaign execution in action
One of Gradial’s most powerful capabilities is turning a single campaign brief into fully built assets across every channel simultaneously — web pages, email templates, audience configuration, content updates — without per-channel tasking or coordination overhead.Cross-Channel Campaign Execution →
7
See how Gradial handles quality and compliance
Gradial enforces brand standards, SEO rules, and WCAG 2.2 AA accessibility compliance automatically. This is often a key differentiator for enterprise teams with strict governance requirements.QA Reports → · Accessibility Reports →
8
Review what's shipped recently
Check the release notes to see the current pace of product development and what capabilities have been added in recent months.Release Notes →
9
Talk to the team
Ready to go deeper? Request a demo to see Gradial running against your actual CMS and content — not a generic sandbox.Request a Demo →
I’m Setting Up the Platform
You own the technical foundation. Before anyone on your team can use Gradial, you need to connect your systems, configure access, and validate the environment. This path takes you from a freshly provisioned org to production-ready.Estimated time: 1–3 weeks (largely dependent on your IT team’s security review process)
1
Understand what you're setting up
Start with how Gradial works — what it connects to, how agents receive and execute work, and what systems are involved — before you touch any credentials.How Gradial Works →
2
Run environment discovery
Before connecting anything, work through Phase 1 of the onboarding checklist. It tells you exactly what your team needs to gather — example tickets, workflow docs, golden page candidates — before technical setup can begin.Onboarding Checklist →
3
Connect your CMS
This is the critical path. Connect Gradial to your primary CMS. Each integration requires specific service accounts and permission configurations — plan for security review time.
AEM (6.5 or Cloud)
OAuth 2.0 or IMS authentication, JCR permissions, technical account setup
Sitecore
XM Cloud, XP, or Content Hub — guided wizard setup
Contentful
Management and Delivery API tokens, space and environment scoping
Gradial works directly from tickets in Jira, Workfront, Wrike, and others. Connecting your ticketing system activates the queue automation that makes Gradial most valuable for content teams day-to-day.Set Up Ticketing Integrations →
5
Configure SSO
Connect Gradial to your identity provider to enable single sign-on. Supported: Microsoft Entra ID, Okta OIDC, and custom OIDC.Configure SSO →
6
Set roles and invite your team
Define who can do what. Gradial has organization-level and workspace-level roles. Invite your admins, content leads, and editors, and assign appropriate permissions before handing off to content teams.Roles & Permissions → · Manage Team Members →
7
Validate and hand off
Complete Phases 3 and 4 of the onboarding checklist — confirm integrations are live, run sandbox validation, and sign off with your Gradial contact before content teams begin using the platform.Onboarding Checklist: Phases 3 & 4 →
The single most common delay in Gradial onboarding is IT provisioning and security reviews. Submit a single, consolidated credential request rather than individual asks spread out over time — it can cut weeks off your timeline.
I’m Using Gradial Daily
You’re a content manager, author, editor, communications lead, or team owner running tasks and getting content live. This path covers the operational skills you need — starting with the basics and building toward more complex workflows and quality configuration.Estimated time: 2–4 hours to get comfortable with the basics; add new workflows as you go
1
Get oriented in the platform
Start by learning how the platform is laid out — where tasks live, how workspaces are organized, and how to navigate between projects.Navigating the Platform →
2
Learn how to brief an agent
The quality of what Gradial produces depends heavily on how you describe the task. Read the prompting guide before running your first task — it will save you from multiple re-runs and frustration.Prompting an AI Agent →
3
Run your first content update
Start small: a copy change, a link swap, a styling fix. These are fast, low-risk, and a good way to learn the task loop — brief → run → review → stage → publish.Change Copy, Links or Images on a Page →
4
Take on work that spans more than one page
Once you’re comfortable, tackle more involved work: component swaps, batched changes, find-and-replace across pages, and reusable content blocks that appear in many places.Rework Sections and Reusable Content →
5
Create a new page
Learn the four ways to create a new page in Gradial: copying an existing page, using design patterns, working from a Word doc or creative brief, or importing a Figma design.New Page Workflow →
6
Validate your work before it goes live
Before content publishes, run a QA report to catch brand and compliance issues, and an accessibility report to validate WCAG 2.2 AA conformance.QA Reports → · Accessibility Reports →
7
Work directly from your ticketing system
Once you’re comfortable running tasks manually, learn how Gradial picks up tickets from Jira, Workfront, or Wrike automatically — so you can execute directly from your existing workflow without copy-pasting between tools.How Gradial Works with Ticketing →
8
Configure quality standards for your team
If you’re a content lead or strategist responsible for how agents behave, the next step is setting up golden pages, design patterns, and QA rules. This is what scales quality across your entire team.Golden Pages → · Design Pattern Ingestion → · QA Rules Manager →
The fastest way to improve output quality is better prompts, not re-running the same task. If a result isn’t what you expected, revisit the Prompting Guide before trying again — a clearer objective and one concrete example makes more difference than anything else.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Gradial Docs","colors":{"primary":"#a855f7","light":"#c084fc","dark":"#9333ea"},"logo":{"light":"https://mintcdn.com/gradial/RDiUqPSUUpbMwk4U/logo/light.svg?fit=max\u0026auto=format\u0026n=RDiUqPSUUpbMwk4U\u0026q=85\u0026s=3d465cd433ac4e5548cef9e2ca1c64f0","dark":"https://mintcdn.com/gradial/RDiUqPSUUpbMwk4U/logo/dark.svg?fit=max\u0026auto=format\u0026n=RDiUqPSUUpbMwk4U\u0026q=85\u0026s=9dd2ca4128b8734f5710af7f0ca4b65b"},"favicon":"https://mintcdn.com/gradial/jdrFNwtyKAIPgKH0/favicon.svg?fit=max\u0026auto=format\u0026n=jdrFNwtyKAIPgKH0\u0026q=85\u0026s=13e36fc9cd74b4fa6565594562d21961","navbar":{"links":[{"href":"https://app.gradial.com","label":"Log In"},{"href":"https://portal.usepylon.com/gradial","label":"Support"}],"primary":{"type":"button","label":"Request Demo","href":"https://www.gradial.com/request-demo"}},"footer":{"links":[{"header":"Gradial","items":[{"label":"Home","href":"https://www.gradial.com"},{"label":"Partners","href":"https://www.gradial.com/partnership"},{"label":"Blog","href":"https://www.gradial.com/blog"}]},{"header":"Resources","items":[{"label":"Support","href":"https://portal.usepylon.com/gradial"},{"label":"Release Notes","href":"/release-notes/overview"}]}]},"seo":{"metatags":{"canonical":"https://docs.gradial.com"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"gradial","hasAudioNarration":false,"actualSubdomain":"gradial","customDomains":["docs.gradial.com"],"gitSource":{"type":"github","owner":"gradial","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"issues":true,"edits":true,"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af50ad8f21a7890c576e79a","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"Setup \u0026 Administration","count":58},{"language":"default","tag":"Integrations","count":43},{"language":"default","tag":"Gradial in Action","count":41},{"language":"default","tag":"Gradial ACI","count":22},{"language":"default","tag":"Documentation","count":22},{"language":"default","tag":"Getting Started","count":20},{"language":"default","tag":"CMS \u0026 DAM","count":20},{"language":"default","tag":"Content Management","count":10},{"language":"default","tag":"Ticketing Systems","count":10},{"language":"default","tag":"Marketing Automation","count":10}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"docs/getting-started/start-here","slug":"/docs/getting-started/start-here","pageMetadata":{"title":"Start Here","description":"Find what you need in Gradial's documentation — or follow a guided path if you're just getting started.","mode":"wide","href":"/docs/getting-started/start-here"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Find what you need in Gradial’s documentation — or follow a guided path if you’re just getting started.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,hr:`hr`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Card,CardGroup,Heading,Step,Steps,Tip,Warning}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Already using Gradial?`}),` Use the search bar above or the tabs to jump directly to what you need — `,_jsx(_components.strong,{children:`Setup \u0026 Administration`}),` for integrations and access, `,_jsx(_components.strong,{children:`Gradial in Action`}),` for workflows and features.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`new-to-gradial`,children:`New to Gradial?`}),`\n`,_jsx(_components.p,{children:`Pick the path that fits where you are right now and we’ll take you from there.`}),`\n`,_jsxs(CardGroup,{cols:3,children:[_jsx(Card,{title:`I'm evaluating Gradial`,icon:`magnifying-glass`,href:`#im-evaluating-gradial`,children:_jsx(_components.p,{children:`You want to understand what Gradial does, how it works, and whether it fits your team’s needs.`})}),_jsx(Card,{title:`I'm setting up the platform`,icon:`server`,href:`#im-setting-up-the-platform`,children:_jsx(_components.p,{children:`You’re an IT admin or technical lead connecting systems, provisioning access, and getting the environment production-ready.`})}),_jsx(Card,{title:`I'm using Gradial daily`,icon:`bolt`,href:`#im-using-gradial-daily`,children:_jsx(_components.p,{children:`You’re a content manager, author, editor, or communications lead running tasks, updating content, and getting pages live.`})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(`a`,{id:`im-evaluating-gradial`}),`\n`,_jsx(Heading,{level:`2`,id:`i’m-evaluating-gradial`,children:`I’m Evaluating Gradial`}),`\n`,_jsx(_components.p,{children:`You want to understand what Gradial is, what it can do, and how it fits into your team’s existing workflows before committing to a full setup. This path gives you the full picture without requiring any credentials or configuration.`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Understand what Gradial is and the problem it solves`,children:[_jsx(_components.p,{children:`Gradial is the secure enterprise marketing harness that turns a fragmented lifecycle into governed execution. This page covers the content supply chain problem, the systems-of-record vs. harness framing, what Gradial’s agents actually do, and the architectural decisions that differentiate it.`}),_jsx(_components.p,{children:_jsx(_components.a,{href:`/docs/getting-started/what-is-gradial`,children:`What Is Gradial? →`})})]}),_jsxs(Step,{title:`Understand the enterprise marketing harness concept behind it`,children:[_jsx(_components.p,{children:`If “harness” is a new term, this page explains what an enterprise marketing harness is made of — tools, integrations, context, memory, workspace, and guardrails — how it differs from a point solution or a copilot, why it spans the whole marketing lifecycle rather than a single stage, and how the learning loop makes each campaign better than the last.`}),_jsx(_components.p,{children:_jsx(_components.a,{href:`/docs/getting-started/what-is-an-agentic-harness`,children:`What is an enterprise marketing harness? →`})})]}),_jsxs(Step,{title:`Learn how it works`,children:[_jsx(_components.p,{children:`Understand the mental model behind Gradial: how work comes in, the jobs Gradial does, how it executes across your stack, and how it builds a working understanding of your organization over time.`}),_jsx(_components.p,{children:_jsx(_components.a,{href:`/docs/getting-started/how-gradial-works`,children:`How Gradial Works →`})})]}),_jsxs(Step,{title:`See what integrations are supported`,children:[_jsx(_components.p,{children:`Gradial connects to the CMS, project management, design, and marketing automation tools your team already uses. Review the full integrations list to confirm your stack is covered.`}),_jsx(_components.p,{children:_jsx(_components.a,{href:`/docs/integrations-administration-and-setup/integrations/get-started-with-integrations`,children:`Integrations Overview →`})})]}),_jsxs(Step,{title:`Understand the core workflows`,children:[_jsx(_components.p,{children:`Gradial organizes work into two main categories: updating existing content and creating new experiences. Read both overviews to understand the scope of what agents can handle.`}),_jsxs(_components.p,{children:[_jsx(_components.a,{href:`/docs/updating-existing-experiences-i-e-content-updates/content-updates`,children:`Content Updates →`}),` · `,_jsx(_components.a,{href:`/docs/creating-new-experiences/new-page`,children:`New Page Workflow →`})]})]}),_jsxs(Step,{title:`See cross-channel campaign execution in action`,children:[_jsx(_components.p,{children:`One of Gradial’s most powerful capabilities is turning a single campaign brief into fully built assets across every channel simultaneously — web pages, email templates, audience configuration, content updates — without per-channel tasking or coordination overhead.`}),_jsx(_components.p,{children:_jsx(_components.a,{href:`/docs/campaign-management/cross-channel-campaigns`,children:`Cross-Channel Campaign Execution →`})})]}),_jsxs(Step,{title:`See how Gradial handles quality and compliance`,children:[_jsx(_components.p,{children:`Gradial enforces brand standards, SEO rules, and WCAG 2.2 AA accessibility compliance automatically. This is often a key differentiator for enterprise teams with strict governance requirements.`}),_jsxs(_components.p,{children:[_jsx(_components.a,{href:`/docs/quality-assurance-and-accessibility/qa-report`,children:`QA Reports →`}),` · `,_jsx(_components.a,{href:`/docs/quality-assurance-and-accessibility/accessibility-report`,children:`Accessibility Reports →`})]})]}),_jsxs(Step,{title:`Review what's shipped recently`,children:[_jsx(_components.p,{children:`Check the release notes to see the current pace of product development and what capabilities have been added in recent months.`}),_jsx(_components.p,{children:_jsx(_components.a,{href:`/release-notes/overview`,children:`Release Notes →`})})]}),_jsxs(Step,{title:`Talk to the team`,children:[_jsx(_components.p,{children:`Ready to go deeper? Request a demo to see Gradial running against your actual CMS and content — not a generic sandbox.`}),_jsx(_components.p,{children:_jsx(_components.a,{href:`https://www.gradial.com/request-demo`,children:`Request a Demo →`})})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(`a`,{id:`im-setting-up-the-platform`}),`\n`,_jsx(Heading,{level:`2`,id:`i’m-setting-up-the-platform`,children:`I’m Setting Up the Platform`}),`\n`,_jsx(_components.p,{children:`You own the technical foundation. Before anyone on your team can use Gradial, you need to connect your systems, configure access, and validate the environment. This path takes you from a freshly provisioned org to production-ready.`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Estimated time:`}),` 1–3 weeks (largely dependent on your IT team’s security review process)`]}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Understand what you're setting up`,children:[_jsx(_components.p,{children:`Start with how Gradial works — what it connects to, how agents receive and execute work, and what systems are involved — before you touch any credentials.`}),_jsx(_components.p,{children:_jsx(_components.a,{href:`/docs/getting-started/how-gradial-works`,children:`How Gradial Works →`})})]}),_jsxs(Step,{title:`Run environment discovery`,children:[_jsx(_components.p,{children:`Before connecting anything, work through Phase 1 of the onboarding checklist. It tells you exactly what your team needs to gather — example tickets, workflow docs, golden page candidates — before technical setup can begin.`}),_jsx(_components.p,{children:_jsx(_components.a,{href:`/docs/getting-started/onboarding-checklist`,children:`Onboarding Checklist →`})})]}),_jsxs(Step,{title:`Connect your CMS`,children:[_jsx(_components.p,{children:`This is the critical path. Connect Gradial to your primary CMS. Each integration requires specific service accounts and permission configurations — plan for security review time.`}),_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`AEM (6.5 or Cloud)`,icon:`layer-group`,href:`/docs/integrations-administration-and-setup/integrations/aem/aem-overview`,children:_jsx(_components.p,{children:`OAuth 2.0 or IMS authentication, JCR permissions, technical account setup`})}),_jsx(Card,{title:`Sitecore`,icon:`layer-group`,href:`/docs/integrations-administration-and-setup/integrations/sitecore-integration`,children:_jsx(_components.p,{children:`XM Cloud, XP, or Content Hub — guided wizard setup`})}),_jsx(Card,{title:`Contentful`,icon:`layer-group`,href:`/docs/integrations-administration-and-setup/integrations/contentful`,children:_jsx(_components.p,{children:`Management and Delivery API tokens, space and environment scoping`})}),_jsx(Card,{title:`Contentstack, Sanity, Drupal, WordPress`,icon:`layer-group`,href:`/docs/integrations-administration-and-setup/integrations/get-started-with-integrations`,children:_jsx(_components.p,{children:`API token or service account setup per platform`})})]}),_jsxs(_components.p,{children:[`Also connecting a marketing or email platform? See `,_jsx(_components.a,{href:`/docs/integrations-administration-and-setup/integrations/marketo`,children:`Marketo`}),`, `,_jsx(_components.a,{href:`/docs/integrations-administration-and-setup/integrations/salesforce-marketing-cloud`,children:`Salesforce Marketing Cloud`}),`, and `,_jsx(_components.a,{href:`/docs/integrations-administration-and-setup/integrations/get-started-with-integrations`,children:`all integrations`}),`.`]})]}),_jsxs(Step,{title:`Connect your ticketing system`,children:[_jsx(_components.p,{children:`Gradial works directly from tickets in Jira, Workfront, Wrike, and others. Connecting your ticketing system activates the queue automation that makes Gradial most valuable for content teams day-to-day.`}),_jsx(_components.p,{children:_jsx(_components.a,{href:`/docs/integrations-administration-and-setup/how-gradial-works-with-ticketing-systems/setting-up-ticketing-integrations`,children:`Set Up Ticketing Integrations →`})})]}),_jsxs(Step,{title:`Configure SSO`,children:[_jsx(_components.p,{children:`Connect Gradial to your identity provider to enable single sign-on. Supported: Microsoft Entra ID, Okta OIDC, and custom OIDC.`}),_jsx(_components.p,{children:_jsx(_components.a,{href:`/docs/integrations-administration-and-setup/managing-access/sso`,children:`Configure SSO →`})})]}),_jsxs(Step,{title:`Set roles and invite your team`,children:[_jsx(_components.p,{children:`Define who can do what. Gradial has organization-level and workspace-level roles. Invite your admins, content leads, and editors, and assign appropriate permissions before handing off to content teams.`}),_jsxs(_components.p,{children:[_jsx(_components.a,{href:`/docs/integrations-administration-and-setup/managing-access/roles`,children:`Roles \u0026 Permissions →`}),` · `,_jsx(_components.a,{href:`/docs/integrations-administration-and-setup/managing-access/manage-team-members`,children:`Manage Team Members →`})]})]}),_jsxs(Step,{title:`Validate and hand off`,children:[_jsx(_components.p,{children:`Complete Phases 3 and 4 of the onboarding checklist — confirm integrations are live, run sandbox validation, and sign off with your Gradial contact before content teams begin using the platform.`}),_jsx(_components.p,{children:_jsx(_components.a,{href:`/docs/getting-started/onboarding-checklist`,children:`Onboarding Checklist: Phases 3 \u0026 4 →`})})]})]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`The single most common delay in Gradial onboarding is IT provisioning and security reviews. Submit a single, consolidated credential request rather than individual asks spread out over time — it can cut weeks off your timeline.`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(`a`,{id:`im-using-gradial-daily`}),`\n`,_jsx(Heading,{level:`2`,id:`i’m-using-gradial-daily`,children:`I’m Using Gradial Daily`}),`\n`,_jsx(_components.p,{children:`You’re a content manager, author, editor, communications lead, or team owner running tasks and getting content live. This path covers the operational skills you need — starting with the basics and building toward more complex workflows and quality configuration.`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Estimated time:`}),` 2–4 hours to get comfortable with the basics; add new workflows as you go`]}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Get oriented in the platform`,children:[_jsx(_components.p,{children:`Start by learning how the platform is laid out — where tasks live, how workspaces are organized, and how to navigate between projects.`}),_jsx(_components.p,{children:_jsx(_components.a,{href:`/docs/getting-started/navigating-the-platform`,children:`Navigating the Platform →`})})]}),_jsxs(Step,{title:`Learn how to brief an agent`,children:[_jsx(_components.p,{children:`The quality of what Gradial produces depends heavily on how you describe the task. Read the prompting guide before running your first task — it will save you from multiple re-runs and frustration.`}),_jsx(_components.p,{children:_jsx(_components.a,{href:`/docs/getting-started/ask-grady`,children:`Prompting an AI Agent →`})})]}),_jsxs(Step,{title:`Run your first content update`,children:[_jsx(_components.p,{children:`Start small: a copy change, a link swap, a styling fix. These are fast, low-risk, and a good way to learn the task loop — brief → run → review → stage → publish.`}),_jsx(_components.p,{children:_jsx(_components.a,{href:`/docs/updating-existing-experiences-i-e-content-updates/small-content-updates`,children:`Change Copy, Links or Images on a Page →`})})]}),_jsxs(Step,{title:`Take on work that spans more than one page`,children:[_jsx(_components.p,{children:`Once you’re comfortable, tackle more involved work: component swaps, batched changes, find-and-replace across pages, and reusable content blocks that appear in many places.`}),_jsx(_components.p,{children:_jsx(_components.a,{href:`/docs/updating-existing-experiences-i-e-content-updates/medium-content-updates-in-gradial`,children:`Rework Sections and Reusable Content →`})})]}),_jsxs(Step,{title:`Create a new page`,children:[_jsx(_components.p,{children:`Learn the four ways to create a new page in Gradial: copying an existing page, using design patterns, working from a Word doc or creative brief, or importing a Figma design.`}),_jsx(_components.p,{children:_jsx(_components.a,{href:`/docs/creating-new-experiences/new-page`,children:`New Page Workflow →`})})]}),_jsxs(Step,{title:`Validate your work before it goes live`,children:[_jsx(_components.p,{children:`Before content publishes, run a QA report to catch brand and compliance issues, and an accessibility report to validate WCAG 2.2 AA conformance.`}),_jsxs(_components.p,{children:[_jsx(_components.a,{href:`/docs/quality-assurance-and-accessibility/qa-report`,children:`QA Reports →`}),` · `,_jsx(_components.a,{href:`/docs/quality-assurance-and-accessibility/accessibility-report`,children:`Accessibility Reports →`})]})]}),_jsxs(Step,{title:`Work directly from your ticketing system`,children:[_jsx(_components.p,{children:`Once you’re comfortable running tasks manually, learn how Gradial picks up tickets from Jira, Workfront, or Wrike automatically — so you can execute directly from your existing workflow without copy-pasting between tools.`}),_jsx(_components.p,{children:_jsx(_components.a,{href:`/docs/integrations-administration-and-setup/how-gradial-works-with-ticketing-systems/setting-up-ticketing-integrations`,children:`How Gradial Works with Ticketing →`})})]}),_jsxs(Step,{title:`Configure quality standards for your team`,children:[_jsx(_components.p,{children:`If you’re a content lead or strategist responsible for how agents behave, the next step is setting up golden pages, design patterns, and QA rules. This is what scales quality across your entire team.`}),_jsxs(_components.p,{children:[_jsx(_components.a,{href:`/docs/creating-new-experiences/golden-pages`,children:`Golden Pages →`}),` · `,_jsx(_components.a,{href:`/docs/creating-new-experiences/design-pattern-ingestion`,children:`Design Pattern Ingestion →`}),` · `,_jsx(_components.a,{href:`/docs/quality-assurance-and-accessibility/qa-report`,children:`QA Rules Manager →`})]})]})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`The fastest way to improve output quality is better prompts, not re-running the same task. If a result isn’t what you expected, revisit the `,_jsx(_components.a,{href:`/docs/getting-started/ask-grady`,children:`Prompting Guide`}),` before trying again — a clearer objective and one concrete example makes more difference than anything else.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Start Here","description":"Find what you need in Gradial's documentation — or follow a guided path if you're just getting started.","mode":"wide","href":"/docs/getting-started/start-here"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"New to Gradial?","slug":"new-to-gradial","depth":2,"children":[]},{"title":"I’m Evaluating Gradial","slug":"i’m-evaluating-gradial","depth":2,"children":[]},{"title":"I’m Setting Up the Platform","slug":"i’m-setting-up-the-platform","depth":2,"children":[]},{"title":"I’m Using Gradial Daily","slug":"i’m-using-gradial-daily","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"gradial","siteName":"Gradial Docs","title":"Start Here - Gradial Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-31T17:15:57.207Z","originalFileLocation":"docs/getting-started/start-here.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Find what you need in Gradial\u0026#x27;s documentation — or follow a guided path if you\u0026#x27;re just getting started.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Gradial Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/gradial/7-i2K-jVJenc4URQ/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/gradial/7-i2K-jVJenc4URQ/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/gradial/7-i2K-jVJenc4URQ/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/gradial/7-i2K-jVJenc4URQ/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/gradial/7-i2K-jVJenc4URQ/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/gradial/7-i2K-jVJenc4URQ/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/gradial/7-i2K-jVJenc4URQ/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/gradial/7-i2K-jVJenc4URQ/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/gradial/7-i2K-jVJenc4URQ/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Start Here - Gradial Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Find what you need in Gradial\u0026#x27;s documentation — or follow a guided path if you\u0026#x27;re just getting started.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Gradial Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.gradial.com/docs/getting-started/start-here\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://gradial.mintlify.site/_mintlify/api/og/v2?division=Getting+Started\u0026amp;title=Start+Here\u0026amp;description=Find+what+you+need+in+Gradial%27s+documentation+%E2%80%94+or+follow+a+guided+path+if+you%27re+just+getting+started.\u0026amp;theme=4c2c037ea57a1cc347c893b9\u0026amp;signature=1638f30c91eb3d8bd63e2595da1cc7abd23118b8ee7d3c277e794b8927f17c98\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Start Here - Gradial Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Find what you need in Gradial\u0026#x27;s documentation — or follow a guided path if you\u0026#x27;re just getting started.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://gradial.mintlify.site/_mintlify/api/og/v2?division=Getting+Started\u0026amp;title=Start+Here\u0026amp;description=Find+what+you+need+in+Gradial%27s+documentation+%E2%80%94+or+follow+a+guided+path+if+you%27re+just+getting+started.\u0026amp;theme=4c2c037ea57a1cc347c893b9\u0026amp;signature=1638f30c91eb3d8bd63e2595da1cc7abd23118b8ee7d3c277e794b8927f17c98\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/gradial/7-i2K-jVJenc4URQ/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Gradial Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#a855f7\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.gradial.com/docs/getting-started/start-here\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/getting-started/start-here.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.gradial.com/#organization\",\"name\":\"Gradial Docs\",\"url\":\"https://docs.gradial.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/gradial/RDiUqPSUUpbMwk4U/logo/light.svg?fit=max\u0026auto=format\u0026n=RDiUqPSUUpbMwk4U\u0026q=85\u0026s=3d465cd433ac4e5548cef9e2ca1c64f0\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.gradial.com#website\",\"name\":\"Gradial Docs\",\"url\":\"https://docs.gradial.com\",\"publisher\":{\"@id\":\"https://docs.gradial.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.gradial.com/docs/getting-started/start-here#webpage\",\"url\":\"https://docs.gradial.com/docs/getting-started/start-here\",\"name\":\"Start Here\",\"description\":\"Find what you need in Gradial's documentation — or follow a guided path if you're just getting started.\",\"dateModified\":\"2026-08-31T17:15:57.207Z\",\"isPartOf\":{\"@id\":\"https://docs.gradial.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.gradial.com/docs/getting-started/start-here#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.gradial.com/docs/getting-started/start-here#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Getting Started\",\"item\":\"https://docs.gradial.com/docs/getting-started/what-is-gradial\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Start Here\",\"item\":\"https://docs.gradial.com/docs/getting-started/start-here\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.gradial.com/docs/getting-started/start-here#article\",\"headline\":\"Start Here\",\"name\":\"Start Here\",\"description\":\"Find what you need in Gradial's documentation — or follow a guided path if you're just getting started.\",\"url\":\"https://docs.gradial.com/docs/getting-started/start-here\",\"mainEntityOfPage\":{\"@id\":\"https://docs.gradial.com/docs/getting-started/start-here#webpage\"},\"dateModified\":\"2026-08-31T17:15:57.207Z\",\"publisher\":{\"@id\":\"https://docs.gradial.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.gradial.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Gradial Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Gradial Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/getting-started/start-here.md","siteName":"Gradial Docs","nav":{"global":null,"tabs":[{"tab":"Getting Started","groups":[{"group":"Getting Started","pages":[{"title":"What Is Gradial?","href":"/docs/getting-started/what-is-gradial"},{"title":"What Is an Enterprise Marketing Harness?","description":"An enterprise marketing harness is the scaffolding around an AI model that makes it do real marketing work — tools, integrations, context, memory, workspace, and guardrails. Gradial is that harness, built for enterprise marketing operations.","href":"/docs/getting-started/what-is-an-agentic-harness"},{"title":"Start Here","mode":"wide","href":"/docs/getting-started/start-here"},{"title":"How Gradial Works","description":"The mental model behind Gradial: how agents receive work, execute it across your stack, and get smarter about your organization over time.","href":"/docs/getting-started/how-gradial-works"},{"title":"Navigating the Gradial Platform","href":"/docs/getting-started/navigating-the-platform"},{"title":"Ask Grady","href":"/docs/getting-started/ask-grady"},{"title":"Onboarding Checklist","href":"/docs/getting-started/onboarding-checklist"}]},{"group":"Support","pages":[{"title":"Customer Support Portal","href":"/support-portal"},{"title":"Frequently Asked Questions","href":"/docs/faqs/faqs"},{"group":"Gradial Certification","hidden":true,"pages":[{"title":"Certification Program","href":"/certification"}]}]}]},{"tab":"Gradial in Action","pages":[{"title":"Gradial in Action","href":"/docs/gradial-prompt-library/customer-use-cases"}]},{"tab":"Setup \u0026 Administration","pages":[{"title":"Setup \u0026 Administration","href":"/docs/integrations-administration-and-setup/integrations/get-started-with-integrations"}]},{"tab":"Release Notes","pages":[{"title":"Release Notes","href":"/release-notes/overview"}]},{"tab":"Gradial ACI","hidden":true,"searchable":true,"pages":[{"title":"Gradial ACI","href":"/aci/getting-started/what-is-gradial-aci"}]}]},"basePath":"","title":"Start Here - Gradial Docs","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":[],"chunks":[]}