Getting Started on Your Marketo Governance and Training Documentation

Meghana_Rao1
Marketo Employee
Marketo Employee

“Imagine you win the lottery today and quit your job tomorrow. Would someone be able to step right in and take over your Marketo instance?” This is the mindset Tori Forte, Marketo consultant extraordinaire, recommends as you’re thinking about documenting your Marketo instance. In fact, good documentation can be nearly as important as the actual implementation itself. Keeping track of changes and decisions you’ve made during your instance setup can help you:

  • More easily train additional users in a scalable way
  • Build more efficiently in Marketo long-term
  • Maintain the health and hygiene of your instance moving forward
  • Make the transition process much smoother for a new Marketo admin if your team experiences any turnover


There are a couple different types of documentation you can produce. A governance guide outlines your instance setup in detail with topics such as program/folder structures, communication limits, and more. This would be a living document that users would turn to in order to identify your specific best practices and governing standards for your Marketo instance, and would mainly be for your Marketo admin or main user. In addition to a governance guide, your team may need supplemental enablement documents or training materials to help them get up to speed with Marketo. These could include exercises to practice working with the platform, quizzes to pass before being granted access, or a list of what your users are allowed to do in Marketo. These would be aimed at all Marketo users in your organization.
Whether you’re putting together a full blown governance guide or are simply documenting the key aspects of your setup to start, writing down the decisions you make during onboarding will help you and your team be successful with Marketo.

Getting Started on Your Documentation

Having trouble getting started on your guide? Tori suggests first focusing on the most important aspect of your Marketo documentation: your Admin Setup. “Make sure you’re writing down all of your behind-the-scenes decisions so if anyone needs to take over your Marketo instance, they’ll be able to understand how and why your instance was set up the way it is.” It’s crucial, Tori points out, that you “don’t just document what was built, but why it was built that way.” This helps a future admin (or even future you) avoid repeating decisions that didn’t work out or wasting time going down dead ends.

 

Another recommendation from Tori to establish the success of your documentation is to “ensure every rule you make has an owner to enforce it down the line. Lack of enforcement makes writing those rules moot.” Check in with your team and put a process in place to make sure this documentation will continue to adapt and stay relevant, as well as stay top of mind for your users.

Tips and Tricks

Whether you’re documenting a new/existing instance or creating training resources for your organization’s Marketo users, consider these tips from one of our resident Marketo experts, Kylie Peters:

  • Over-document, over-communicate, over-test! If it feels like you’re doing enough, you might not be doing enough.” You never know what might be useful to you or your team in the future, so be sure to add in details and keep other teams in the loop!
  • Be ‘new-hire-minded’. Write the documentation for someone who’s never used this technology before.” Once you become familiar with Marketo it can be easy to take a lot of background knowledge for granted. Make sure you’re creating your enablement and governance documentation with the most basic user in mind. Consider including some definitions and best practices directly into your training documentation if they’ll help new users get up to speed.
  • People have different ways of processing and understanding information so it helps to use a combination of written points, pictures, videos, and hands-on exercises in your trainings.” Instead of just writing a block of text to send out to your team, include some interactive content or a couple different formats within your enablement documentation and training.
  • Run the documentation by someone who’s never seen Marketo before and ask them if they have any questions.” Not sure if your governance and enablement documentation is clear? Ask someone who’s never used Marketo to take a look and see if they can follow your trainings. This will give you a good fresh perspective on what you’ve put together and how you can improve it.
  • “It’s important to remember that training documents are very different based on your needs and your instance.” Unlike governance guides, which should be as comprehensive as possible, enablement documents should be produced based on your organization’s need. Keep in mind that what might be important to document in detail for one instance or one user could be less relevant for others. You should know your instance and users best, so create your training documentation accordingly.



Marketo Documentation Sample Topics

Use these topics to guide your initial Marketo governance documentation plan. It may help to take it slow and start with a few topics that are important to your particular instance, then expand from there.

 

  • What is Marketo and what are its purposes for our organization
  • Purpose of this Documentation
  • Process to Maintain/Make Changes to Governance Guide
  • Administrative Set Up
    • Instance(s)
    • Workspaces and Partitions
    • User Roles and Responsibilities
    • Smart Campaign/Email/Program Settings
    • Communication Limits
    • Security
    • Channels
    • Tags
  • Data Structure
    • Field Structure
  • Operational Programs
  • Building In Marketo Instance
    • Center of Excellence (COE)
    • Folder Structure
    • Naming Conventions
    • Program Organization
    • Templates
    • Standardized Processes
    • Checklists
    • Segmentations
    • Archiving
    • Subscription Center
  • CRM Integration
    • How does the sync work
    • Campaign Sync
    • Data Dictionary
  • Other Integrations
  • GDPR & Compliance

 

Check out an example of Channel Documentation here (or attached to this post).

 

Start documenting your instance today! Be sure to involve your whole team - whether that’s just you or a team of 10 - and revisit these docs every month to keep it up to date as your use of your Marketo instance grows.

 

To regularly receive content to help you through your Marketo onboarding and implementation, sign up for the Marketo Jumpstart series.

24485
23
23 Comments
Scott_MacGrego2
Level 1

So good. As a consultant and now in a services agency this practice would be critical to transitioning new teams and getting consultants or agencies up to speed quickly.

Beth_Massura
Level 8 - Champion Alumni

This is a great outline for instance documentation! We are also talking more about governance, but not just within the Marketo admin team. We're drafting an email marketing governance charter to align all departments using Marketo (or other systems) around shared objectives for our institution (i.e. to help the school get the greatest return on its email communications). We want to make sure everyone is on the same page as to how to we will collectively do that, not just rely on the central marketing team to "police" system usage/processes.

Meghana_Rao1
Marketo Employee

That's a wonderful idea, Beth Massura​! Having that charter align across shared objectives will help spread accountability, so it's not just on your Marketo team to enforce the rules you set up. Has your organization started that process already? I'd love to hear any advice from you on bringing those learnings out to your teams and/or keep those processes updated as your organization's objectives shift.

Scott_MacGrego2
Level 1

Hi Beth - I have a client also interested in (has a clear need for). If you can share any good examples or links to best practices around drafting an email governance charter or policy that would be awesome.

Beth_Massura
Level 8 - Champion Alumni

We are just starting out but I will share more as we make progress!

Beth_Massura
Level 8 - Champion Alumni

I haven't come across any so far, but we will be looking at some other governance charters at our organizations (for example, data governance) to help us with the structure of the document.

Miray_Vu1
Level 2

It was a great article Meghana Rao​ . Thank you !

Abhishek_Chand2
Level 5

This is really helpful, can be considered as a best practice document.

jtoohey
Level 1

JGalloway
Level 1

@Meghana_Rao1  just wondering if you could post a link to the documentation sample - I tried click through and it keeps