Create a How-to Video Action using templates

Action templates let you create Actions without writing a single line of code. A how-to is a guide that provides sequential steps for completing a specific task, and this template lets you add your how-to video guides and their steps to a Google Sheet. Then, after completing these quick steps, you'll have a fully working Action that you can test and submit for approval.

When users invoke your Action, they can select one of your how-to guide videos. Users can watch your videos with the steps written out, and even tap specific steps to be taken to that part of the video.

For information about available locales for the How-to template, see the Supported languages and locales section.


Before you start building a How-to video template Action, you'll need to review your content. The following guidelines apply to how-to videos for a template Action:

  • Your how-to guides must be available as videos on YouTube.

  • Your how-to guide videos must be public.

  • You must own all of the guide videos that you include in a How-to Video template Action, in accordance with our policies. You'll need to do the following for us to verify you own your how-to videos:

    • If your YouTube acount is branded, you must go through brand verification to connect the website associated with your YouTube account. Follow steps 1 and 7 under Build your Action below to verify you own your branded videos.

    • If your YouTube account is personal/non-branded, you must build your Action using the same Google account that you used for your YouTube account. Log in using your YouTube profile's Google account during step 2 under Build your Action below to verify you own your non-branded videos.

  • Video URLs from the sample How-to videos cannot be used in your own How-to action.

  • How-to Action cannot be part of the Actions for Families program. Please make sure to opt-out of the Actions for Families program in the Actions console when you deploy your Action (Deploy > Directory information > Additional information).

Build your Action

To build your Action using a How-to Video template, do the following:

  1. If your YouTube account is branded: Associate your website with your YouTube account to verify your video ownership by following step 2 in this support article.
  2. Go to the Actions console.
  3. Click New project.
  4. Enter a name for your project and click Create Project.
  5. Under More options near the bottom of the page, click Templates.
  6. Click on the How-to Videos section.
  7. If your YouTube account is branded: Click Deploy > Brand verification and connect the website that's linked to your YouTube account. Learn more about connecting a website in the brand verification documentation.
  8. In the Fill in your content section, click GET STARTED.
  9. In the prompt, click How-to Video Template, which opens a new tab.
  10. Click Make a copy.
  11. Update the How To Content tab of your sheet with details of each how-to guide. Note that you can add more rows if you want to include more than one video in your Action. Fill out the following information:
    • How To Guide Title - The title of your how-to videos. These should be short (90 characters or less) and descriptive.
    • Summary - A short (135 characters or less) description of what the user will learn from each how-to guide.
    • Video URL - The full URL of the video for each how-to guide.
    • Alternative Search Queries (Optional) - Other phrases the user might use to describe each how-to guide, separated by | characters. For example, a guide on "how to build a house" may also be described as "how to construct a house" or "how to build a home", so its alternative search queries could be construct a house | how to build a home. These alternative queries are optional, but can help users discover your Action when they don't search for your exact guide title.
  12. Update the How To Steps tab of your sheet with the individual steps of each how-to guide. Each how-to guide should consist of multiple steps. Each row in the sheet corresponds to one step from one guide. Fill out the following information:
    • How To Guide Title - The how-to guide that each step corresponds to. This field is a drop-down selector with each guide title that you added in the How To Content tab.
    • Step Number - Each step's number in the sequence of steps for each guide. For example, step one's step number should be 1. Multiple steps in this sheet can have the same step number, so the step number for step one in another guide should also be 1.
    • Step Title - A short (90 characters or less) summary of this step.
    • Step Timestamp - The timestamp (in "MM:SS" format) of this step in the how-to guide video. For example, if step two is described 49 seconds into the video, the field for this step should be 00:49.
    • Bullet points - Additional details of this step, broken into up to three short (135 characters or less) summaries separated by | characters. At a minimum, each step should have one bullet point describing the step in more detail that its title, but you can add more bullet points as needed.
      For example, if the step "take your furniture out of the packaging" could be described as "remove your chair parts from the box, and set the screws aside for later", then that step's bullet points could be Remove your chair parts from the box | Make sure to set the screws aside for later.
  13. When you finish filling out the sheet, go back to the Actions Console and click NEXT.
  14. Copy and paste your Google Sheet's URL into the text field and click UPLOAD.

Edit the content of your Action

If you want to change your Action's content, first make the changes you need to your Google Sheet. Then, navigate to Build > Actions and re-upload your updated sheet.

Test your Action

Click on Test in the top menu to test your Action via a web interface.

To invoke your Action, say or type Talk to my test app in the simulator. You can also test your Action via Google Assistant on your phone or voice-activated speaker if your device and Actions project are using the same Google account.

If your Action is set up for multiple languages, you can test each language by toggling the Language dropdown menu in the simulator.

Submit your Action

When the Actions section is complete and you have tested your Action, you may submit your Action to Google for review. If your Action is approved, it will be available to Assistant users.

To submit your Action, do the following:

  1. Go to the Overview page for your project in the Actions Console.
  2. Under Quick setup, click Decide how your Action is invoked.

    Set the following options and click Save.

    1. Display name: Enter your Action's name for the directory. This name is presented to users in the Assistant Directory.
    2. Google Assistant voice: Pick which voice you would like your Action to use. You can hear audio samples of each voice on the Languages and Locales page.
  3. Navigate to Deploy > Directory information and enter information for the following sections:
    1. Description: Add your Action's short description and a full description that clearly explains what the Action is used for and what it does.
    2. Sample invocations: Add additional sample invocations users might say to talk to your Action.
    3. Images: Add two images, one for the banner and one for the logo.
    4. Contact details: Add an email contact. Our review team uses this email address to give feedback on your Action. Users can also see this email address to contact you.
    5. Privacy and Consent: Add the URL to your Action's privacy policy. The privacy policy explains how you handle user data and appears publicly.
    6. Additional information:
      • Category: Select the most appropriate category for your Action to live under in the Assistant Directory.
      • For Families: How-to Actions aren't eligible for the Actions for Families program, so this is set to No.
      • Alcohol and Tobacco: If your Action references alcohol or tobacco at all, select Yes.
      • Testing Instructions (optional): Add any specific testing instructions if required. These are only visible to our review team. Generally, for Actions that you build with the trivia template, you can leave this blank.
      • Transaction: Template Actions don't perform Transactions, so you can leave this blank.
      • Mic Policy: Template Actions don't leave the mic open without prompting, so you can leave this blank.
  4. Navigate to Deploy > Release.
  5. If there are any error messages on the top, you should follow the instructions provided to address the issue. Otherwise, click Submit for production.


If your Action isn't working and you're running into one of the issues below, try the following troubleshooting steps:
  • It looks like something went wrong in the upload process
    If you see this error message when you try to upload your sheet, go back to your sheet's contents and make sure you didn't change any content other than row 4 and below. If you're stuck, try making another copy of the How-to Video template and copy-paste in your content from the older sheet, then upload the new sheet.
  • Failed to get conversion
    If you see this error, refresh the web page and try again.
  • Request Access Error
    You might see a screen requesting access permission when you try to access the pre-filled template content sheet. If this occurs:
    1. Log out of all Google accounts and close all browsers.
    2. Reopen your browser and log back in with the account that you're using for your Actions Console project.
    3. If the error message persists, try using Incognito mode in Chrome.
  • Simulator Not Responding
    If the simulator doesn't show the Test or Authorize button, refresh the web page and try again.

Supported languages and locales

The How-to template is available in the following languages and locales:

  • en-*