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.

Prerequisites

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).

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.

Troubleshooting

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-*