The User Lists add-on allows you to create All users in list automations lets you apply actions on all users in a list or on a filtered group of users.
Unlike other kind of automations based on your users interactions, all users automations are designed to run manually or automatically on a specific date or on a recurring basis.
This automations are ideal to process several actions over a group of users to perform operations like:
Creating an all users in list automation
Access to your WordPress admin area and navigate to AutomatorWP -> Automations menu. At the top of this view you can find a button to Add new automation.
A dialog will appear to let you choose the automation type you want to create, choose All users in list and click on Confirm.
You will notice that the automation is already started with a predefined trigger and the box Execution Options, that is exclusive for all users automations, will appear.
Filtering users
Inside the “Run automation on all users from any list” triggers you will find several conditions to filter users by the fields or metas of your choice:
You will also be able to select the specific list from which you want to use the users.
You can configure all the conditions of your choice to process the automation exactly on the users you want:
Additionally, you can use the filters to decide on which users the automation should run on:
Of course, as other automations, you are also able to define filters on the actions area to conditionally run the actions under the users of your choice:
Execution options
The Execution Options box lets you manage several options about the execution of this automation. The box is placed at right side of the screen and looks like this:
Users per loop option lets you define how many users to process in each loop of a run.
For example, if you have 1,000 users and you set the users per loop to 200, each run of this automation will have 5 loops (200×5=1,000). Keep in mind that all actions will be processed on every user, so depending of your server capabilities you may need to adjust this setting to what your server is able to handle.
A tip here could be to run the automation manually to see how much time requires each loop, if you see that a loops requires more than 10 seconds, is recommended to reduce the users per loop for that automation.
Schedule execution lets you schedule the execution of this automation on a specific date. Check this section for more details.
Recurring execution lets you schedule the execution of this automation recursively. Check this section for more details
Run automations manually
Inside the Execution Options box you will find a button named Run automation. Clicking this button you will start the automation manually and you will be able to see the information about the execution status:
Important: Wait on this screen until the automation execution ends. You can open other browser tabs to continue working in other tasks while the automation is running.
Schedule for a specific date
Inside the Execution Options box you have the setting Schedule execution. Checking this option will appear a new set of fields to let you schedule the execution of this automation in a specific date:
Note that is important to configure a future date to schedule correctly this automation.
Recurring schedule
Inside the Execution Options box you have the setting Recurring execution. Checking this option will appear a new set of fields to let you schedule the execution of this automation in a recurring basis:
You are able to configure a period of your choice for this schedule (every day, week, month and year), even more you are able to define the day (in some periods) and the time of the execution:
- Every day: The automation will run every day at time configured.
- Every week: The automation will run the day of the week (Monday, Tuesday, etc) at time configured.
- Every month: The automation will run the day of the month at time configured. Note that if day configuration exceeds the day of the month (eg: You configure 31 and the month has 30 days or 28 days like February) AutomatorWP will execute the automation the last day of that month.
- Every year: The automation will run the day of the year at time configured. If you configure the day at 365 and the year is leap, AutomatorWP will execute the automation the last day of that year.
Completion times
Through the Total times field located in the Save Changes box, you are able to limit the number of completion times allowed for this automation, specially when the automation is configured with a recurring schedule.
For example, if you configure the automation to run the 15th of every month and set a total times of 5, the automation will run only the first 5 months until its activation.
Tags
In all users automations you will find 2 groups of tags:
- User tags that will change dynamically for every user who is getting processed.
- Number of times tag that is the run number of the automation. For example the first time the automation gets executed, this tag value will be 1, the next execution the tag value will be 2, etc.